LINK(2)

НАЗВАНИЕ
link - создание ссылки на файл

СИНТАКСИС

        int link (path1, path2)

        char *path1, *path2;

ОПИСАНИЕ
Системный вызов link создает новую ссылку (элемент каталога) для существующего файла. Аргумент path1 указывает на маршрутное имя существующего файла, аргумент path2 - на маршрутное имя создаваемого элемента каталога.

Системный вызов link завершается неудачей и ссылка не создается, если выполнено хотя бы одно из следующих условий:

[ENOTDIR]

Компонент одного из маршрутов не является каталогом.

[ENOENT]

Компонент одного из маршрутов не существует.

[EACCES]

Для компонента одного из маршрутов отсутствует право на поиск.

[ENOENT]

Файл, заданный маршрутным именем path1, не существует.

[EEXIST]

Ссылка, заданная маршрутным именем path2, существует.

[EPERM]

Файл, заданный маршрутным именем path1, является каталогом, а действующий идентификатор пользователя не есть идентификатор суперпользователя.

[EXDEV]

Маршрутные имена path1 и path2 указывают на разные логические устройства (файловые системы).

[ENOENT]

Аргумент path2 указывает на пустое маршрутное имя.

[EACCES]

Создание ссылки требует записи в каталог, права на запись в который нет.

[EROFS]

Создание ссылки требует записи в каталог, расположенный в файловой системе, доступной только на чтение.

[EFAULT]

Аргумент path1 или path2 указывает за пределы отведенного процессу адресного пространства.

[EMLINK]

Превышается максимально допустимое количество ссылок на файл.

[EINTR]

Во время выполнения системного вызова перехвачен сигнал.

[ENOLINK]

Маршрутное имя path1 или path2 указывает на удаленный компьютер, связи с которым в данный момент нет.

[EMULTIHOP] Компоненты path1 или path2 требуют многократного обращения к удаленным компьютерам.

СМ. ТАКЖЕ
unlink(2).

ДИАГНОСТИКА
При успешном завершении результат равен 0; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки.