lookup_dcookie - Renvoyer le chemin d'accès d'un élément de
répertoire
Bibliothèque C standard (
libc,
-lc)
#include <sys/syscall.h> /* Définition 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).
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.
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
errno est défini pour préciser l'erreur.
- 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.
Disponible depuis Linux 2.5.43. L'erreur
ENAMETOOLONG a
été ajoutée dans Linux 2.5.70.
lookup_dcookie() est spécifique à Linux.
lookup_dcookie() est un appel système spécial,
utilisé actuellement uniquement par le profiler
oprofile(1). 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é.
oprofile(1)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Jean-Philippe MENGUAL <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]