Loading...
--- Libc/Libc-262/stdlib/realpath.3
+++ Libc/Libc-498.1.7/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 .