symlink()

Создать символьную ссылку

Прототип:

#include <unistd.h>
int symlink( const char *pname,
const char *slink );

Аргументы:

pname
Строка, содержащая путь к существующему объекту.
slink
Имя создаваемой символьной ссылки.

Библиотека:

libc

Описание:

Функция symlink() создает символьную ссылку slink, указывающую на объект pname.

Права доступа к pname или факт его существования не проверяются.

Если symlink() не завершается успешно файл slink не создается/изменяется.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EACCES
Компонент пути slink не имеет разрешений на поиск в директории или отсутствует разрешение на запись в родительской директории символьной ссылки.
EEXIST
Файл slink уже существует.
ELOOP
При создании символьной ссылки slink обнаружен цикл и он содержит более SYMLOOP_MAX уровней.
ENAMETOOLONG
Компонент пути slink превышает NAME_MAX байт, либо длина всего пути превышает PATH_MAX.
ENOSPC
Новая символьная ссылка не может быть создана из-за отсутствия свободной памяти в файловой системе.
ENOSYS
symlink() не реализована в целевой файловой системе, где запрошено было создание символьной ссылки slink.
ENOTDIR
Компоннет пути slink не является директорией.
EROFS
Попытка создания файла slink в файловой системе, отмеченной как "только для чтения".

Примеры:

/*
* create a symbolic link to "/usr/nto/include"
*/
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int main( void )
{
if ( symlink( "/usr/nto/include", "slink" ) == -1 )
{
perror( "slink -> /usr/nto/include" );
exit( EXIT_FAILURE );
}
exit( EXIT_SUCCESS );
}

Классификация:

POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

errno, link(), lstat(), pathmgr_symlink(), pathmgr_unlink(), readlink(), unlink()




Предыдущий раздел: Описание API системной библиотеки