canonicalize_file_name - return the canonicalized absolute pathname

NAME  LIBRARY  SYNOPSIS  DESCRIPTION  RETURN VALUE  ERRORS  ATTRIBUTES  STANDARDS  SEE ALSO 

---

NAME

canonicalize_file_name − return the canonicalized absolute pathname

LIBRARY

Standard C library (libc, −lc)

SYNOPSIS

#define _GNU_SOURCE /* See feature_test_macros(7) */
#include <stdlib.h>

char *canonicalize_file_name(const char *path);

DESCRIPTION

The 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:

realpath(path, NULL);

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.

ERRORS

See realpath(3).

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

STANDARDS

GNU.

SEE ALSO

readlink(2), realpath(3)

---