sem_getvalue − Obtenir la valeur d’un sémaphore.

#include <semaphore.h>

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

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.

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

EINVAL

sem n’est pas un sémaphore valide.

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

POSIX.1-2001.

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

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

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=en man 3 sem_getvalue ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.