table of contents
other sections
UNLINKAT(2) | Manuel du programmeur Linux | UNLINKAT(2) |
NOM¶
unlinkat - Supprimer une entrée de répertoire relative à un descripteur de fichierSYNOPSIS¶
#include <fcntl.h> /* Définition des constantes AT_* */ #include <unistd.h>int unlinkat(int dirfd, const char *pathname, int flags);
Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
- Depuis la glibc 2.10 :
- _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
- Avant la glibc 2.10 :
- _ATFILE_SOURCE
DESCRIPTION¶
L'appel système unlinkat() fonctionne exactement comme unlink(2) ou rmdir(2) (en fonction de la présence ou non du drapeau AT_REMOVEDIR dans flags), les seules différences étant décrites sur cette page.- AT_REMOVEDIR
- Par défaut, unlinkat() a un effet équivalent à celui de unlink(2) sur pathname. Si le drapeau AT_REMOVEDIR est indiqué, unlinkat() fonctionne comme rmdir(2) sur pathname.
VALEUR RENVOYÉE¶
L'appel renvoie zéro s'il réussit, ou -1 s'il échoue auquel cas errno contient le code d'erreur.ERREURS¶
Les erreurs renvoyées par unlink(2) et rmdir(2) peuvent aussi l'être par unlinkat(). Les erreurs supplémentaires suivantes peuvent également se produire :- EBADF
- dirfd n'est pas un descripteur de fichier valable.
- EINVAL
- flags contient un drapeau invalide.
- ENOTDIR
- pathname est relatif, et le descripteur de fichier dirfd est associé à un fichier, pas à un répertoire.
VERSIONS¶
unlinkat() a été ajouté au noyau Linux dans sa version 2.6.16 ; la glibc le gère depuis la version 2.4.CONFORMITɶ
POSIX.1-2008. Un appel système similaire existe sur Solaris.NOTES¶
Consultez openat(2) pour une explication de la nécessité de unlinkat().VOIR AUSSI¶
openat(2), rmdir(2), unlink(2), path_resolution(7)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr. Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».4 mai 2012 | Linux |