NAME
canonicalizefilename - return the canonicalized absolute pathname SYNOPSIS
#define GNUSOURCE /* See featuretestmacros(7) */
#include
char *canonicalizefilename(const char *path); DESCRIPTION The canonicalizefilename() function returns a null-terminated string containing the canonicalized absolute pathname corresponding to path. In the returned string, symbolic links are resolved, as are . and .. pathname components. Consecutive slash (/) characters are replaced by a single slash. The returned string is dynamically allocated by canonical‐ izefilename() and the caller should deallocate it with free(3) when it is no longer required. The call canonicalizefilename(path) is equivalent to the call: realpath(path, NULL); RETURN VALUE
On success, canonicalizefilename() returns a null-terminated string. On error (e.g., a pathname component is unreadable or does not exist), canonicalizefilename() returns NULL and sets errno to indicate the error. ERRORS See realpath(3). ATTRIBUTES For an explanation of the terms used in this section, see attributes(7). ┌─────────────────────────┬───────────────┬─────────┐ │Interface │ Attribute │ Value │ ├─────────────────────────┼───────────────┼─────────┤
│canonicalizefilename() │ Thread safety │ MT-Safe │ └─────────────────────────┴───────────────┴─────────┘ CONFORMING TO This function is a GNU extension. SEE ALSO readlink(2), realpath(3) COLOPHON
This page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU 2013-05-11 CANONICALIZEFILENAME(3)