READLINK

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
HISTORIQUE
VOIR AUSSI
TRADUCTION

NOM

readlink - Lire le contenu d'un lien symbolique

SYNOPSIS

#include <unistd.h>
ssize_t readlink(const char *path, char *buf, size_t bufsiz);

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

readlink() renvoie le nombre de caractères écrits dans le tampon, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

ERREURS

EACCES: Un élément du chemin d'accès ne permet pas la recherche. (Voir aussi path_resolution(2).)
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: Le chemin contient une référence circulaire (à travers un lien symbolique).
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 composant du chemin d'accès n'est pas un répertoire.

CONFORMITÉ

BSD 4.4 (la fonction readlink() est apparue dans BSD 4.2), POSIX.1-2001.

HISTORIQUE

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.

VOIR AUSSI

lstat(2), path_resolution(2), readlinkat(2), stat(2), symlink(2)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007