.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Traduction 15/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.\" Mise a jour 18/05/99 - LDP-man-pages-1.23
.TH SEMGET 2 "18 Mai 1999" Linux "Manuel du programmeur Linux"
.SH NOM
semget \- Obtenir l'identificateur d'un ensemble de smaphores.
.SH SYNOPSIS
.nf
.B
# include <sys/types.h>
.B
# include <sys/ipc.h>
.B
# include <sys/sem.h>
.fi
.sp
.BI "int semget ( key_t " key ,
.BI "int " nsems ,
.BI "int " semflg " )"
.SH DESCRIPTION
Cette fonction retourne l'identificateur de l'ensemble de 
smaphores associ  la valeur cle
.IR key .
Un nouvel ensemble contenant
.I nsems
smaphores est cr si 
.I key
a la valeur
.B IPC_PRIVATE
ou si aucun ensemble n'est associ 
.IR key ,
et si l'option
.B IPC_CREAT
est prsente dans
.I semflg.
(i.e.
.IR semflg " &"
.B IPC_CREAT
diffrent de zro).

La prsence de
.B IPC_CREAT
et
.B IPC_EXCL
dans le champ
.I semflg
joue le mme rle, par rapport  l'existence du
jeu de smaphores, que la prsence de
.B O_CREAT
et
.B O_EXCL
dans l'argument de mode de l'appel systme
.BR open (2)
i.e. la fonction
.B semget
chouera si
.I semflg
demande  la fois
.B IPC_CREAT
et
.B IPC_EXCL
et si un smaphore associ a
.I key 
existe dj.
.PP
Pendant la cration, les 9 bits de poids faibles de
l'argument
.I semflg
dfinissent les permissions d'accs (pour le propritaire,
le groupe et les autres) au jeu de smaphores, en utilisant
le mme format et la mme signification  que les droits
d'accs dans
.BR open (2)
ou
.BR creat (2).

Les permissions d'excutions ne sont pas utilises par le systme, et
pour un jeu de smaphores, l'autorisation d'criture signifie
autorisation de modification.
.PP
Durant la cration, la structure de donnes
.B semid_ds
contrlant le jeu de smaphores est initialise ainsi :
.IP
.B sem_perm.cuid
et
.B sem_perm.uid
contiennent l'UID effectif du processus appelant.
.IP
.B sem_perm.cgid
et
.B sem_perm.gid
contiennent le GID effectif du processus appelant.
.IP
le 9 bits de poids faibles de
.B sem_perm.mode
sont remplis avec les 9 bits de poids faibles de
.IR semflg .
.IP
.B sem_nsems
reoit la valeur
.IR nsems .
.IP
.B sem_otime
est mis a 0.
.IP
.B sem_ctime
est rempli avec l'heure actuelle.
.PP
l'argument
.I nsems
peut valoir
.B 0
(ignore)
si l'appel systme n'est pas une cration d'ensemble de smaphores.
Autrement
.I nsems
doit tre suprieur 
.B 0
et infrieur ou gal au nombre maximal de smaphores par ensemble,
.RB ( SEMMSL ).
.PP
Si le jeu de smaphores existe dj, les permissions d'accs sont
contrles, et l'on vrifie si l'ensemble est sur le point
d'tre dtruit.
.SH "VALEUR RENVOYE"
Si l'appel reussit, il renvoie l'identificateur de l'ensemble (un
entier positif), sinon il renvoie
.B \-1
et
.B errno
contient le code d'erreur.
.SH ERREURS
.TP 11
.B Eaccs
Le jeu de smaphore associ 
.IR key 
existe, mais le processus n'a aucun droit d'accs sur lui
.TP
.B EEXIST
Le jeu de smaphore associ a
.B key
existe mais l'argument
.I semflg
precise  la fois
.B IPC_CREAT
et
.BR IPC_EXCL .
.TP
.B EIDRM
le jeu de smaphores est prt  tre dtruit
.TP
.B ENOENT
Aucun jeu de smaphore associ a
.I key
n'existe
et l'argument
.I semflg
ne prcise pas
.BR IPC_CREAT .
.TP
.B ENOMEM
Pas assez de mmoire pour crer les structures ncessaires.
.TP
.B ENOSPC
Le nombre maximal de jeux de smaphores sur le systme
.RB ( SEMMNI )
est atteint,
ou le nombre maximal de smaphores sur le systme est atteint
.RB ( SEMMNS ).
.SH NOTES
.B IPC_PRIVATE
n'est pas une option, mais un objet de type
.BR key_t .
Si l'on utilise cette valeur spciale dans l'argument
.IR key ,
l'appel systme ne se proccupera que des 9 bits de poids
faibles de
.I semflg
et tentera de crer un nouveau jeu de smaphores.
.PP
Les limites suivantes concernent l'appel systme
.B semget :
.TP 11
.B SEMMNI
Nombre maximal d'ensembles de smaphores sur le systme.
.TP
.B SEMMSL
Nombre maximal de smaphores par ensemble.
.TP
.B SEMMNS
Nombre maximal de smaphores sur le systme.
.SH BUGS
L'utilisation de 
.B IPC_PRIVATE
n'empche pas les autres processus d'accder au jeu de smaphores allou.
.PP
Comme pour les fichiers, il n'existe actuellement aucun moyen intrinsque
pour un processus de se garantir un accs exclusif  un ensemble de smaphores.
Rclamer a la fois
.B IPC_CREAT
et
.B IPC_EXCL
dans l'argument
.I semflg
garantit seulement la cration d'un nouvel ensemble, et non
pas un accs exclusif.
.PP
Les structures de donnes associes a chaque smaphore dans l'ensemble
ne sont pas initialises lors de l'appel systme.
Pour effectuer cette initialisation, il faut excuter un appel 
.BR semctl (2)
avec les commandes
.B SETVAL
ou
.B SETALL.
.SH CONFORMIT
SVr4, SVID.  SVr4 documente des conditions d'erreur supplmentaires
EINVAL, EFBIG, E2BIG, EAGAIN, ERANGE, et EFAULT.
.SH "VOIR AUSSI"
.BR ftok (3),
.BR ipc (5),
.BR semctl (2),
.BR semop (2).

.SH TRADUCTION
Christophe Blaess, 1997.