ИМЯ¶

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

LIBRARY¶

Standard C library (libc, -lc)

СИНТАКСИС¶

#include <unistd.h>

int link(const char *oldpath, const char *newpath);

#include <fcntl.h>           /* определения констант AT_* */
#include <unistd.h>

int linkat(int olddirfd, const char *oldpath,
           int newdirfd, const char *newpath, int flags);

linkat():

    Начиная с glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    До glibc 2.10:


        _ATFILE_SOURCE

ОПИСАНИЕ¶

link() создаёт новую ссылку (также называемую жёсткую ссылку) на существующий файл.

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

Это новое имя может использоваться как и старое для любых операций; оба имени ссылаются на один файл (и имеют одинаковые права и владельцев) и невозможно сказать какое имя считать "изначальным".

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

On success, zero is returned. On error, -1 is returned, and errno is set to indicate the error.

ОШИБКИ¶

EACCES

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

EDQUOT

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

EEXIST

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

EFAULT

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

EIO

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

ELOOP

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

EMLINK

На файл, на который указывает oldpath, уже создано максимальное количество ссылок. Например, для файловой системы ext4(5), в которой не используется свойство dir_index, ограничение по количеству жёстких ссылок на файл равно 65000; в btrfs(5) — 65535 ссылок.

ENAMETOOLONG

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

ENOENT

Компонент каталога в oldpath или newpath не существует или является повисшей ссылкой.

ENOMEM

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

ENOSPC

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

ENOTDIR

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

EPERM

oldpath является каталогом.

EPERM

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

EPERM (начиная с Linux 3.6)

Вызывающий не имеет прав для создания жёстких ссылок на этот файл (смотрите описание /proc/sys/fs/protected_hardlinks в proc(5)).

EPERM

Файл oldpath помечен как неизменяемый (immutable) или только для добавления (смотрите ioctl_iflags(2)).

EROFS

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

EXDEV

oldpath и newpath находятся не в одной смонтированной файловой системе (Linux позволяет монтировать файловую систему в несколько точек, но link() не работает с отличающими точками монтирования, даже если в них смонтирована идентичная файловая система).

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

EBADF

oldpath (newpath) is relative but olddirfd (newdirfd) is neither AT_FDCWD nor a valid file descriptor.

EINVAL

В flags указано неверное значение флага.

ENOENT

Флаг AT_EMPTY_PATH указан в flags, но вызывающий не имеет мандата CAP_DAC_READ_SEARCH.

ENOENT

Предпринята попытка сделать ссылку на файл /proc/self/fd/NN, который соответствует файловому дескриптору, созданному с помощью

open(path, O_TMPFILE | O_EXCL, mode);
    

Смотрите open(2).

ENOENT

An attempt was made to link to a /proc/self/fd/NN file corresponding to a file that has been deleted.

ENOENT

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

ENOTDIR

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

EPERM

Значение AT_EMPTY_PATH было указано в flags, значение oldpath равно пустой строке и olddirfd указывает на каталог.

ВЕРСИИ¶

POSIX.1-2001 says that link() should dereference oldpath if it is a symbolic link. However, since Linux 2.0, Linux does not do so: if oldpath is a symbolic link, then newpath is created as a (hard) link to the same symbolic link file (i.e., newpath becomes a symbolic link to the same file that oldpath refers to). Some other implementations behave in the same manner as Linux. POSIX.1-2008 changes the specification of link(), making it implementation-dependent whether or not oldpath is dereferenced if it is a symbolic link. For precise control over the treatment of symbolic links when creating a link, use linkat().

СТАНДАРТЫ¶

link()

POSIX.1-2008.

ИСТОРИЯ¶

link()

SVr4, 4.3BSD, POSIX.1-2001 (but see VERSIONS).

linkat()

POSIX.1-2008. Linux 2.6.16, glibc 2.4.

ПРИМЕЧАНИЯ¶

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

ОШИБКИ¶

В файловых системах NFS возвращаемый код может быть неправильным, если сервер NFS выполнит создание ссылки и завершит работу до возврата результата операции. Используйте stat(2), чтобы выяснить была ли создана ссылка.

СМОТРИТЕ ТАКЖЕ¶

ln(1), open(2), rename(2), stat(2), symlink(2), unlink(2), path_resolution(7), symlink(7)

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал Artyom Kunyov <artkun@guitarplayer.ru>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Konstantin Shvaykovskiy <kot.shv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.