CANONICALIZE_FILE_NAME(3)

ИМЯ
canonicalize_file_name - возвращает канонизированный абсолютный путь

ОБЗОР
#define _GNU_SOURCE /* смотрите feature_test_macros(7) */
#include <stdlib.h>

char *canonicalize_file_name(const char *path);

ОПИСАНИЕ
Функция canonicalize_file_name() возвращает строку, завершающуюся null, содержащую канонизированный абсолютный путь соответствующего path. В возвращаемой строке раскрываются символьные ссылки, а также компоненты пути . и ... Стоящие подряд символы косой черты (/) заменяются одной чертой.

Место под возвращаемую строку выделяется canonicalize_file_name() динамически и вызывающий должен освободить его с помощью free(3), когда оно станет ненужным.

Вызов canonicalize_file_name(path) эквивалентен вызову:

    realpath(path, NULL);

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При нормальном завершении работы canonicalize_file_name() возвращает строку с null в конце. При ошибке (например, компонент пути невозможно прочитать или он не существует), canonicalize_file_name() возвращает NULL и устанавливает в errno соответствующее значение ошибки.

ОШИБКИ
Смотрите realpath(3).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
canonicalize_file_name() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
Эта функция является расширением GNU.

СМОТРИТЕ ТАКЖЕ
readlink(2), realpath(3)