Sous-routine thread_post

Objectif

Envoie une unité d'exécution d'une fin d'événement.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <sys/thread.h>

int thread_post( tid)
tid_t  tid;

Descriptif

La sous-routine Poste_tarau_exécution affiche l'unité d'exécution dont l'ID unité d'exécution est indiqué par la valeur du paramètre D de l'occurrence d'un événement. Si l'unité d'exécution affichée est en attente dans Atte_tarau_exécution, elle sera réveillée immédiatement. S'il n'est pas en attente dans Atte_tarau_exécution, l'appel suivant à Atte_tarau_exécution ne bloque pas mais revient immédiatement avec succès.

De multiples messages à la même unité d'exécution sans attendre d'une attente de l'unité d'exécution spécifiée ne compteront que comme un seul poste. L'affichage reste en vigueur jusqu'à ce que l'unité d'exécution indiquée appelle la sous-routine Atte_tarau_exécution sur laquelle l'affichage est supprimé.

Les applications Atte_tarau_exécution et Poste_tarau_exécution peuvent être utilisées par les applications pour implémenter un mécanisme IPC rapide entre des unités d'exécution dans différents processus.

Paramètres

Article Descriptif
ID d'unité d'exécution Indique l'ID unité d'exécution de l'unité d'exécution à afficher.

Valeurs renvoyées

Une fois l'exécution terminée, la sous-routine Poste_tarau_exécution renvoie une valeur de 0. En cas d'échec, une valeur de -1 est renvoyée et la variable globale Errno est définie pour indiquer l'erreur.

Codes d'erreur

Article Descriptif
ESRCH Cette unité d'exécution est inexistante ou l'unité d'exécution a quitté ou est sortie.
EPERM L'ID utilisateur réel ou effectif ne correspond pas à l'ID utilisateur réel ou effectif de l'unité d'exécution en cours de publication, sinon le processus appelant ne dispose pas des droits utilisateur root.