sem_init - Initialiser un sémaphore non nommé
Bibliothèque de threads POSIX (
libpthread,
-lpthread)
#include <semaphore.h>
int sem_init(sem_t *sem, int pshared, unsigned int valeur);
sem_init() initialise le sémaphore non nommé situé
à l'adresse pointée par
sem. L'argument
valeur
spécifie la valeur initiale du sémaphore.
L'argument
pshared indique si ce sémaphore sera partagé
entre les threads d'un processus ou entre processus.
Si
pshared vaut
0, le sémaphore est partagé
entre les threads d'un processus et devrait être situé à
une adresse visible par tous les threads (par exemple, une variable globale ou
une variable allouée dynamiquement dans le tas).
Si
pshared n'est pas nul, le sémaphore est partagé entre
processus et devrait être situé dans une région de
mémoire partagée (consultez
shm_open(3),
mmap(2)
et
shmget(2)) (puisqu'un enfant créé avec
fork(2)
hérite de la projection mémoire du parent, il peut
accéder au sémaphore). Tout processus qui peut accéder
à la région de mémoire partagée peut opérer
sur le sémaphore avec
sem_post(3),
sem_wait(3), etc.
L'initialisation d'un sémaphore qui a déjà
été initialisé résulte en un comportement
indéfini.
sem_init() renvoie
0 s'il réussit. S'il échoue, il
renvoie
-1 et écrit
errno en conséquence.
- EINVAL
-
valeur est plus grand que SEM_VALUE_MAX.
- ENOSYS
-
pshared n'est pas nul, mais le système ne
gère pas les sémaphores partagés entre processus
(consultez sem_overview(7)).
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
sem_init() |
Sécurité des threads |
MT-Safe |
POSIX.1-2001.
Bizarrement, POSIX.1-2001 ne spécifie pas la valeur que devrait renvoyer
un appel réussi à
sem_init(). POSIX.1-2008 corrige cela
et spécifie une valeur de retour nulle en cas de succès.
Consultez
shm_open(3) et
sem_wait(3).
sem_destroy(3),
sem_post(3),
sem_wait(3),
sem_overview(7)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Thomas Vincent <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]