ИМЯ¶

symlink, symlinkat - создаёт новое имя для файла

СИНТАКСИС¶

#include <unistd.h>

int symlink(const char *target, const char *linkpath);
#include <fcntl.h>           /* определения констант of AT_* */
#include <unistd.h>

int symlinkat(const char *target, int newdirfd, const char *linkpath);

symlink():

symlinkat():

ОПИСАНИЕ¶

Вызов symlink() создаёт символьную ссылку с именем linkpath, которая содержит строку target.

Символьные ссылки интерпретируются «на лету», как будто бы содержимое ссылки было подставлено вместо пути, по которому идёт поиск файла или каталога.

Символьные ссылки могут содержать компоненты пути .., которые (если используются в начале ссылки) ссылаются на родительский каталог того каталога, в котором находится ссылка.

Символьная ссылка (также известная как «мягкая ссылка») может указывать как на существующий, так и на несуществующий файлы; в последнем случае такая ссылка называется повисшей (dangling).

Права доступа символьной ссылки не имеют значения; принадлежность определённому владельцу игнорируется при переходе по ссылке, но проверяется при удалении или переименовании ссылки, а также ссылки в каталог с установленным закрепляющим (sticky) битом (S_ISVTX).

Если linkpath существует, то он не будет перезаписан.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ¶

EACCES

Нет прав на запись в каталог, содержащийся в linkpath, или в одном из каталогов в linkpath не разрешён поиск (смотрите также path_resolution(7)).

EDQUOT

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

EEXIST

linkpath уже существует.

EFAULT

Значение target или linkpath указывают за пределы доступного адресного пространства.

EIO

Произошла ошибка ввода-вывода.

ELOOP

Во время определения linkpath встретилось слишком много символьных ссылок.

ENAMETOOLONG

Слишком длинное значение аргумента target или linkpath.

ENOENT

Компонент пути linkpath не существует или является повисшей символьной ссылкой или значение target или linkpath равно пустой строке.

ENOMEM

Недостаточное количество памяти ядра.

ENOSPC

На устройстве, содержащем файл, нет места для создания нового элемента каталога.

ENOTDIR

Компонент пути, использованный как каталог в linkpath, в действительности таковым не является.

EPERM

Файловая система, содержащая linkpath, не поддерживает создание символьных ссылок.

EROFS

linkpath расположен в файловой системе, доступной только для чтения.

В symlinkat() дополнительно могут возникнуть следующие ошибки:

EBADF

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

ENOENT

Значение linkpath является относительным путём и newdirfd ссылается на каталог, который был удалён.

ENOTDIR

Значение linkpath содержит относительный путь и newdirfd содержит файловый дескриптор, указывающий на файл, а не на каталог.

ВЕРСИИ¶

Системный вызов symlinkat() был добавлен в ядро Linux версии 2.6.16; поддержка в glibc доступна с версии 2.4.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

symlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.

symlinkat(): POSIX.1-2008.

ЗАМЕЧАНИЯ¶

Не выполняется проверка target.

При удаление имени, на который ссылается символьная ссылка, произойдёт удаление файла (если только у него нет других жёстких ссылок). Если такое поведение нежелательно, используйте link(2).

СМ. ТАКЖЕ¶

ln(1), namei(1), lchown(2), link(2), lstat(2), open(2), readlink(2), rename(2), unlink(2), path_resolution(7), symlink(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.