Fonctions du
système (section 2) unlink
Nom
unlink - Détruire un nom et éventuellement le fichier associé.Synopsis
#include <unistd.h>int unlink(const char *pathname);
Description
unlink 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, une Fifo, ou un périphérique, le nom est effacé mais les processus qui ont ouvert l'objet peuvent continuer à l'utiliser.
Valeur Renvoyée
unlink 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.
- EFAULT
- pathname pointe en dehors de l'espace d'adressage accessible
- 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
- pathname est un répertoire.
- 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'acces pathname n'est pas un répertoire.
- EISDIR
- pathname est un répertoire
- ENOMEM
- pas assez de mémoire pour le noyau
- EROFS
- pathname est placé sur un système de fichiers en lecture seule.
- 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 EBUSY, 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(2) , rename(2) , open(2) , rmdir(2) , mknod(2) , mkfifo(3) , remove(3) , rm(1) .
Traduction
Christophe Blaess, 1997.