Scroll to navigation

SEM_GETVALUE(3) Manuel du programmeur Linux 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

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

13 mai 2012 Linux