Provided by: manpages-fr-dev_3.65d1p1-1_all 
NOM
getauxval - Récupérer une valeur du vecteur auxiliaire
SYNOPSIS
#include <sys/auxv.h>
unsigned long getauxval(unsigned long type);
DESCRIPTION
La fonction getauxval() récupère des valeurs du vecteur auxiliaire, un mécanisme que le
chargeur de binaires ELF du noyau utilise pour passer certains renseignements à l'espace
utilisateur quand un programme est exécuté.
Toutes les entrées du vecteur auxiliaire sont des paires de valeurs : un type qui
identifie ce que l'entrée représente, et une valeur pour ce type. En fonction de
l'argument type, getauxval() renvoie la valeur correspondante.
Les valeurs renvoyées pour tous les types sont données dans la liste suivante. Les
différentes valeurs de type ne sont pas toutes présentes suivant l'architecture.
AT_BASE
L'adresse de base de l'interpréteur du programme (l'éditeur de liens dynamique en
général).
AT_BASE_PLATFORM
Une chaîne identifiant la plateforme réelle ; peut être différente de AT_PLATFORM
(PowerPC seulement).
AT_CLKTCK
La fréquence utilisée par times(2) pour compter. Cette valeur peut aussi être
obtenue avec sysconf(_SC_CLK_TCK).
AT_DCACHEBSIZE
La taille du bloc de cache de données.
AT_EGID
Le GID effectif du thread.
AT_ENTRY
L'adresse d'entrée de l'exécutable.
AT_EUID
L'UID effectif du thread.
AT_EXECFD
Le descripteur de fichier du programme.
AT_EXECFN
Le nom de chemin utilisé pour exécuter le programme.
AT_FLAGS
Les attributs (inutilisé).
AT_FPUCW
Le mot de contrôle FPU utilisé (architecture SuperH seulement). Cela donne quelques
renseignements sur l'initialisation FPU réalisée par le noyau.
AT_GID Le GID réel du thread.
AT_HWCAP
Un pointeur vers un masque multioctet de bits dont les réglages indiquent des
capacités processeurs détaillées. Le contenu du masque de bits dépend du matériel
(consultez par exemple le fichier arch/x86/include/asm/cpufeature.h des sources du
noyau pour obtenir des précisions sur l'architecture x86). Une version lisible des
mêmes renseignements est disponible dans /proc/cpuinfo.
AT_ICACHEBSIZE
La taille du bloc de cache d'instructions.
AT_PAGESZ
La taille de page du système (la même valeur que celle renvoyée par
sysconf(_SC_PAGESIZE)).
AT_PHDR
L'adresse des en-têtes du programme de l'exécutable.
AT_PHENT
La taille de l'entrée des en-têtes du programme.
AT_PHNUM
Le nombre d'en-têtes du programme.
AT_PLATFORM
Un pointeur vers une chaîne qui identifie la plate-forme matérielle sur laquelle le
programme est exécuté. L'éditeur de liens dynamique utilise cela dans
l'interprétation des valeurs rpath.
AT_RANDOM
L'adresse de seize octets contenant une valeur aléatoire.
AT_SECURE
Une valeur non nulle si l'exécutable devrait être traité de façon sécurisée. Le
plus souvent, une valeur non nulle indique que le processus exécute un programme
Set-UID ou Set-GID ; sinon, une valeur non nulle pourrait être provoquée par un
module de sécurité Linux. Quand cette valeur est non nulle, l'éditeur de liens
dynamique désactive l'utilisation de certaines variables d'environnement (consultez
ld-linux.so(8)) et glibc modifie d'autres facettes de son comportement (consultez
aussi secure_getenv(3)).
AT_SYSINFO
Le point d'entrée vers la fonction d'appel système dans le vDSO. N'est ni présent
ni nécessaire sur toutes les architectures (par exemple absent sur x86-64).
AT_SYSINFO_EHDR
L'adresse d'une page contenant le vDSO (objet partagé dynamique virtuel, « virtual
dynamic shared object ») que le noyau crée pour fournir des implémentations rapides
de certains appels systèmes.
AT_UCACHEBSIZE
La taille du bloc de cache unifié.
AT_UID L'UID réel du thread.
VALEUR RENVOYÉE
Si elle réussit, getauxval() renvoie la valeur correspondant au type. Si type n'est pas
trouvé, 0 est renvoyé.
ERREURS
Aucune erreur n'est diagnostiquée.
VERSIONS
La fonction getauxval() est disponible depuis la glibc 2.16.
ATTRIBUTS
Multithreading (voir pthreads(7)) La fonction getauxval() est sûre dans un contexte multithread.
CONFORMITÉ
Cette fonction est une extension non normalisée de la glibc.
NOTES
Le principal utilisateur des renseignements du vecteur auxiliaire est l'éditeur de liens
dynamique ld-linux.so(8). Le vecteur auxiliaire est un raccourci pratique et efficace qui
permet au noyau de communiquer un certain jeu de renseignements standards dont l'éditeur
de liens a souvent ou toujours besoin. Dans certains cas, les mêmes renseignements
pourraient être obtenus à l'aide d'appels système, mais l'utilisation du vecteur
auxiliaire est moins coûteuse.
Le vecteur auxiliaire réside juste au-dessus de la liste d'arguments et de l'environnement
dans l'espace d'adresse du processus. Le vecteur auxiliaire fourni à un programme peut
être affiché en définissant la variable d'environnement LD_SHOW_AUXV lors de l'exécution
d'un programme :
$ LD_SHOW_AUXV=1 sleep 1
Le vecteur auxiliaire de n'importe quel processus peut (en fonction des droits du fichier)
être obtenu dans /proc/PID/auxv. Consultez proc(5) pour obtenir de plus amples
renseignements.
VOIR AUSSI
secure_getenv(3), vdso(7), ld-linux.so(8)
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/>.
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> ».