#include <signal.h> int sigwaitinfo(const sigset_t *restrict set, siginfo_t *_Nullable restrict info); int sigtimedwait(const sigset_t *restrict set, siginfo_t *_Nullable restrict info, const struct timespec *restrict timeout);
Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :
sigwaitinfo(), sigtimedwait() :
_POSIX_C_SOURCE >= 199309L
sigwaitinfo() retire le signal de l'ensemble des signaux en attente, et renvoie le numéro du signal comme valeur de retour. Si l'argument info n'est pas NULL, alors le tampon vers lequel il pointe est utilisé pour renvoyer une structure du type siginfo_t (consultez sigaction(2)) contenant les informations concernant le signal.
Si plusieurs signaux de l'ensemble sont mis en attente pour l'appelant, le signal récupéré sigwaitinfo() est déterminé par les règles de classement habituelles. Consultez signal(7) pour plus de détails.
sigtimedwait() opère exactement comme sigwaitinfo(), mais elle a un argument supplémentaire, délai, qui permet de définir le temps pendant lequel le thread est suspendu dans l'attente d'un signal. (Cet intervalle de temps est arrondi à la granularité de l'horloge système et cet intervalle peut être modifié légèrement à cause des délais d'ordonnancement du noyau.) Cet argument est une structure timespec(3).
Si les deux champs de cette structure sont nuls, sigtimedwait() revient tout de suite, soit avec des informations sur un signal déjà en attente, soit avec une erreur si aucun signaux de l'ensemble n'étaient disponibles.
L'ensemble des signaux qui sont en attente pour un thread donné est l'union de l'ensemble des signaux spécifiquement en attente pour ce thread et de l'ensemble des signaux en attente pour le processus lui-même (consultez signal(7)).
Les tentatives pour attendre SIGKILL or SIGSTOP seront ignorées silencieusement.
Si plusieurs threads d'un processus sont bloqués dans sigwaitinfo() ou sigtimedwait() en attente du ou des mêmes signaux, un seul des threads recevra réellement le signal s'il est mis en attente pour le processus (dans son ensemble) ; on ne peut pas savoir quel thread recevra le signal.
sigwaitinfo() ou sigtimedwait() ne peuvent pas être utilisés pour recevoir des signaux générés de manière synchronisée, tels que le signal SIGSEGV qui provient d'un accès non valable à l'adresse mémoire ou SIGFPE qui fait suite à une erreur arithmétique. De tels signaux ne peuvent être récupérés qu'à l'aide d'un gestionnaire de signal.
POSIX ne spécifie pas le comportement si une valeur NULL est indiquée pour l'argument délai de sigtimedwait(), permettant par exemple d'avoir le même comportement que celui de sigwaitinfo(), ce qui est le cas sous Linux.
Les fonctions enveloppes sigwaitinfo() et sigtimedwait() de la glibc ignorent silencieusement les tentatives pour attendre les deux signaux en temps réel utilisés en interne par l'implémentation de threading de NPTL. Consultez nptl(7) pour les détails.
L'appel système Linux d'origine s'appelait sigtimedwait(). Toutefois, avec l'arrivée des signaux en temps réel dans Linux 2.2 et de la taille figée, le type sigset_t 32 bits pris en charge par cet appel système ne convenait plus à cet objectif. Par conséquent, un nouvel appel système rt_sigtimedwait() a été ajouté pour prendre en charge le type sigset_t élargi. Le nouvel appel système prend un quatrième paramètre, size_t sigsetsize, qui indique la taille en octets des jeux de signal dans l'ensemble. Ce paramètre est actuellement nécessaire pour obtenir la valeur sizeof(sigset_t) (ou le résultat de l'erreur EINVAL). La fonction enveloppe sigtimedwait() de la glibc nous cache ces détails en appelant de manière transparente rt_sigtimedwait() quand le noyau le fournit.
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 à