MAN unlink 2

Материал из Gentoo Linux Wiki

Вернуться в раздел мануалов

[править] Имя

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

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

This manpage is Copyright (C) 1992 Drew Eckhardt;
1993 Ian Jackson.

Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one

Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.

Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.

Modified Sat Jul 24 13:00:50 1993 by Rik Faith <faith@cs.unc.edu>
Modified Sun Sep 8 18:59:01 1996 by aeb following remarks by
Arnt Gulbrandsen <agulbra@troll.no>
Modified Fri Jan 31 23:49:15 1997 by Eric S. Raymond <esr@thyrsus.com>
Modified Thu May 17 12:15:26 2001 by aeb

Дата последней коррекции перевода 14.06.2004
Перевод с английского сделал Виктор Вислобоков <corochoone@perm.ru>
http://www.linuxshare.ru/projects/trans/mans.html