diff options
Diffstat (limited to 'man3/realpath.3')
-rw-r--r-- | man3/realpath.3 | 41 |
1 files changed, 19 insertions, 22 deletions
diff --git a/man3/realpath.3 b/man3/realpath.3 index cafbafd11..3f25e60b9 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -6,7 +6,7 @@ .\" Rewritten old page, 990824, aeb@cwi.nl .\" 2004-12-14, mtk, added discussion of resolved_path == NULL .\" -.TH realpath 3 2023-02-05 "Linux man-pages 6.03" +.TH realpath 3 2023-07-20 "Linux man-pages 6.05.01" .SH NAME realpath \- return the canonicalized absolute pathname .SH LIBRARY @@ -69,10 +69,6 @@ The caller should deallocate this buffer using .\" Even if we use resolved_path == NULL, then realpath() will still .\" return ENAMETOOLONG if the resolved pathname would exceed PATH_MAX .\" bytes -- MTK, Dec 04 -.\" .SH HISTORY -.\" The -.\" .BR realpath () -.\" function first appeared in 4.4BSD, contributed by Jan-Simon Pendry. .SH RETURN VALUE If there is no error, .BR realpath () @@ -123,28 +119,40 @@ A component of the path prefix is not a directory. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). -.ad l -.nh .TS allbox; lbx lb lb l l l. Interface Attribute Value T{ +.na +.nh .BR realpath () T} Thread safety MT-Safe .TE -.hy -.ad .sp 1 +.SH VERSIONS +.SS GNU extensions +If the call fails with either +.B EACCES +or +.B ENOENT +and +.I resolved_path +is not NULL, then the prefix of +.I path +that is not readable or does not exist is returned in +.IR resolved_path . .SH STANDARDS -4.4BSD, POSIX.1-2001. +POSIX.1-2008. +.SH HISTORY +4.4BSD, POSIX.1-2001, Solaris. .PP POSIX.1-2001 says that the behavior if .I resolved_path is NULL is implementation-defined. POSIX.1-2008 specifies the behavior described in this page. -.SH NOTES +.PP In 4.4BSD and Solaris, the limit on the pathname length is .B MAXPATHLEN (found in \fI<sys/param.h>\fP). @@ -184,17 +192,6 @@ A typical source fragment would be .\" .BR realpath () .\" is given in \fI<unistd.h>\fP in libc4 and libc5, .\" but in \fI<stdlib.h>\fP everywhere else. -.SS GNU extensions -If the call fails with either -.B EACCES -or -.B ENOENT -and -.I resolved_path -is not NULL, then the prefix of -.I path -that is not readable or does not exist is returned in -.IR resolved_path . .SH BUGS The POSIX.1-2001 standard version of this function is broken by design, since it is impossible to determine a suitable size for the output buffer, |