NOM

       get_robust_list, set_robust_list - Lire et écrire une liste de futex robustes

SYNOPSIS

       #include <linux/futex.h>
       #include <syscall.h>

       long get_robust_list(int pid, struct robust_list_head **head_ptr,
                            size_t *len_ptr);
       long set_robust_list(struct robust_list_head *head, size_t len);

       Remarque : il n'existe pas de fonctions glibc autour de ces appels système ; consultez NOTES.

DESCRIPTION

       L'implémentation  de  futex  robuste  doit  maintenir  les  listes  par thread de futex robustes qui sont
       déverrouillés quand le thread se termine. Ces listes sont gérées en espace utilisateur ; le  noyau  n'est
       notifié que de l'emplacement de la tête de la liste.

       L'appel  système  get_robust_list()  renvoie  la  tête  de  la  liste  de  futex  robustes du thread dont
       l'identifiant de thread est indiqué par pid. Si pid est 0, la tête de liste pour le thread  appelant  est
       renvoyée. La tête de liste est conservée à l'emplacement pointé par head_ptr. La taille de l'objet pointé
       par **head_ptr est conservée dans len_ptr.

       L'appel système set_robust_list() demande au noyau d'enregistrer la tête de la liste  de  futex  robustes
       appartenant  au  thread  appelant.  L'argument  head  est  la tête de liste à enregistrer. L'argument len
       devrait être sizeof(*head).

VALEUR RENVOYÉE

       Les appels systèmes set_robust_list() et get_robust_list() renvoient zéro quand l'opération a réussi,  et
       un code d'erreur sinon.

ERREURS

       L'appel système set_robust_list() peut échouer avec l'erreur suivante.

       EINVAL len ne correspond pas à la taille de structure struct robust_list_head attendue par le noyau.

       L'appel système get_robust_list() peut échouer avec les erreurs suivantes.

       EPERM  Le  processus  appelant  n'a  pas  le  droit  de  voir  la  liste de futex robustes du thread avec
              l'identifiant de thread pid, et n'a pas la capacité CAP_SYS_PTRACE.

       ESRCH  Aucun thread avec pour identifiant de thread pid n'a pu être trouvé.

       EFAULT La tête de la liste de futex robustes ne peut pas être conservée à l'emplacement head.

VERSIONS

       Ces appels système ont été ajoutés à Linux 2.6.17. Aucune bibliothèque n'existe pour les gérer,  utilisez
       syscall(2).

NOTES

       Ces  appels  système  ne sont pas nécessaires aux applications normales. La glibc ne les gère pas. Au cas
       improbable où vous voudriez les appeler directement, utilisez syscall(2).

       Un thread ne peut avoir qu'une seule liste de  futex  robustes.  Par  conséquent,  les  applications  qui
       désirent utiliser cette fonctionnalité devraient utiliser les mutex robustes fournis par la glibc.

VOIR AUSSI

       futex(2)

       Documentation/robust-futexes.txt et Documentation/robust-futex-ABI.txt dans l'arborescence des sources du
       noyau Linux

COLOPHON

       Cette page fait partie de la publication 3.57 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> ».