NOM¶
sem_init - Initialiser un sémaphore non nommé
SYNOPSIS¶
#include <semaphore.h>
int sem_init(sem_t *sem, int pshared, unsigned int value);
Effectuez l'édition des liens avec l'option
-pthread.
DESCRIPTION¶
sem_init() initialise le sémaphore non nommé situé
à l'adresse pointée par
sem. L'argument
value
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 fils créé avec
fork(2)
hérite de la projection mémoire du père, 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.
VALEUR RENVOYÉE¶
sem_init() renvoie 0 s'il réussit. S'il échoue, il renvoie
-1 et écrit
errno en conséquence.
ERREURS¶
- EINVAL
- value est plus grand que SEM_VALUE_MAX.
- ENOSYS
- pshared n'est pas nul, mais le système ne supporte pas les
sémaphores partagés entre processus (consultez
sem_overview(7)).
ATTRIBUTS¶
Multithreading (voir pthreads(7))¶
La fonction
sem_init() est sûre dans un contexte multithread.
POSIX.1-2001.
NOTES¶
Bizarrement, POSIX.1-2001 ne spécifie pas la valeur que devrait retourner
un appel réussi à
sem_init(). POSIX.1-2008 corrige ceci
et spécifie une valeur de retour nulle en cas de succès.
VOIR AUSSI¶
sem_destroy(3),
sem_post(3),
sem_wait(3),
sem_overview(7)
COLOPHON¶
Cette page fait partie de la publication 3.65 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Alain Portal <
http://manpagesfr.free.fr/> (2006). Nicolas
François et l'équipe francophone de traduction de
Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande «
man -L C
<section>
<page_de_man> ».