|| Linux Programmer's Manual
NAME canonicalize_file_name - return the canonicalized absolute pathname
/* See feature_test_macros(7) */
char *canonicalize_file_name(const char *
() function returns a null-terminated string containing the canonicalized absolute pathname corresponding to
. In the returned string, symbolic links are resolved, as are
pathname components. Consecutive slash (
) characters are replaced by a single slash.
The returned string is dynamically allocated by
() and the caller should deallocate it with
(3) when it is no longer required.
is equivalent to the call:
RETURN VALUE On success,
canonicalize_file_name() returns a null-terminated string. On error (e.g., a pathname component is unreadable or does not exist),
canonicalize_file_name() returns NULL and sets
errno to indicate the error.
CONFORMING TO This function is a GNU extension.
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/.