SEM_GETVALUE(3)

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.

ATTRIBUTS

  Multithreading (voir pthreads(7))
La fonction sem_getvalue() est sûre dans un contexte multithread.

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.70 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> ».