NOM

       readlink - Lire le contenu d'un lien symbolique

SYNOPSIS

       #include <unistd.h>

       ssize_t readlink(const char *path, char *buf, size_t bufsiz);

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

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

DESCRIPTION

       readlink() place le contenu du lien symbolique path dans le tampon buf, dont la taille est
       bufsiz. readlink() n'ajoute pas de caractère NUL dans  le  tampon  buf.  Il  tronquera  le
       contenu (à la longueur bufsiz) si le tampon est trop petit pour recevoir les données.

VALEUR RENVOYÉE

       S'il  réussit,  readlink()  renvoie  le  nombre  d'octets placés dans buf. S'il échoue, il
       renvoie -1 et écrit errno en conséquence.

ERREURS

       EACCES Un élément  du  chemin  d'accès  ne  permet  pas  la  recherche.  (Consultez  aussi
              path_resolution(7).)

       EFAULT buf pointe en dehors de l'espace d'adressage accessible.

       EINVAL bufsiz n'est pas positif.

       EINVAL Le fichier n'est pas un lien symbolique.

       EIO    Une  erreur  d'entrée-sortie  est  survenue  lors  de  la lecture sur le système de
              fichiers.

       ELOOP  Trop de liens symboliques ont été rencontrés en parcourant le chemin.

       ENAMETOOLONG
              path ou l'un des composants de ce chemin d'accès est trop long.

       ENOENT Le fichier indiqué n'existe pas.

       ENOMEM Pas assez de mémoire pour le noyau.

       ENOTDIR
              Un élément du chemin d'accès n'est pas un répertoire.

CONFORMITÉ

       BSD 4.4 (readlink() est apparue pour la première fois dans BSD 4.2), POSIX.1-2001.

NOTES

       Dans les versions de glibc jusqu'à 2.4 incluse, le type  de  retour  de  readlink()  était
       déclaré  comme  int.  À présent, le type de retour est déclaré comme ssize_t, ainsi que le
       prescrit POSIX.1-2001.

       L'utilisation d'un tampon de taille statique risque de ne pas fournir assez de place  pour
       le contenu du lien symbolique. La taille nécessaire au tampon peut être lue dans la valeur
       stat.st_size renvoyée par un appel à lstat(2) sur le lien. Cependant, le  nombre  d'octets
       écrits par readlink() devrait être vérifié pour s'assurer que la taille du lien symbolique
       n'a pas augmenté entre les appels. L'allocation dynamique du tampon pour readlink() résout
       aussi  un problème habituel de portabilité si PATH_MAX est utilisé comme taille de tampon,
       car la définition de cette constante n'est pas garantie par POSIX si le système n'a pas ce
       genre de limite.

EXEMPLE

       Le  programme  suivant alloue le tampon nécessaire à readlink() dynamiquement à partir des
       données fournies par lstat(), en s'assurant qu'il n'y a pas de  situation  de  compétition
       entre les appels.

       #include <sys/types.h>
       #include <sys/stat.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <unistd.h>

       int
       main(int argc, char *argv[])
       {
           struct stat sb;
           char *linkname;
           ssize_t r;

           if (argc != 2) {
               fprintf(stderr, "Utilisation : %s <chemin>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           if (lstat(argv[1], &sb) == -1) {
               perror("lstat");
               exit(EXIT_FAILURE);
           }

           linkname = malloc(sb.st_size + 1);
           if (linkname == NULL) {
               fprintf(stderr, "mémoire insuffisante\n");
               exit(EXIT_FAILURE);
           }

           r = readlink(argv[1], linkname, sb.st_size + 1);

           if (r == -1) {
               perror("readlink");
               exit(EXIT_FAILURE);
           }

           if (r > sb.st_size) {
               fprintf(stderr, "la taille du lien symbolique a augmenté"
                               "entre lstat() et readlink()\n");
               exit(EXIT_FAILURE);
           }

           linkname[r] = '\0';

           printf("« %s » pointe vers « %s »\n", argv[1], linkname);

           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       readlink(1), lstat(2), readlinkat(2), stat(2), symlink(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/>.

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