canonicalize_file_name (3) - Linux Man Pages
canonicalize_file_name: return the canonicalized absolute pathname
canonicalize_file_name - return the canonicalized absolute pathname
SYNOPSIS#define _GNU_SOURCE /* See feature_test_macros(7) */
DESCRIPTIONThe canonicalize_file_name() 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 canonicalize_file_name() and the caller should deallocate it with free(3) when it is no longer required.
The call canonicalize_file_name(path) is equivalent to the call:
returns a null-terminated string.
On error (e.g., a pathname component is unreadable or does not exist),
returns NULL and sets
to indicate the error.
For an explanation of the terms used in this section, see
Interface Attribute Value
Thread safety MT-Safe
This function is a GNU extension.
This page is part of release 5.05 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at