Man page - canonicalize_file_name(3)

Packages contains this manual

Available languages:

en fr pl ja ru ro de

Manual

canonicalize_file_name

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).

Image grohtml-177215-1.png

STANDARDS

GNU.

SEE ALSO

readlink (2), realpath (3)