NOM¶

sem_getvalue - Obtenir la valeur d'un sémaphore

SYNOPSIS¶

#include <semaphore.h>

int sem_getvalue(sem_t *sem, int *sval);

Effectuez l'édition des liens avec l'option -pthread.

DESCRIPTION¶

sem_getvalue() place la valeur actuelle du sémaphore pointé par sem dans l'entier pointé par sval.

Si un ou plusieurs processus ou threads sont bloqués en attente de verrouiller le sémaphore avec sem_wait(3), POSIX.1-2001 permet deux valeurs de retour possibles pour sval : soit 0 est renvoyé, soit une valeur négative dont la valeur absolue est le nombre de processus et de threads actuellement bloqués dans sem_wait(3). Linux adopte le premier comportement.

VALEUR RENVOYÉE¶

sem_getvalue() renvoie 0 s'il réussit. S'il échoue, il renvoie -1 et écrit errno en conséquence.

ERREURS¶

EINVAL

sem n'est pas un sémaphore valide.

CONFORMITɶ

POSIX.1-2001.

NOTES¶

La valeur du sémaphore peut déjà être modifiée le temps que sem_getvalue() revienne.

VOIR AUSSI¶

sem_post(3), sem_wait(3), sem_overview(7)

COLOPHON¶

Cette page fait partie de la publication 3.52 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION¶

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Alain Portal <http://manpagesfr.free.fr/> (2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».