Sous-routine pthread_condattr_getpshared
Objectif
Renvoie 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_getpshared (attr, pshared)
const pthread_condattr_t *attr;
int *pshared;Descriptif
La sous-routine pthread_condattr_getpshared renvoie la valeur de l'attribut pshared de l'objet d'attribut de condition attr. Cet attribut indique le partage de processus de la variable de condition créée avec cet objet d'attributs. Il peut avoir l'une des valeurs suivantes:
| Article | Descriptif |
|---|---|
| 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. |
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 l'emplacement de stockage de la valeur d'attribut pshared. |
Valeurs renvoyées
Une fois l'opération terminée, la valeur de l'attribut pshared est renvoyée via le paramètre pshared et la valeur 0 est renvoyée. Sinon, un code d'erreur est renvoyé.
Codes d'erreur
La sous-routine pthread_condattr_getpshared échoue si la condition suivante est vérifiée:
| Article | Descriptif |
|---|---|
| EINVAL | Le paramètre attr n'est pas valide. |
| ENOSYS | L'option de partage de processus POSIX n'est pas implémentée. |