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

NOM

       symlink - Créer un nouveau nom pour un fichier

SYNOPSIS

       #include <unistd.h>

       int symlink(const char *oldpath, const char *newpath);

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

       symlink() :
           _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
           _POSIX_C_SOURCE >= 200112L

DESCRIPTION

       symlink() crée un lien symbolique avec le nom newpath indiqué, et qui pointe sur oldpath.

       Les  liens  sont interprétés à l'exécution, comme si le contenu du lien était remplacé par
       le chemin d'accès pour trouver un fichier ou un répertoire.

       Les liens symboliques peuvent contenir .. pour le chemin, qui (s'il est utilisé  au  début
       du lien) se réfère aux répertoires parents du lien.

       Un  lien  symbolique  (aussi nommé « soft link ») peut pointer vers un fichier existant ou
       sur un fichier non existant.

       Les permissions d'accès à un lien symbolique sont sans  importance,  le  propriétaire  est
       ignoré  lorsque l'on suit le lien, il n'est vérifié que pour supprimer ou renommer le lien
       si celui-ci se trouve dans un répertoire avec le sticky bit (S_ISVTX) positionné.

       Si newpath existe, il ne sera pas écrasé.

VALEUR RENVOYÉE

       S'il réussit, cet appel système renvoie 0. S'il échoue, il renvoie -1 et remplit errno  en
       conséquence.

ERREURS

       EACCES L'écriture  dans  le  répertoire  contenant  newpath  est  interdite,  ou  l'un des
              répertoires  composant  newpath  ne  permet  pas  le  parcours.  (Consultez   aussi
              path_resolution(7).)

       EEXIST newpath existe déjà.

       EFAULT oldpath ou newpath pointent en dehors de l'espace d'adressage accessible.

       EIO    Une erreur d'entrée-sortie s'est produite.

       ELOOP  newpath contient une référence circulaire (à travers un lien symbolique).

       ENAMETOOLONG
              oldpath ou newpath est trop long.

       ENOENT Un  répertoire  dans  le  chemin  newpath  n'existe  pas  ou est un lien symbolique
              pointant nulle part. Ou encore oldpath est une chaîne vide.

       ENOMEM Pas assez de mémoire pour le noyau.

       ENOSPC Le périphérique contenant le fichier n'a pas de place pour une nouvelle  entrée  de
              répertoire.

       ENOTDIR
              Un  composant  utilisé comme un répertoire dans le chemin newpath n'est en fait pas
              un répertoire.

       EPERM  le système de fichiers contenant  newpath  ne  permet  pas  la  création  de  liens
              symboliques.

       EROFS  Le chemin newpath se trouve sur un système de fichiers en lecture seule.

CONFORMITÉ

       SVr4, BSD 4.3, POSIX.1-2001.

NOTES

       Il n'y a pas de vérification de l'existence de oldpath.

       Effacer le nom référencé par un lien symbolique effacera effectivement le fichier (à moins
       qu'il ait d'autres liens matériels). Si ce comportement est indésirable, utiliser link(2).

VOIR AUSSI

       ln(1),  lchown(2),  link(2),  lstat(2),  open(2),  readlink(2),  rename(2),  symlinkat(2),
       unlink(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/>.

       Christophe   Blaess   <URL:http://www.blaess.fr/christophe/>   (1996-2003),  Alain  Portal
       <URL:http://manpagesfr.free.fr/> (2003-2006). 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> ».