πΎ Archived View for gmi.noulin.net βΊ man βΊ man3 βΊ canonicalize_file_name.3.gmi captured on 2024-08-31 at 13:45:01. Gemini links have been rewritten to link to archived content
β¬ οΈ Previous capture (2022-06-12)
-=-=-=-=-=-=-
CANONICALIZE_FILE_NAME(3) Linux Programmer's Manual CANONICALIZE_FILE_NAME(3) NAME canonicalize_file_name - return the canonicalized absolute pathname 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), canonicalβ ize_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). ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββ¬ββββββββββ βInterface β Attribute β Value β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββΌββββββββββββββββΌββββββββββ€ βcanonicalize_file_name() β Thread safety β MT-Safe β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββ΄ββββββββββ CONFORMING TO This function is a GNU extension. SEE ALSO readlink(2), realpath(3) GNU 2021-03-22 CANONICALIZE_FILE_NAME(3)