canonicalize_file_name - return the canonicalized absolute pathname
/* See feature_test_macros(7) */
char *canonicalize_file_name(const char *path);
() function returns a null-terminated string
containing the canonicalized absolute pathname corresponding to path
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 canonicalize_file_name
and the caller should deallocate it with free
(3) when it is no longer
The call canonicalize_file_name(path)
is equivalent to the call:
On success, canonicalize_file_name
() returns a null-terminated string. On
error (e.g., a pathname component is unreadable or does not exist),
() returns NULL and sets errno
For an explanation of the terms used in this section, see attributes
This function is a GNU extension.