pthread_atfork(3)

NOM
pthread_atfork — Enregistrer des gestionnaires d'appel à fork

BIBLIOTHÈQUE
Bibliothèque de threads POSIX (libpthread, -lpthread)

SYNOPSIS
#include <pthread.h>

int pthread_atfork(void (*prepare)(void), void (*parent)(void),
                   void (*child)(void));

DESCRIPTION
Le fonction pthread_atfork() enregistre les gestionnaires de fork qui doivent être exécutés quand fork(2) est appelé par un des threads d'un processus. Les gestionnaires sont exécutés dans le contexte du thread qui appelle fork(2).

Trois types de gestionnaires peuvent être enregistrés :

-   prepare spécifie un gestionnaire qui est exécuté dans le processus parent avant le début du traitement de fork(2).

-   parent spécifie un gestionnaire qui est exécuté dans le processus parent après l'achèvement du traitement de fork(2).

-   child spécifie un gestionnaire qui est exécuté dans le processus enfant après l'achèvement du traitement de fork(2).

N'importe lequel des trois arguments peut être NULL si aucun gestionnaire n'est nécessaire dans la phase correspondante du traitement de fork(2).

VALEUR RENVOYÉE
pthread_atfork() renvoie zéro en cas de succès. En cas d'erreur, elle renvoie un numéro d'erreur. pthread_atfork peut être appelée plusieurs fois par un processus pour enregistrer des gestionnaires supplémentaires. Les gestionnaires de chaque phase sont appelés dans un ordre spécifié : les gestionnaires prepare sont appelés en ordre inverse d'enregistrement, les gestionnaires parent et child sont appelés dans l'ordre d'enregistrement.

ERREURS

ENOMEM
    Impossible d'allouer assez de mémoire pour enregistrer l'entrée de liste de gestionnaires de fork.

STANDARDS
POSIX.1-2008.

HISTORIQUE
POSIX.1-2001.

NOTES
Quand fork(2) est appelé dans processus multithreadé, seul le thread appelant est dupliqué dans le processus enfant. L'objectif originel de pthread_atfork() était de permettre de renvoyer le processus enfant dans un état cohérent. Par exemple, au moment de l'appel de fork(2), d'autres threads peuvent avoir verrouillé des mutex qui sont visibles dans la mémoirede l'espace utilisateur dupliquée dans l'enfant. Ce type de mutex ne devrait jamais être déverrouillé dans la mesure où les threads qui ont placé les verrous ne sont pas dupliqués dans l'enfant. L'intention de pthread_atfork() était de fournir un mécanisme selon lequel l'application (ou une bibliothèque) pouvait assurer que les mutex et autres états de processus et de thread soient restaurés dans un état cohérent. En pratique, cette tâche est en général trop difficile pour être réalisable.

Après qu'un fork(2) dans un processus multithreadé retourne dans l'enfant, l'enfant peut seulement appeler des fonctions sûres du point de vue des signaux asynchrones (consultez signal-safety(7)) jusqu'au moment où il appelle execve(2) pour exécuter un nouveau programme.

POSIX.1 spécifie que pthread_atfork() ne pourra échouer avec l'erreur EINTR.

VOIR AUSSI
fork(2), atexit(3), pthreads(7)

TRADUCTION
La traduction française de cette page de manuel a été créée par Alain Portal <aportal@univ-montp2.fr>, Christophe Blaess <https://www.blaess.fr/christophe/>, David Prévot <david@tilapin.org>, Denis Barbier <barbier@debian.org>, Florentin Duneau <fduneau@gmail.com>, François Micaux, Frédéric Hantrais <fhantrais@gmail.com>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Julien Cristau <jcristau@debian.org>, Nicolas François <nicolas.francois@centraliens.net>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Thomas Blein <tblein@tblein.eu>, Thomas Huriaux <thomas.huriaux@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à 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 RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.