readlink()

Поместить содержимое символьной ссылки в буфер

Прототип:

#include <unistd.h>
int readlink( const char *path,
char *buf,
size_t bufsiz );

Аргументы:

path
Имя символьной ссылки.
buf
Указатель на буфер, в котором функция может хранить содержимое символической ссылки (т.е. путь, на который указывает ссылка).
bufsiz
Размер буфера.

Библиотека:

libc

Описание:

Функция readlink() помещает содержимое символьной ссылки с именем path в буфер, на который указывает buf, размер которого равен bufsiz. Содержимое возвращенной символической ссылки не включает терминатор NULL. Длина содержимого должна определяться из структуры struct stat , возвращаемой lstat(), или значением 3 из вызова readlink().

При успешном завершении readlink(), до bufsiz байтов из содержимого символической ссылки помещается в buf.

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

Количество байтов, помещенных в буфер.

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EACCES
Для компонента префикса path отказано в разрешении на поиск.
EINVAL
Указанный файл не является символической ссылкой.
ELOOP
Обнаружен цикл в символических ссылках, встреченных во время разрешения аргумента path, и было обнаружено более чем SYMLOOP_MAX символических ссылок.
ENAMETOOLONG
Компонент path превысил NAME_MAX символов, или целый путь превысил PATH_MAX символов.
ENOENT
Указанный файл не существует.
ENOSYS
Ссылки не поддерживаются менеджером ресурсов, связанным с path.
ENOTDIR
Компонент префикса path не является каталогом.

Примеры:

/*
* Read the contents of the named symbolic links
*/
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
char buf[PATH_MAX + 1];
int main( int argc, char** argv )
{
int n;
int len;
int ecode = 0;
for ( n = 1; n < argc; ++n )
{
if ( (len = readlink( argv[n], buf, PATH_MAX )) == -1 )
{
perror( argv[n] );
ecode++;
} else {
buf[len] = '\0';
printf( "%s -> %s\n", argv[n], buf );
}
}
return (ecode);
}

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

POSIX 1003.1

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

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

errno, struct stat, lstat(), symlink()




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