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);

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.