summaryrefslogtreecommitdiff
path: root/src/lib/libc/stdlib/realpath.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libc/stdlib/realpath.3')
-rw-r--r--src/lib/libc/stdlib/realpath.320
1 files changed, 9 insertions, 11 deletions
diff --git a/src/lib/libc/stdlib/realpath.3 b/src/lib/libc/stdlib/realpath.3
index 9d8b1ff2ce..56fbea9ede 100644
--- a/src/lib/libc/stdlib/realpath.3
+++ b/src/lib/libc/stdlib/realpath.3
@@ -32,10 +32,9 @@
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE. 33.\" SUCH DAMAGE.
34.\" 34.\"
35.\" from: @(#)realpath.3 8.2 (Berkeley) 2/16/94 35.\" $OpenBSD: realpath.3,v 1.8 2001/04/23 15:30:25 aaron Exp $
36.\" $Id: realpath.3,v 1.1.1.1 1995/10/18 08:42:19 deraadt Exp $
37.\" 36.\"
38.Dd "February 16, 1994" 37.Dd February 16, 1994
39.Dt REALPATH 3 38.Dt REALPATH 3
40.Os 39.Os
41.Sh NAME 40.Sh NAME
@@ -57,8 +56,7 @@ and
57.Pa /../ 56.Pa /../
58in 57in
59.Fa pathname , 58.Fa pathname ,
60and copies the resulting absolute pathname into 59and copies the resulting absolute pathname into the memory referenced by
61the memory referenced by
62.Fa resolvedname . 60.Fa resolvedname .
63The 61The
64.Fa resolvedname 62.Fa resolvedname
@@ -68,7 +66,7 @@ refer to a buffer capable of storing at least
68.Dv MAXPATHLEN 66.Dv MAXPATHLEN
69characters. 67characters.
70.Pp 68.Pp
71The 69The
72.Fn realpath 70.Fn realpath
73function will resolve both absolute and relative paths 71function will resolve both absolute and relative paths
74and return the absolute pathname corresponding to 72and return the absolute pathname corresponding to
@@ -82,14 +80,14 @@ is called.
82The 80The
83.Fn realpath 81.Fn realpath
84function returns 82function returns
85.Fa resolved_name 83.Fa resolvedname
86on success. 84on success.
87If an error occurs, 85If an error occurs,
88.Fn realpath 86.Fn realpath
89returns 87returns
90.Dv NULL , 88.Dv NULL ,
91and 89and
92.Fa resolved_name 90.Fa resolvedname
93contains the pathname which caused the problem. 91contains the pathname which caused the problem.
94.Sh ERRORS 92.Sh ERRORS
95The function 93The function
@@ -102,7 +100,7 @@ for any of the errors specified for the library functions
102.Xr fchdir 2 , 100.Xr fchdir 2 ,
103.Xr lstat 2 , 101.Xr lstat 2 ,
104.Xr open 2 , 102.Xr open 2 ,
105.Xr readlink 2 103.Xr readlink 2 ,
106and 104and
107.Xr getcwd 3 . 105.Xr getcwd 3 .
108.Sh CAVEATS 106.Sh CAVEATS
@@ -114,10 +112,10 @@ The
114version always returns absolute pathnames, 112version always returns absolute pathnames,
115whereas the Solaris implementation will, 113whereas the Solaris implementation will,
116under certain circumstances, return a relative 114under certain circumstances, return a relative
117.Fa resolved_path 115.Fa resolvedname
118when given a relative 116when given a relative
119.Fa pathname . 117.Fa pathname .
120.Sh "SEE ALSO" 118.Sh SEE ALSO
121.Xr getcwd 3 119.Xr getcwd 3
122.Sh HISTORY 120.Sh HISTORY
123The 121The