SEM_GETVALUE

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 25 mars 2006
Index Menu principal

NOM

sem_getvalue - Obtenir la valeur d'un sémaphore

SYNOPSIS

#include <semaphore.h>

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

Utilisez -lrt ou -pthread à l'édition de liens.

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 si elle réussit. Si elle échoue, elle 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)

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 29 juillet 2006 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 sem_getvalue ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008