Loading

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);

       Cette  fonction  renvoie  le  chemin complet de l’élément de répertoire
       indiqué par 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.

CONFORMITÉ

       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.23  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

       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, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       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> ».