LOOKUP_DCOOKIE

Index

NOM
SYNOPSIS
DESCRIPTION
NOTES
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
DISPONIBILITÉ
TRADUCTION

NOM

lookup_dcookie - Renvoyer le chemin d'accès d'un élément de répertoire

SYNOPSIS

int lookup_dcookie(u64 cookie, char * tampon, size_t len);

DESCRIPTION

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.

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

VALEUR RENVOYÉE

Si elle réussit, la fonction lookup_dcookie() renvoie la longueur de la chaîne copiée dans le tampon. En cas d'erreur, elle 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.

CONFORMITÉ

lookup_dcookie() est spécifique à Linux.

DISPONIBILITÉ

Cet appel système est disponible depuis Linux 2.5.43. L'erreur ENAMETOOLONG a été ajoutée dans Linux 2.5.70.

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