Provided by: manpages-ru_0.98-4_all bug

ИМЯ

       unlink - удаляет имя и возможно файл, на который оно ссылается

ОБЗОР

       #include <unistd.h>

       int unlink(const char *pathname);

ОПИСАНИЕ

       unlink  удаляет  имя  из  файловой  системы. Если это имя было последней ссылкой на файл и
       больше нет процессов, которые держат этот файл открытым, данный файл  удаляется  и  место,
       которое он занимает освобождается для дальнейшего использования.

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

       Если имя указывает на символьную ссылку, ссылка будет удалена.

       Если  имя указывает на сокет, FIFO или устройство, имя будет удалено, но процессы, которые
       открыли любой из этих объектов могут продолжать его использовать.

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

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

ОШИБКИ

       EACCES Доступ  на  запись  в  каталог,  содержащий  pathname  не разрешён для эффективного
              идентифкатора пользователя текущего процесса или  права  на  один  из  каталогов  в
              pathname не позволяют поиск (выполнение).

       EPERM или EACCES
              Каталог, содержащий pathname имеет установленный sticky-бит (S_ISVTX) и эффективный
              идентификатор пользователя текущего  процесса  не  совпадает  и  с  идентификатором
              пользователя  удаляемого файла и с идентификатором пользователя каталога, в котором
              содержится этот файл.

       EPERM (Только в Linux)
              Файловая система не разрешает удаление файлов.

       EPERM  Система не разраешает удаление каталогов или удаление каталогов требует превилегий,
              которыми не обладает текущий процесс.  (Этот код ошибки появился в POSIX.)

       EISDIR pathname  указывает  на  каталог.   (Это  не-POSIX  значение,  возвращаемое в Linux
              начиная с 2.1.132.)

       EBUSY (нет в Linux)
              Файл pathname не может быть удалён, потому что он используется системой или  другим
              процессом и текущая реализация вызова считает, что это ошибка.

       EFAULT pathname указывает за пределы доступного вам адресного пространства.

       ENAMETOOLONG
              pathname имеет слишком большую длину.

       ENOENT Какой-либо  компонент  в  pathname  не  существует или является битой ссылкой или в
              pathname пусто.

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

       ENOMEM Не хватает памяти.

       EROFS  pathname указывает на файл в файловой системе доступной только для чтения.

       ELOOP  Слишком много символьных ссылок было обнаружено при трансляции pathname.

       EIO    Случилась ошибка ввода/вывода.

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

       SVr4,  SVID,  POSIX,  X/OPEN,  4.3BSD.   SVr4  документирует дополнительные условия ошибок
       EINTR, EMULTIHOP, ETXTBSY, ENOLINK.

БАГИ

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

СМОТРИ ТАКЖЕ

       link(2), rename(2), open(2), rmdir(2), mknod(2), mkfifo(3), remove(3), rm(1)

ПЕРЕВОД

       Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2004