Provided by: manpages-fr-dev_3.57d1p1-1_all bug

NOM

       semget - Obtenir l'identifiant d'un ensemble de sémaphores System V

SYNOPSIS

       #include <sys/types.h>
       #include <sys/ipc.h>
       #include <sys/sem.h>

       int semget(key_t key, int nsems, int semflg);

DESCRIPTION

       L'appel  système  semget()  renvoie  l'identifiant  de  l'ensemble  de sémaphores System V
       associé à la valeur de clé key. Un nouvel ensemble contenant nsems sémaphores est créé  si
       key  a  la  valeur  IPC_PRIVATE  ou  si aucun ensemble n'est associé à key, et si l'option
       IPC_CREAT est présente dans semflg.

       Si semflg contient à la fois IPC_CREAT et IPC_EXCL et qu'un ensemble de sémaphores  existe
       déjà  pour  la clé key, semget() échoue et errno vaut EEXIST. (Ceci est analogue à l'effet
       de la combinaison O_CREAT | O_EXCL pour open(2).)

       Pendant la création, les 9 bits de poids faibles  de  l'argument  semflg  définissent  les
       permissions  d'accès (pour le propriétaire, le groupe et les autres) au jeu de sémaphores,
       en utilisant le même format et la même signification que les droits d'accès dans  open(2).
       Les  permissions  d'exécution  ne  sont  pas  utilisées  par le système, et pour un jeu de
       sémaphores, l'autorisation d'écriture signifie autorisation de modification.

       Les valeurs des sémaphores dans un ensemble  qui  vient  d'être  créé  sont  indéterminées
       (POSIX.1-2001  est  explicite  sur  ce  point).  Même si Linux, comme de nombreuses autres
       implémentations, initialise les valeurs des sémaphores à 0, une  application  portable  ne
       peut  pas  compter  sur  cette  initialisation :  elle  doit initialiser explicitement les
       sémaphores à la valeur souhaitée.

       Durant la création, la structure de données semid_ds (consultez semctl(2))  contrôlant  le
       jeu de sémaphores est initialisée ainsi par semget() :

              sem_perm.cuid et sem_perm.uid contiennent l'UID effectif du processus appelant.

              sem_perm.cgid et sem_perm.gid contiennent le GID effectif du processus appelant.

              Les  9  bits  de  poids  faibles  de  sem_perm.mode contiennent les 9 bits de poids
              faibles de semflg.

              sem_nsems reçoit la valeur nsems.

              sem_otime est mis à 0.

              sem_ctime est rempli avec l'heure actuelle.

       L'argument nsems peut valoir  0  (ignore)  si  l'appel  système  n'est  pas  une  création
       d'ensemble  de sémaphores. Autrement nsems doit être supérieur à 0 et inférieur ou égal au
       nombre maximal de sémaphores par ensemble (SEMMSL).

       Si le jeu de sémaphores existe déjà, les permissions d'accès sont contrôlées.

VALEUR RENVOYÉE

       Si l'appel réussit, il renvoie l'identifiant de l'ensemble (un entier positif),  sinon  il
       renvoie -1 et errno contient le code d'erreur.

ERREURS

       En cas d'erreur, errno prend l'une des valeurs suivantes :

       EACCES Le jeu de sémaphore associé à key existe, mais le processus n'a aucun droit d'accès
              sur lui et n'a pas la capacité CAP_IPC_OWNER.

       EEXIST Le jeu de sémaphore associé a key existe mais l'argument semflg précise à  la  fois
              IPC_CREAT et IPC_EXCL.

       EINVAL nsems est inférieur à zéro ou supérieur à la limite sur le nombre de sémaphores par
              ensemble, (SEMMSL), ou l'ensemble de sémaphores identifié par key existe  déjà,  et
              nsems est plus grand que le nombre de sémaphores par ensemble.

       ENOENT Aucun  jeu  de sémaphore associé a key n'existe et l'argument semflg ne précise pas
              IPC_CREAT.

       ENOMEM Pas assez de mémoire pour créer les structures nécessaires.

       ENOSPC Le nombre maximal de jeux de sémaphores sur le système (SEMMNI) est atteint, ou  le
              nombre maximal de sémaphores sur le système est atteint (SEMMNS).

CONFORMITÉ

       SVr4, POSIX.1-2001.

NOTES

       L'inclusion  de  <sys/types.h>  et  <sys/ipc.h>  n'est  pas nécessaire sous Linux et n'est
       exigée par  aucune  version  de  POSIX.  Cependant,  certaines  implémentations  anciennes
       nécessitent  l'inclusion  de  ces  fichiers  d'en-tête,  et  le  SVID documente aussi leur
       inclusion. Les applications  ayant  pour  but  d'être  portables  pourraient  inclure  ces
       fichiers d'en-tête.

       IPC_PRIVATE  n'est  pas  une  option,  mais  un objet de type key_t. Si l'on utilise cette
       valeur spéciale dans l'argument key, l'appel système ne se préoccupera que des 9  bits  de
       poids faibles de semflg et tentera de créer un nouveau jeu de sémaphores.

       Les limites suivantes concernent l'appel système semget() :

       SEMMNI Nombre  maximal de jeux de sémaphores sur le système : dépend de la politique (sous
              Linux, cette  limite  peut  être  lue  et  modifiée  dans  le  quatrième  champ  de
              /proc/sys/kernel/sem).

       SEMMSL Nombre  maximal  de  sémaphores  par ensemble : dépendant de l'implémentation (sous
              Linux,  cette  limite  peut  être  lue  et  modifiée  dans  le  premier  champ   de
              /proc/sys/kernel/sem).

       SEMMNS Nombre  maximal  de sémaphores sur le système : dépend de la politique (sous Linux,
              cette  limite   peut   être   lue   et   modifiée   dans   le   second   champ   de
              /proc/sys/kernel/sem). Les valeurs supérieures à SEMMSL * SEMMNI sont incorrectes.

BOGUES

       Le choix du nom IPC_PRIVATE est malheureux, IPC_NEW aurait mieux décrit sa fonction.

       Les sémaphores dans un ensemble ne sont pas initialisés par semget(). Pour initialiser les
       sémaphores, il faut utiliser semctl(2) pour effectuer une opération SETVAL ou  SETALL  sur
       l'ensemble  de  sémaphores.  (Lorsque  plusieurs  pairs  ne savent pas lequel initialisera
       l'ensemble en premier, un test pour une valeur non nulle de sem_otime dans la structure de
       données  associée  renvoyée  par l'opération IPC_STAT de semctl(2) peut être utilisée pour
       éviter les problèmes d'accès concurrents.)

VOIR AUSSI

       semctl(2), semop(2), ftok(3), capabilities(7), sem_overview(7), svipc(7)

COLOPHON

       Cette page fait partie de la publication 3.57 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/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  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> ».