Sous-routine pthread_kill

Editer en ligne

Objectif

Envoie un signal à l'unité d'exécution spécifiée.

Bibliothèque

Bibliothèque d'unités d'exécution (libpthreads.a)

Syntaxe

#include <signal.h>

int pthread_kill (thread, signal)
pthread_t thread;
int signal;

Descriptif

La sous-routine pthread_kill envoie le signal signal à l'unité d'exécution thread. Il agit avec des unités d'exécution telles que la sous-routine kill avec des processus à unité d'exécution unique.

Si l'unité d'exécution réceptrice a bloqué la délivrance du signal, le signal reste en attente sur l'unité d'exécution jusqu'à ce que l'unité d'exécution débloque la délivrance du signal ou que l'action associée au signal soit réglée pour ignorer le signal.

Remarque: Le fichier d'en-tête pthread.h doit être le premier fichier inclus de chaque fichier source utilisant la bibliothèque d'unités d'exécution. Sinon, l'indicateur de compilation -D_THREAD_SAFE doit être utilisé ou le compilateur cc_r doit être utilisé. Dans ce cas, l'indicateur est automatiquement défini.

Paramètres

Article Descriptif
unité d"exécution Indique l'unité d'exécution cible du signal.
SIGNAL Indique le signal à distribuer. Si la valeur du signal est 0, un contrôle d'erreur est effectué, mais aucun signal n'est délivré.

Valeurs renvoyées

Une fois terminée, la fonction renvoie la valeur zéro. Sinon, la fonction renvoie un numéro d'erreur. Si la fonction pthread_kill échoue, aucun signal n'est envoyé.

Codes d'erreur

La fonction pthread_kill échoue si:

Article Descriptif
ESRCH Aucune unité d'exécution correspondant à celle spécifiée par l'ID d'unité d'exécution indiqué n'a été trouvée.
EINVAL La valeur du paramètre signal est un numéro de signal non valide ou non pris en charge.

La fonction pthread_kill ne renvoie pas le code d'erreur EINTR.