NOM

       unlinkat - Supprimer une entrée de répertoire relative à un descripteur de fichier

SYNOPSIS

       #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)) :

       unlinkat():
           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.

       Si le chemin donné dans pathname est relatif, il est interprété par rapport au répertoire  référencé  par
       le descripteur de fichier dirfd (plutôt que par rapport au répertoire de travail, comme c'est le cas pour
       unlink(2) et rmdir(2)).

       Si  le  chemin  donné dans pathname est relatif et si dirfd a la valeur spéciale AT_FDCWD, alors pathname
       est interprété par rapport au répertoire de travail  du  processus  appelant  (comme  pour  unlink(2)  et
       rmdir(2)).

       Si le chemin donné dans pathname est absolu, dirfd est ignoré.

       flags  est  un  masque  qui  peut  être  0  ou  construit par un OU binaire de drapeaux qui contrôlent le
       fonctionnement de unlinkat(). Actuellement, un seul drapeau est défini :

       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.

       EISDIR pathname est un répertoire et AT_REMOVEDIR n’était pas indiqué dans flags.

       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.57 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> ».

Linux                                            22 janvier 2014                                     UNLINKAT(2)