Linux Certif

Toute la documentation sur la certification Linux LPI

sem_getvalue

NOM

sem_getvalue - Obtenir la valeur d'un sémaphore

SYNOPSIS

 #include <semaphore.h>
 
 int sem_getvalue(sem_t *sem, int *sval);
 

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)

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 26 novembre 2007.

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.