Loading...
stdlib/realpath.3 Libc-262 Libc-498
--- Libc/Libc-262/stdlib/realpath.3
+++ Libc/Libc-498/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.10 2001/09/07 14:46:36 asmodai Exp $
+.\" $FreeBSD: src/lib/libc/stdlib/realpath.3,v 1.13 2003/03/27 20:48:53 fjoe Exp $
 .\"
 .Dd February 16, 1994
 .Dt REALPATH 3
@@ -44,39 +44,41 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/param.h
 .In stdlib.h
 .Ft "char *"
-.Fn realpath "const char *pathname" "char resolved_path[MAXPATHLEN]"
+.Fo realpath
+.Fa "const char *restrict file_name"
+.Fa "char *restrict resolved_name"
+.Fc
 .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 pathname ,
+.Fa file_name ,
 and copies the resulting absolute pathname into
 the memory referenced by
-.Fa resolved_path .
+.Fa resolved_name .
 The
-.Fa resolved_path
+.Fa resolved_name
 argument
 .Em must
 refer to a buffer capable of storing at least
-.Dv MAXPATHLEN
+.Dv PATH_MAX
 characters.
 .Pp
 The
 .Fn realpath
 function will resolve both absolute and relative paths
 and return the absolute pathname corresponding to
-.Fa pathname .
-All but the last component of
-.Fa pathname
+.Fa file_name .
+All components of
+.Fa file_name
 must exist when
 .Fn realpath
 is called.
@@ -84,14 +86,14 @@
 The
 .Fn realpath
 function returns
-.Fa resolved_path
+.Fa resolved_name
 on success.
 If an error occurs,
 .Fn realpath
 returns
-.Dv NULL ,
+.Dv NULL
 and
-.Fa resolved_path
+.Fa resolved_name
 contains the pathname which caused the problem.
 .Sh ERRORS
 The function
@@ -99,12 +101,8 @@
 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 open 2 ,
-.Xr readlink 2
+.Xr readlink 2 ,
 and
 .Xr getcwd 3 .
 .Sh CAVEATS
@@ -116,13 +114,28 @@
 version always returns absolute pathnames,
 whereas the Solaris implementation will,
 under certain circumstances, return a relative
-.Fa resolved_path
+.Fa resolved_name
 when given a relative
-.Fa pathname .
+.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.
 .Sh "SEE ALSO"
-.Xr getcwd 3
+.Xr getcwd 3 ,
+.Xr compat 5
 .Sh HISTORY
 The
 .Fn realpath
-function call first appeared in
+function first appeared in
 .Bx 4.4 .