Loading...
stdlib/realpath.3 Libc-498.1.7 Libc-262.3.2
--- Libc/Libc-498.1.7/stdlib/realpath.3
+++ Libc/Libc-262.3.2/stdlib/realpath.3
@@ -33,7 +33,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)realpath.3	8.2 (Berkeley) 2/16/94
-.\" $FreeBSD: src/lib/libc/stdlib/realpath.3,v 1.13 2003/03/27 20:48:53 fjoe Exp $
+.\" $FreeBSD: src/lib/libc/stdlib/realpath.3,v 1.10 2001/09/07 14:46:36 asmodai Exp $
 .\"
 .Dd February 16, 1994
 .Dt REALPATH 3
@@ -44,41 +44,39 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
+.In sys/param.h
 .In stdlib.h
 .Ft "char *"
-.Fo realpath
-.Fa "const char *restrict file_name"
-.Fa "char *restrict resolved_name"
-.Fc
+.Fn realpath "const char *pathname" "char resolved_path[MAXPATHLEN]"
 .Sh DESCRIPTION
 The
 .Fn realpath
 function resolves all symbolic links, extra
 .Dq /
-characters, and references to
+characters and references to
 .Pa /./
 and
 .Pa /../
 in
-.Fa file_name ,
+.Fa pathname ,
 and copies the resulting absolute pathname into
 the memory referenced by
-.Fa resolved_name .
+.Fa resolved_path .
 The
-.Fa resolved_name
+.Fa resolved_path
 argument
 .Em must
 refer to a buffer capable of storing at least
-.Dv PATH_MAX
+.Dv MAXPATHLEN
 characters.
 .Pp
 The
 .Fn realpath
 function will resolve both absolute and relative paths
 and return the absolute pathname corresponding to
-.Fa file_name .
-All components of
-.Fa file_name
+.Fa pathname .
+All but the last component of
+.Fa pathname
 must exist when
 .Fn realpath
 is called.
@@ -86,14 +84,14 @@
 The
 .Fn realpath
 function returns
-.Fa resolved_name
+.Fa resolved_path
 on success.
 If an error occurs,
 .Fn realpath
 returns
-.Dv NULL
+.Dv NULL ,
 and
-.Fa resolved_name
+.Fa resolved_path
 contains the pathname which caused the problem.
 .Sh ERRORS
 The function
@@ -101,8 +99,12 @@
 may fail and set the external variable
 .Va errno
 for any of the errors specified for the library functions
+.Xr chdir 2 ,
+.Xr close 2 ,
+.Xr fchdir 2 ,
 .Xr lstat 2 ,
-.Xr readlink 2 ,
+.Xr open 2 ,
+.Xr readlink 2
 and
 .Xr getcwd 3 .
 .Sh CAVEATS
@@ -114,28 +116,13 @@
 version always returns absolute pathnames,
 whereas the Solaris implementation will,
 under certain circumstances, return a relative
-.Fa resolved_name
+.Fa resolved_path
 when given a relative
-.Fa file_name .
-.Sh LEGACY SYNOPSIS
-.Fd #include <sys/param.h>
-.Fd #include <stdlib.h>
-.Pp
-The include file
-.In sys/param.h
-is necessary.
-.Sh LEGACY DESCRIPTION
-In legacy mode,
-the last component of
-.Fa file_name
-does not need to exist when
-.Fn realpath
-is called.
+.Fa pathname .
 .Sh "SEE ALSO"
-.Xr getcwd 3 ,
-.Xr compat 5
+.Xr getcwd 3
 .Sh HISTORY
 The
 .Fn realpath
-function first appeared in
+function call first appeared in
 .Bx 4.4 .