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