src/lib/libc/stdlib/realpath.3, branch release/14.4.0

realpath: Belatedly document POSIX conformance

2025-10-20T16:11:34Z

We've been mostly POSIX-conforming since r236400 and fully since r240410, which fixed a corner case where a missing non-leaf directory would be reported as ENOTDIR instead of ENOENT. Sponsored by: Klara, Inc. Fixes: 7877ed7ce33e ("Avoid mapping ENOENT to ENOTDIR for non-existent path components.") Reviewed by: ziaee, markj Differential Revision: https://reviews.freebsd.org/D53027 (cherry picked from commit 7c66667d45e95af59f59e41ef169119a974a6be1)

Remove $FreeBSD$: one-line nroff pattern

2023-08-16T17:55:15Z

Remove /^\.\\"\s*\$FreeBSD\$$\n/

Renumber clauses to reduce diffs to other versions

2013-06-13T00:19:30Z

NetBSD, OpenBSD, and Android's Bionic number the clauses 1 through 3, so follow suit to make comparison easier.

Add restrict keyword to realpath manpage.

2013-03-18T01:22:28Z

According to SUSv4, realpath(3) must fail if

2012-05-11T11:29:08Z

[ENOENT] A component of file_name does not name an existing file or file_name points to an empty string. [ENOTDIR] A component of the path prefix is not a directory, or the file_name argument contains at least one non- character and ends with one or more trailing characters and the last pathname component names an existing file that is neither a directory nor a symbolic link to a directory. Add checks for the listed conditions, and set errno accordingly. Update the realpath(3) manpage to mention SUS behaviour. Remove the requirement to include sys/param.h before stdlib.h. PR: 128933 MFC after: 3 weeks

Comment out IEEE Std 1003.1-2001 conformance proclaimed too early,

2010-08-05T01:39:25Z

see problems described in the comment to: http://www.freebsd.org/cgi/query-pr.cgi?pr=kern/128933

mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the

2010-05-13T12:07:55Z

bottom of the manpages and order them consistently. GNU groff doesn't care about the ordering, and doesn't even mention CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put them. Found by: mdocml lint run Reviewed by: ru

C language does not has references, it provides pointers.

2010-04-21T19:35:56Z

Suggested by: bde MFC after: 2 weeks

Add standards section, improve wording, taking into account the handling

2010-04-21T16:41:02Z

of NULL and changed type in declaration. Suggested by: bde MFC after: 2 weeks

Slightly modernize realpath(3).

2010-04-20T10:16:44Z

SUSv4 requires that implementation returns EINVAL if supplied path is NULL, and ENOENT if path is empty string [1]. Bring prototype in conformance with SUSv4, adding restrict keywords. Allow the resolved path buffer pointer be NULL, in which case realpath(3) allocates storage with malloc(). PR: kern/121897 [1] MFC after: 2 weeks