NOM¶
lookup_dcookie - Renvoyer le chemin d'accès d'un élément de
répertoire
SYNOPSIS¶
int lookup_dcookie(u64 cookie, char *buffer,
size_t len);
DESCRIPTION¶
Renvoie le chemin complet de l'élément de répertoire
spécifié par la valeur
cookie. Le cookie est un
identifiant opaque référençant de manière unique
un élément de répertoire donné. Le tampon fourni
est rempli avec le chemin d'accès complet de cet élément.
Pour que
lookup_dcookie() fonctionne, le noyau doit déjà
connaître le
cookie référençant
l'élément de répertoire.
VALEUR RENVOYÉE¶
S'il réussit,
lookup_dcookie() renvoie la longueur de la
chaîne copiée dans le tampon. En cas d'erreur, il renvoie -1 et
remplit
errno avec le code d'erreur.
ERREURS¶
- EFAULT
- Le tampon est invalide.
- EINVAL
- Le noyau n'a pas d'association cookie/élément de
répertoire correspondant au cookie, ou le cookie ne fait pas
référence à un élément valide.
- ENAMETOOLONG
- Le nom ne tient pas dans le tampon.
- ENOMEM
- Le noyau ne peut pas allouer assez de mémoire pour les tampons
temporaires.
- EPERM
- Le processus n'a pas la capacité CAP_SYS_ADMIN
nécessaire pour lire des valeurs de cookie.
- ERANGE
- Le tampon fourni n'est pas assez grand pour contenir le chemin
d'accès.
VERSIONS¶
Disponible depuis Linux 2.5.43. L'erreur
ENAMETOOLONG a été
ajoutée dans Linux 2.5.70.
lookup_dcookie() est spécifique à Linux.
NOTES¶
lookup_dcookie() est un appel système spécial,
utilisé actuellement uniquement par le profiler oprofile. Il s'appuie
sur un pilote du noyau pour enregistrer les cookies des éléments
de répertoire.
Le chemin renvoyé peut avoir un suffixe
« (deleted) » si l'élément de
répertoire a été supprimé.
COLOPHON¶
Cette page fait partie de la publication 3.65 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> ».