Seth Woolley's Man Viewer

UNLINK(2)                 Manuel du programmeur Linux                UNLINK(2)



NOM
       unlink(1,2) - Détruire un nom et éventuellement le fichier associé.

SYNOPSIS
       #include <unistd.h>

       int unlink(1,2)(const char *pathname);

DESCRIPTION
       unlink(1,2)  détruit  un nom dans le système de fichiers. Si ce nom était
       le dernier lien sur un fichier, et si aucun  processus  n'a  ouvert  ce
       fichier,  ce dernier est effacé, et l'espace qu'il utilisait est rendu
       disponible.

       Si le nom était le dernier lien sur un fichier, mais  qu'un  processus
       conserve encore le fichier ouvert, celui continue d'exister jusqu'Ã  ce
       que le dernier descripteur le référençant soit fermé.

       Si le nom correspond à un lien symbolique, le lien est effacé.

       Si le nom correspond à une socket(2,7,n), une Fifo, ou un périphérique,  le
       nom  est effacé mais les processus qui ont ouvert l'objet peuvent con-
       tinuer à l'utiliser.

VALEUR RENVOYÃE
       unlink(1,2) renvoie 0 s'il réussit ou -1 s'il  échoue,  auquel  cas  errno
       contient le code d'erreur.

ERREURS
       EACCES L'accès  en  écriture  au répertoire contenant pathname n'est
              pas autorisé pour l'UID effectif du processus, ou bien l'un des
              répertoires de pathname n'autorise pas le parcours.

       EPERM ou EACCESS
              Le  répertoire  contenant  pathname  a  son Sticky-Bit à 1, et
              l'UID effectif du processus n'est ni celui du fichier  ni  celui
              du répertoire.

       EPERM (spécifique Linux)
              Le  système  de  fichiers  ne  permet  pas  la destruction avec
              unlink.

       EPERM  Le système ne permet pas la destruction des  répertoires  avec
              unlink(1,2),  ou  cette destruction nécessite des privilèges que le
              processus appelant n'a pas.  (Il s'agit d'une erreur conseillée
              par POSIX).

       EISDIR pathname  est un répertoire.  (Il s'agit d'une erreur non-POSIX
              renvoyée par Linux depuis le 2.1.132).

       EBUSY (spécifique Linux)
              Le fichier pathname ne peut pas être détruit avec  unlink(1,2)  car
              il  est  utilisé  par le système ou par un autre processus, et
              l'implémentation considère que c'est une erreur.

       EFAULT pathname pointe en dehors de l'espace d'adressage accessible

       ENAMETOOLONG
              pathname est trop long.

       ENOENT Un répertoire dans le chemin d'accès pathname n'existe pas  ou
              est un lien symbolique pointant nulle part.

       ENOTDIR
              Un  élément  du  chemin d'accès pathname n'est pas un réper-
              toire.  ENOMEM pas assez de mémoire pour le noyau

       EROFS  pathname est placé sur  un  système  de  fichiers  en  lecture
              seule.

       ELOOP  Trop de liens symboliques dans le chemin d'accès pathname.

       EIO    une erreur d'entrée/sortie bas-niveau s'est produite.

CONFORMITÃ
       SVr4,  SVID,  POSIX,  X/OPEN,  BSD  4.3.  SVr4 mentionne les conditions
       d'erreur supplémentaires  EINTR, EMULTIHOP, ETXTBSY, ENOLINK.

BOGUES
       Des problèmes dans le protocole sous-jacent à NFS peuvent  causer  la
       disparition inattendue de fichiers encore en utilisation.

VOIR AUSSI
       link(1,2)(2),  rename(1,2,n)(2), open(2,3,n)(2), rmdir(1,2)(2), mknod(1,2)(2), mkfifo(1,3)(3), remove(3),
       rm(1).

TRADUCTION
       Christophe Blaess, 1996-2003.



LDP                             18 juillet 2003                      UNLINK(2)