NOM

       linkat - Créer un lien vers un fichier relatif à un répertoire

SYNOPSIS

       #include <fcntl.h> /* Définition des constantes AT_* */
       #include <unistd.h>

       int linkat(int olddirfd, const char *oldpath,
                  int newdirfd, const char *newpath, int flags);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       linkat() :
           Depuis la glibc 2.10 :
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _ATFILE_SOURCE

DESCRIPTION

       L'appel système linkat() fonctionne exactement comme link(2), les seules différences étant
       celles décrites dans cette page.

       Si  le  chemin donné dans oldpath est relatif, il est interprété par rapport au répertoire
       référencé par le descripteur de fichier olddirfd (plutôt que  par  rapport  au  répertoire
       courant du processus appelant, comme dans link(2)).

       Si  oldpath  est relatif et olddirfd a la valeur spéciale AT_FDCWD, oldpath est interprété
       relativement au répertoire courant du processus appelant, comme link(2).

       Si oldpath est un chemin absolu, olddirfd est ignoré.

       L'interprétation de newpath est identique à celle de oldpath, excepté qu'un chemin relatif
       est interprété par rapport au répertoire correspondant à newdirfd.

       Les valeurs suivantes peuvent être combinées avec un OU binaire dans le paramètre flags :

       AT_EMPTY_PATH (depuis Linux 2.6.39)
              Si  oldpath  est  une  chaîne  vide,  créer  un  lien vers le fichier référencé par
              olddirfd (qui peut avoir été obtenu en utilisant open(2) avec le  drapeau  O_PATH).
              Dans  ce  cas,  olddirfd  peut  référer  à  tout type de fichier, pas uniquement un
              répertoire. L'appelant doit avoir la capacité CAP_DAC_READ_SEARCH pour utiliser  ce
              drapeau.  Cette  sécurité  empêche  des utilisateurs arbitraires de créer des liens
              matériels  en  utilisant  des  descripteurs  de  fichiers  reçus  via  socket  UNIX
              (consultez la discussion au sujet de SCM_RIGHTS dans unix(7)).

       AT_SYMLINK_FOLLOW (depuis Linux 2.6.18)
              Par  défaut,  linkat()  ne  déréférence pas oldpath si c'est un lien symbolique (de
              même que link(2)). L'attribut AT_SYMLINK_FOLLOW peut être  passé  dans  flags  pour
              forcer le déréférencement de oldpath si c'est un lien symbolique.

       Avant le noyau 2.6.18, l'argument flags n'était pas utilisé, et devait être nul.

VALEUR RENVOYÉE

       S'il  réussit, linkat() renvoie zéro. En cas d'erreur, il renvoie -1 et remplit errno avec
       la valeur d'erreur.

ERREURS

       Les erreurs  renvoyées  par  link(2)  peuvent  aussi  l'être  par  linkat().  Les  erreurs
       supplémentaires suivantes peuvent également se produire pour linkat() :

       EBADF  olddirfd ou newdirfd n'est pas un descripteur de fichier valable.

       EINVAL flags contient un drapeau invalide.

       ENOENT AT_EMPTY_PATH   est  indiqué  dans  flags  mais  l'appelant  n'a  pas  la  capacité
              CAP_DAC_READ_SEARCH.

       ENOENT Une  tentative  de  lier  vers  le  fichier  /proc/self/fd/NN  correspondant  à  un
              descripteur de fichier créé avec

                  open(path, O_TMPFILE | O_EXCL, mode);

              a été réalisée. Consultez open(2).

       ENOTDIR
              oldpath  est  un  chemin  relatif,  et  olddirfd  est  un descripteur de fichier ne
              référençant pas un répertoire ; ou bien c'est le cas pour newpath et newdirfd.

VERSIONS

       linkat() 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.

NOTES

       Consultez openat(2) pour une explication de la nécessité de linkat().

VOIR AUSSI

       link(2), openat(2), path_resolution(7), symlink(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> ».