readlink

NOM

BIBLIOTHÈQUE

SYNOPSIS

#include <unistd.h>

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

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

ssize_t readlinkat(int dirfd, const char *restrict pathname,
                 char *restrict buf, size_t bufsiz);

readlink():

    _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L
        || /* glibc <= 2.19 : */ _BSD_SOURCE

readlinkat():

    Depuis la glibc 2.10 :
        _POSIX_C_SOURCE >= 200809L
    avant la glibc 2.10 :
        _ATFILE_SOURCE

DESCRIPTION

readlinkat()

Si pathname est un chemin 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 courant du processus appelant, comme cela est fait par readlink() pour un chemin relatif).

Si pathname est relatif et si dirfd a la valeur spéciale AT_FDCWD, alors pathname est interprété relativement au répertoire de travail du processus appelant, comme pour readlink().

Si pathname est absolu, alors dirfd est ignoré.

Depuis Linux 2.6.39, pathname peut être une chaîne vide, auquel cas l'appel opère sur le lien symbolique référencé par dirfd (qui peut avoir été obtenu par open(2) avec les drapeaux O_PATH et O_NOFOLLOW).

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

VALEUR RENVOYÉE

ERREURS

EACCES

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

EBADF

(readlinkat()) pathname est relatif mais dirfd n'est ni AT_FDCWD, ni un descripteur de fichier valable.

EFAULT

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

EINVAL

bufsiz n'est pas un nombre positif.

EINVAL

Le fichier nommé (à savoir le composant final du nom de fichier dans pathname) n'est pas un lien symbolique.

EIO

Une erreur d'entrée-sortie s'est produite durant la lecture du système de fichiers.

ELOOP

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

ENAMETOOLONG

Un nom de chemin d'accès ou l'un des composants d'un nom de chemin d'accès est trop long.

ENOENT

Le fichier indiqué n'existe pas.

ENOMEM

La mémoire disponible du noyau n'était pas suffisante.

ENOTDIR

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

ENOTDIR

(readlinkat()) pathname est relatif et dirfd est un descripteur de fichier faisant référence à un fichier qui n'est pas un dossier.

STANDARDS

HISTORIQUE

readlink()

4.4BSD (apparue dans 4.2BSD), POSIX.1-2001, POSIX.1-2008.

readlinkat()

POSIX.1-2008. Linux 2.6.16, glibc 2.4.

Jusqu'à la glibc 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.  

glibc

NOTES

EXEMPLES

#include <limits.h> #include <stdio.h> #include <stdlib.h> #include <sys/stat.h> #include <sys/types.h> #include <unistd.h> int main(int argc, char *argv[]) {
    char         *buf;
    ssize_t      nbytes, bufsiz;
    struct stat  sb;
    if (argc != 2) {
        fprintf(stderr, "Utilisation : %s <pathname>\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    if (lstat(argv[1], &sb) == -1) {
        perror("lstat");
        exit(EXIT_FAILURE);
    }
    /* Ajouter un à la taille du lien, pour pouvoir déterminer si le tampon
       renvoyé par readlink() a été tronqué. */
    bufsiz = sb.st_size + 1;
    /* Certains liens symboliques magiques dans (par exemple) /proc et /sys
       indiquent 'st_size' comme zéro. Dans ce cas, prendre PATH_MAX
       comme estimation « acceptable ». */
    if (sb.st_size == 0)
        bufsiz = PATH_MAX;
    buf = malloc(bufsiz);
    if (buf == NULL) {
        perror("malloc");
        exit(EXIT_FAILURE);
    }
    nbytes = readlink(argv[1], buf, bufsiz);
    if (nbytes == -1) {
        perror("readlink");
        exit(EXIT_FAILURE);
    }
    /* Print only 'nbytes' of 'buf', as it doesn't contain a terminating
       null byte ('\0'). */
    printf("'%s' pointe vers '%.*s'\n", argv[1], (int) nbytes, buf);
    /* Si la valeur renvoyée était égale à la taille du tampon, la cible du
       lien était plus grande que prévu (peut-être parce que la cible
       a changé entre l'appel à lstat() et l'appel à readlink()).
       Avertir l'utilisateur que la cible renvoyée peut avoir
       été tronquée. */
    if (nbytes == bufsiz)
        printf("(Il se peut que le tampon renvoyé ait été tronqué)\n");
    free(buf);
    exit(EXIT_SUCCESS); }  

VOIR AUSSI

TRADUCTION

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à

Index

NOM

BIBLIOTHÈQUE

SYNOPSIS

DESCRIPTION

readlinkat()

VALEUR RENVOYÉE

ERREURS

STANDARDS

HISTORIQUE

glibc

NOTES

EXEMPLES

VOIR AUSSI

TRADUCTION