.\" 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.
.\"
.\" Modified Tue Oct 22 17:54:56 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated 26 Jan 1998 by Vicente Pastor Gmez <VPASTORG@santandersupernet.com , vicpastor@hotmail.com>
.TH SEMGET 2 "1 Noviembre 1993" "Linux 0.99.13" "Manual del Programador Linux" 
.SH NOMBRE
semget \- obtiene el identificador de un conjunto de semforos
.SH SINOPSIS
.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 DESCRIPCIN
La funcin devuelve el identificador del conjunto de semforos asociado al valor del argumento
.IR key .
Un nuevo conjunto de 
.I nsems
semforos se crea si
.I key
tiene el valor
.BR IPC_PRIVATE ,
o si
.I key
no vale
.BR IPC_PRIVATE ,
no hay una cola de mensajes asociada a
.IR key ,
y el bit
.B IPC_CREAT
vale 1 en
.I semflg
(p.ej.
.IB semflg &IPC_CREAT
es distinto de cero).
La presencia en
.I semflg
de los campos
.B IPC_CREAT
e
.B IPC_EXCL
tiene el mismo papel, con respecto a la existencia del conjunto de semforos,
que la presencia de
.B O_CREAT
y
.B O_EXCL
en el argumento mode de la llamada del sistema
.BR open (2):
p.ej., la funcin
.B msgget
falla si
.I semflg
tiene a 1 tanto
.B IPC_CREAT
como
.B IPC_EXCL
y ya existe un conjunto de semforos para
.IR key .
.PP
Acerca de la creacin, los 9 bits bajos del argumento
.I semflg
definen los permisos de acceso (para el propietario, grupo y otros)
al conjunto de semforos en el mismo formato, y con el mismo significado,
que para el parmetro de permisos de acceso en las llamadas al sistema
.BR open (2)
o
.BR creat (2)
(aunque los permisos de ejecucin no son usados por el sistema, y los
de escritura, para un conjunto de semforos, efectivamente significa permisos de modificacin).

.PP
Adems, durante la creacin, la llamada al sistema inicializa la estructura
de datos
.B semid_ds
del conjunto de semforos del sistema, como sigue:
.IP
Se pone el ID  de usuario efectivo del proceso que realiza la llamada en
.B sem_perm.cuid
y
.B sem_perm.uid
.
.IP
Se pone el ID de grupo efectivo del proceso que realiza la llamada en
.B sem_perm.cgid
y
.B sem_perm.gid
.
.IP
Los 9 bits ms bajos de
.B sem_perm.mode
se ponen como los 9 bits ms bajos de
.IR semflg .
.IP
Se pone el valor de
.IR nsems
en
.BR sem_nsems .
.IP
.B sem_otime
se pone a 0.
.IP
Se pone la hora actual en
.BR sem_ctime.
.PP
El argumento
.I nsems
puede ser
.B 0
(un comodn o valor sin importancia)
cuando la llamada del sistema no es de creacin.
En otro caso
.I nsems
debe ser mayor que
.B 0
y menor o igual que el nmero mximo de semforos por semid,
.RB ( SEMMSL ).
.PP
Si el conjunto de semforos ya existe, los permisos de acceso son verificados,
y se hace una comprobacin para ver si est marcado para ser destruido.
.SH "VALOR REGRESADO"
Si hubo xito, el valor devuelto ser el identificador del conjunto de
semforos (un entero positivo), de otro modo, se devuelve
.B \-1
con
.B errno
indicando el error.
.SH ERRORES
Para un retorno fallido,
.B errno
tendr uno de entre los siguientes valores:
.TP 11
.B EACCES
Existe un conjunto de semforos para
.IR key ,
pero el proceso que realiza la llamada no tiene permisos de acceso al conjunto.
.TP
.B EEXIST
Existe un conjunto de semforos para
.B key
y
.I semflg
tiene a 1 tanto
.B IPC_CREAT
como
.BR IPC_EXCL .
.TP
.B EIDRM
El conjunto de semforos est marcado para ser borrado.
.TP
.B ENOENT
No existe ningn conjunto de semforos para
.I key
y
.I semflg
no tiene a 1
.BR IPC_CREAT .
.TP
.B ENOMEM
Se ha de crear un conjunto de semforos, pero el sistema no tiene suficiente
memoria para la nueva estructura de datos.
.TP
.B ENOSPC
Se ha de crear un conjunto de semforos, pero el lmite del sistema para el
nmero mximo de conjuntos de semforos
.RB ( SEMMNI ),
o el nmero de semforos mximo del sistema
.RB ( SEMMNS ),
sera excedido.
.SH NOTAS
.B IPC_PRIVATE
no es un campo bandera (flag), sino que es de tipo
.B key_t
.
Si este valor especial es usado para
.IR key ,
la llamada del sistema ignora todo excepto los 9 bits ms bajos de
.I semflg
y crea un nuevo conjunto de semforos (si hay xito).
.PP
Los siguientes son lmites de los recursos de los conjuntos de semforos
que afectan a la llamada
.B semget
:
.TP 11
.B SEMMNI
Mximo total de conjuntos de semforos para el sistema: depende de la poltica.
.TP
.B SEMMSL
Mximo de semforos por semid: depende de la implementacin
(500 normalmente).
.TP
.B SEMMNS
Mximo total de semforos para el sistema: depende de la poltica.
Valores mayores que
.B SEMMSL * SEMMNI
lo hacen irrelevante.
.SH BUGS
El uso de
.B IPC_PRIVATE
no inhibe el acceso de los dems procesos al conjunto de semforos asignado.
.PP
Al igual que pasa con los ficheros, no hay una manera intrnseca para que un
proceso se asegure el acceso exclusivo a un conjunto de semforos.
Tener a 1 tanto
.B IPC_CREAT
como
.B IPC_EXCL
en
.I semflg
solo asegura (si hay xito) la creacin de un nuevo conjunto de semforos,
no implica acceso exclusivo a dicho conjunto.
.PP
La estructura de datos asociada con cada semforo del conjunto no es
inicializada por la llamada del sistema.
Para inicializar estas estructuras de datos, se ha de ejecutar la subsiguiente
llamada a
.BR semctl (2)
para realizar un comando
.B SETVAL
o
.B SETALL
en el conjunto de semforos.
.SH "CONFORMA CON"
SVr4, SVID.  SVr4 documenta condiciones de error adicionales EINVAL, EFBIG,
E2BIG, EAGAIN, ERANGE, EFAULT.
.SH "VASE TAMBIN"
.BR ftok (3),
.BR ipc (5),
.BR semctl (2),
.BR semop (2).