sem_init   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 25 mars 2006
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
sem_init - Initialiser un sémaphore non-nommé  



SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
#include <semaphore.h>

int sem_init(sem_t *sem, int pshared, unsigned int value);

Liez avec -lrt ou -pthread.  




DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
sem_init() renvoie 0 si elle réussit. Si elle échoue, elle renvoie -1 et écrit errno en conséquence.  



ERREURS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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É   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
POSIX.1-2001.  



NOTES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Bizaremment, POSIX.1-2001 ne spécifie pas la valeur que devrait retourner un appel réussi à sem_init(). Toutefois, virtuellement toutes les implémentations renvoient 0 dans ce cas.  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
sem_destroy(3), sem_post(3), sem_wait(3), sem_overview(7)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

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 6 juin 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_init ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
EINVALERREURS
ENOSYSERREURS



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:51:20, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional