lookup_dcookie(2)             System Calls Manual            lookup_dcookie(2)

NOM
       lookup_dcookie - Renvoyer le chemin d'acces d'un element de repertoire

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <sys/syscall.h>      /* Definition des constantes SYS_* */
       #include <unistd.h>

       int syscall(SYS_lookup_dcookie, uint64_t cookie, char *buffer,
                   size_t len);

       Remarque : la glibc ne fournit par d'enveloppe pour lookup_dcookie(),
       imposant l'utilisation de syscall(2).

DESCRIPTION
       Renvoie le chemin complet de l'element de repertoire specifie par la
       valeur cookie. Le cookie est un identifiant opaque referencant de
       maniere unique un element de repertoire donne. Le tampon fourni est
       rempli avec le chemin d'acces complet de cet element.

       Pour que lookup_dcookie() fonctionne, le noyau doit deja connaitre le
       cookie referencant l'element de repertoire.

VALEUR RENVOYEE
       S'il reussit, lookup_dcookie() renvoie la longueur de la chaine copiee
       dans le tampon. En cas d'erreur, il renvoie -1 et errno est defini pour
       preciser l'erreur.

ERREURS
       EFAULT Le tampon est invalide.

       EINVAL Le noyau n'a pas d'association cookie/element de repertoire
              correspondant au cookie, ou le cookie ne fait pas reference a un
              element valide.

       ENAMETOOLONG
              Le nom ne tient pas dans le tampon.

       ENOMEM Le noyau ne peut pas allouer assez de memoire pour les tampons
              temporaires.

       EPERM  Le processus n'a pas la capacite CAP_SYS_ADMIN necessaire pour
              lire des valeurs de cookie.

       ERANGE Le tampon fourni n'est pas assez grand pour contenir le chemin
              d'acces.

STANDARDS
       Linux.

HISTORIQUE
       Linux 2.5.43

       L'erreur ENAMETOOLONG a ete ajoutee dans Linux 2.5.70.

NOTES
       lookup_dcookie() est un appel systeme special, utilise actuellement
       uniquement par le profiler oprofile(1). Il s'appuie sur un pilote du
       noyau pour enregistrer les cookies des elements de repertoire.

       Le chemin renvoye peut avoir un suffixe << (deleted) >> si l'element de
       repertoire a ete supprime.

VOIR AUSSI
       oprofile(1)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023              lookup_dcookie(2)