sigwait

Table des matières
Retour à l'index

 

NOM

sigwait - Attendre un signal  

BIBLIOTHÈQUE

Bibliothèque C standard (libc, -lc)  

SYNOPSIS

#include <signal.h>

int sigwait(const sigset_t *restrict set, int *restrict sig);

Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

sigwait() :

    Depuis la glibc 2.26 :
        _POSIX_C_SOURCE >= 199506L
    glibc 2.25 et antérieures :
        _POSIX_C_SOURCE
 

DESCRIPTION

La fonction sigwait() suspend l'exécution du thread appelant jusqu'à ce que l'un des signaux indiqués dans l'ensemble de signaux set soit en attente. Pour qu'un signal se mette en attente, il doit d'abord être bloqué par sigprocmask(2). La fonction accepte le signal (le supprime de la liste des signaux en attente), et retourne le numéro du signal dans sig.

L'action de sigwait() est identique à celle de sigwaitinfo(2), excepté que :

-
sigwait() ne retourne que le numéro du signal et pas la structure siginfo_t décrivant le signal.
-
Les valeurs de retour des deux fonctions sont différentes.
 

VALEUR RENVOYÉE

Si elle réussit, sigwait() renvoie 0. Si elle échoue, elle renvoie un code d'erreur strictement positif (listé dans ERREURS).  

ERREURS

EINVAL
set ne contient pas de numéro de signal valide.
 

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).
InterfaceAttributValeur
sigwait() Sécurité des threadsMT-Safe
 

VERSIONS

sigwait() est implémentée autour de sigtimedwait(2) ; consultez ses NOTES.

L'implémentation de sigwait() de la glibc ignore silencieusement les tentatives d'attendre les deux signaux en temps réel utilisés en interne par l'implémentation du threading NPTL. Consultez nptl(7) pour des détails.  

STANDARDS

POSIX.1-2008.  

HISTORIQUE

POSIX.1-2001.  

EXEMPLES

Consultez pthread_sigmask(3).  

VOIR AUSSI

sigaction(2), signalfd(2), sigpending(2), sigsuspend(2), sigwaitinfo(2), sigsetops(3), signal(7)

 

TRADUCTION

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


 

Index

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
ATTRIBUTS
VERSIONS
STANDARDS
HISTORIQUE
EXEMPLES
VOIR AUSSI
TRADUCTION

This document was created by man2html, using the manual pages.
Time: 05:06:26 GMT, September 19, 2025