READLINK
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 26 juillet 2007
Index
Menu principal
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 (voir
feature_test_macros(7)) :
readlink() :
_BSD_SOURCE || _XOPEN_SOURCE >= 500 || _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
readlink()
renvoie le nombre de caractères placés 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(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 s'est produite lors de la lecture sur
le système de fichiers.
- ELOOP
-
pathn
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 élément 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.
NOTES
Dans les versions de la glibc jusqu'à la 2.4 incluse,
le type de retour de
readlink()
était déclaré comme un
int.
Aujourd'hui, le type de retour est déclaré comme un
ssize_t,
ainsi que le prescrit POSIX.1-2001.
VOIR AUSSI
lstat(2),
readlinkat(2),
stat(2),
symlink(2),
path_resolution(7),
symlink(7)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 12 octobre 1996
et révisée le 2 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 readlink ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 2 juillet 2008