diff options
Diffstat (limited to 'src/lib/libc/stdlib/realpath.3')
-rw-r--r-- | src/lib/libc/stdlib/realpath.3 | 40 |
1 files changed, 17 insertions, 23 deletions
diff --git a/src/lib/libc/stdlib/realpath.3 b/src/lib/libc/stdlib/realpath.3 index 9d8b1ff2ce..b8093b51e1 100644 --- a/src/lib/libc/stdlib/realpath.3 +++ b/src/lib/libc/stdlib/realpath.3 | |||
@@ -12,11 +12,7 @@ | |||
12 | .\" 2. Redistributions in binary form must reproduce the above copyright | 12 | .\" 2. Redistributions in binary form must reproduce the above copyright |
13 | .\" notice, this list of conditions and the following disclaimer in the | 13 | .\" notice, this list of conditions and the following disclaimer in the |
14 | .\" documentation and/or other materials provided with the distribution. | 14 | .\" documentation and/or other materials provided with the distribution. |
15 | .\" 3. All advertising materials mentioning features or use of this software | 15 | .\" 3. Neither the name of the University nor the names of its contributors |
16 | .\" must display the following acknowledgement: | ||
17 | .\" This product includes software developed by the University of | ||
18 | .\" California, Berkeley and its contributors. | ||
19 | .\" 4. Neither the name of the University nor the names of its contributors | ||
20 | .\" may be used to endorse or promote products derived from this software | 16 | .\" may be used to endorse or promote products derived from this software |
21 | .\" without specific prior written permission. | 17 | .\" without specific prior written permission. |
22 | .\" | 18 | .\" |
@@ -32,10 +28,9 @@ | |||
32 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 28 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
33 | .\" SUCH DAMAGE. | 29 | .\" SUCH DAMAGE. |
34 | .\" | 30 | .\" |
35 | .\" from: @(#)realpath.3 8.2 (Berkeley) 2/16/94 | 31 | .\" $OpenBSD: realpath.3,v 1.10 2003/06/02 20:18:38 millert Exp $ |
36 | .\" $Id: realpath.3,v 1.1.1.1 1995/10/18 08:42:19 deraadt Exp $ | ||
37 | .\" | 32 | .\" |
38 | .Dd "February 16, 1994" | 33 | .Dd February 16, 1994 |
39 | .Dt REALPATH 3 | 34 | .Dt REALPATH 3 |
40 | .Os | 35 | .Os |
41 | .Sh NAME | 36 | .Sh NAME |
@@ -57,8 +52,7 @@ and | |||
57 | .Pa /../ | 52 | .Pa /../ |
58 | in | 53 | in |
59 | .Fa pathname , | 54 | .Fa pathname , |
60 | and copies the resulting absolute pathname into | 55 | and copies the resulting absolute pathname into the memory referenced by |
61 | the memory referenced by | ||
62 | .Fa resolvedname . | 56 | .Fa resolvedname . |
63 | The | 57 | The |
64 | .Fa resolvedname | 58 | .Fa resolvedname |
@@ -68,7 +62,7 @@ refer to a buffer capable of storing at least | |||
68 | .Dv MAXPATHLEN | 62 | .Dv MAXPATHLEN |
69 | characters. | 63 | characters. |
70 | .Pp | 64 | .Pp |
71 | The | 65 | The |
72 | .Fn realpath | 66 | .Fn realpath |
73 | function will resolve both absolute and relative paths | 67 | function will resolve both absolute and relative paths |
74 | and return the absolute pathname corresponding to | 68 | and return the absolute pathname corresponding to |
@@ -78,18 +72,18 @@ All but the last component of | |||
78 | must exist when | 72 | must exist when |
79 | .Fn realpath | 73 | .Fn realpath |
80 | is called. | 74 | is called. |
81 | .Sh "RETURN VALUES" | 75 | .Sh RETURN VALUES |
82 | The | 76 | The |
83 | .Fn realpath | 77 | .Fn realpath |
84 | function returns | 78 | function returns |
85 | .Fa resolved_name | 79 | .Fa resolvedname |
86 | on success. | 80 | on success. |
87 | If an error occurs, | 81 | If an error occurs, |
88 | .Fn realpath | 82 | .Fn realpath |
89 | returns | 83 | returns |
90 | .Dv NULL , | 84 | .Dv NULL , |
91 | and | 85 | and |
92 | .Fa resolved_name | 86 | .Fa resolvedname |
93 | contains the pathname which caused the problem. | 87 | contains the pathname which caused the problem. |
94 | .Sh ERRORS | 88 | .Sh ERRORS |
95 | The function | 89 | The function |
@@ -102,9 +96,16 @@ for any of the errors specified for the library functions | |||
102 | .Xr fchdir 2 , | 96 | .Xr fchdir 2 , |
103 | .Xr lstat 2 , | 97 | .Xr lstat 2 , |
104 | .Xr open 2 , | 98 | .Xr open 2 , |
105 | .Xr readlink 2 | 99 | .Xr readlink 2 , |
106 | and | 100 | and |
107 | .Xr getcwd 3 . | 101 | .Xr getcwd 3 . |
102 | .Sh SEE ALSO | ||
103 | .Xr getcwd 3 | ||
104 | .Sh HISTORY | ||
105 | The | ||
106 | .Fn realpath | ||
107 | function call first appeared in | ||
108 | .Bx 4.4 . | ||
108 | .Sh CAVEATS | 109 | .Sh CAVEATS |
109 | This implementation of | 110 | This implementation of |
110 | .Fn realpath | 111 | .Fn realpath |
@@ -114,13 +115,6 @@ The | |||
114 | version always returns absolute pathnames, | 115 | version always returns absolute pathnames, |
115 | whereas the Solaris implementation will, | 116 | whereas the Solaris implementation will, |
116 | under certain circumstances, return a relative | 117 | under certain circumstances, return a relative |
117 | .Fa resolved_path | 118 | .Fa resolvedname |
118 | when given a relative | 119 | when given a relative |
119 | .Fa pathname . | 120 | .Fa pathname . |
120 | .Sh "SEE ALSO" | ||
121 | .Xr getcwd 3 | ||
122 | .Sh HISTORY | ||
123 | The | ||
124 | .Fn realpath | ||
125 | function call first appeared in | ||
126 | .Bx 4.4 . | ||