Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

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.

       Par défaut, linkat() ne  déréférence  pas  oldpath  si  c'est  un  lien
       symbolique  (de  même  que  link(2)).  Depuis  Linux 2.6.18, 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.

       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.

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.32  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      être       trouvées       à       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue à l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'équipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL: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> ».