Sous-routine pthread_condattr_setpshared

Editer en ligne

Objectif

Définit la valeur de l'attribut pshared d'un objet d'attributs de condition.

Bibliothèque

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

Syntaxe

#include <pthread.h>

int pthread_condattr_setpshared (attr, pshared)
pthread_condattr_t *attr;
int pshared;

Descriptif

La sous-routine pthread_condattr_setpshared définit la valeur de l'attribut pshared de l'objet d'attributs de condition attr. Cet attribut indique le partage de processus de la variable de condition créée avec cet objet d'attributs.

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
attr Indique l'objet d'attributs de condition.
pshared Indique le partage de processus à définir. Elle doit avoir l'une des valeurs suivantes:
PTHREAD_PROCESS_SHARED
Indique que la variable de condition peut être utilisée par toute unité d'exécution ayant accès à la mémoire dans laquelle elle est allouée, même si ces unités d'exécution appartiennent à des processus différents.
PTHREAD_PROCESS_PRIVATE
Indique que la variable de condition ne doit être utilisée que par les unités d'exécution du même processus que l'unité d'exécution qui l'a créée. Il s'agit de la valeur par défaut.

Valeurs renvoyées

Une fois l'opération terminée, la valeur 0 est renvoyée. Sinon, un code d'erreur est renvoyé.

Codes d'erreur

La sous-routine pthread_condattr_setpshared échoue si la condition suivante est vérifiée:

Article Descriptif
EINVAL Les paramètres attr ou pshared ne sont pas valides.