.\" 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>
.\" Modified 1 Jan 2002, Martin Schulze <joey@infodrom.org>
.\" Modified 4 Jan 2002, Michael Kerrisk <mtk16@ext.canterbury.ac.nz>
.\" Translated 26 Jan 1998 by
.\" 	Vicente Pastor Gómez <VPASTORG@santandersupernet.com , vicpastor@hotmail.com>
.\" Translation revised on Tue Apr 6 1999 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised on Fri Jun 25 1999 by Juan Piernas <piernas@ditec.um.es>
.\" Revisado por Miguel Pérez Ibars <mpi79470@alu.um.es> el 29-septiembre-2004
.\"
.TH SEMGET 2 "4 enero 2002" "Linux 2.5" "Manual del Programador de Linux" 
.SH NOMBRE
semget \- obtiene el identificador de un conjunto de semáforos
.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 DESCRIPCIÓN
Esta función devuelve el identificador del conjunto de semáforos asociado con el argumento
.IR key .
Un nuevo conjunto de 
.I nsems
semáforos se crea si
.I key
tiene el valor
.BR IPC_PRIVATE ,
o si no hay un conjunto de semáforos asociado a
.I key
y el bit
.B IPC_CREAT
vale 1 en
.I semflg
(p.ej.
.IR semflg " &"
.B IPC_CREAT
es distinto de cero).
.PP
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 semáforos,
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 función
.B semget
falla si
.I semflg
tiene a 1 tanto
.B IPC_CREAT
como
.B IPC_EXCL
y ya existe un conjunto de semáforos para
.IR key .
.PP
Acerca de la creación, los 9 bits bajos del argumento
.I semflg
definen los permisos de acceso (para el propietario, grupo y otros)
para el conjunto de semáforos.
Estos bits tienen el mismo formato, y el mismo
significado que el argumento de modo en las 
llamadas al sistema
.BR open (2)
o
.BR creat (2)
(aunque los permisos de ejecución no son significativos para
los semáforos, y los permisos de escritura significan permisos para
alterar los valores del semáforo).
.PP
Cuando se crea un nuevo conjunto de semáforos,
.B semget
inicializa la estructura de datos
.B semid_ds
asociada al conjunto de semáforos 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 más bajos de
.B sem_perm.mode
se ponen como los 9 bits más 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 comodín o valor sin importancia)
cuando no se está creando un conjunto de semáforos.
En otro caso
.I nsems
debe ser mayor que
.B 0
y menor o igual que el número máximo de semáforos por conjunto de semáforos,
.RB ( SEMMSL ).
.PP
Si el conjunto de semáforos ya existe, los permisos de acceso son verificados.
.\" y se hace una comprobación para ver si está marcado para ser destruido.
.SH "VALOR DEVUELTO"
Si hubo éxito, el valor devuelto será el identificador del conjunto de
semáforos (un entero no negativo), de otro modo, se devuelve
.B \-1
con
.B errno
indicando el error.
.SH ERRORES
En caso de fallo,
.I errno
tendrá uno de los siguientes valores:
.TP 11
.B EACCES
Existe un conjunto de semáforos para
.IR key ,
pero el proceso que realiza la llamada no tiene permisos para acceder al conjunto.
.TP
.B EEXIST
Existe un conjunto de semáforos para
.B key
y
.I semflg
tiene a 1 tanto
.B IPC_CREAT
como
.BR IPC_EXCL .
.\" .TP
.\" .B EIDRM
.\" El conjunto de semáforos está marcado para ser borrado.
.TP
.B ENOENT
No existe ningún conjunto de semáforos para
.I key
y
.I semflg
no tiene a 1
.BR IPC_CREAT .
.TP
.B EINVAL
.IR nsems
es menor que 0 o mayor que el límite en el número de semáforos
por conjunto de semáforos
.RB ( SEMMSL ),
o ya existe un conjunto de semáforos que se corresponde con
.I key
, y
.I nsems
es mayor que el número de semáforos en ese conjunto.
.TP
.B ENOMEM
Se ha de crear un conjunto de semáforos, pero el sistema no tiene suficiente
memoria para la nueva estructura de datos.
.TP
.B ENOSPC
Se ha de crear un conjunto de semáforos, pero el límite del sistema para el
número máximo de conjuntos de semáforos
.RB ( SEMMNI ),
o el número de semáforos máximo del sistema
.RB ( SEMMNS ),
sería excedido.
.SH OBSERVACIONES
.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 más bajos de
.I semflg
y crea un nuevo conjunto de semáforos (si hay éxito).
.PP
Los siguientes son límites de los recursos de los conjuntos de semáforos
que afectan a la llamada
.B semget
:
.TP 11
.B SEMMNI
Máximo total de conjuntos de semáforos para el sistema: depende de la política.
.TP
.B SEMMSL
Máximo de semáforos por semid: depende de la implementación
(500 normalmente).
.TP
.B SEMMNS
Máximo total de semáforos para el sistema: depende de la política.
Valores mayores que
.B SEMMSL * SEMMNI
lo hacen irrelevante.
.SH FALLOS
La elección del nombre IPC_PRIVATE fue quizás desafortunada, IPC_NEW
mostraría más claramente su función.
.LP
La estructura de datos asociada con cada semáforo 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 una orden
.B SETVAL
o
.B SETALL
en el conjunto de semáforos.
.SH "CONFORME A"
SVr4, SVID.  
SVr4 documenta condiciones de error adicionales EFBIG, E2BIG, EAGAIN,
ERANGE, EFAULT.
.SH "VÉASE TAMBIÉN"
.BR ftok (3),
.BR ipc (5),
.BR semctl (2),
.BR semop (2)