Loading

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 -lrt ou -pthread.

       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  (voir
       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 (voir sem_overview(7)).

CONFORMITÉ

       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.23  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

       Cette  page  de  manuel  a  été  traduite  par Alain Portal <aportal AT
       univ-montp2  DOT   fr>   en   2006,   et   mise   à   disposition   sur
       http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement         gérées         par         Nicolas         François
       <nicolas.francois@centraliens.net>    et    l’équipe   francophone   de
       traduction de Debian.

       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> ».