Provided by:
manpages-es_1.55-10_all 
NOMBRE
shmget - asigna un segmento de memoria compartida
SINOPSIS
#include <sys/ipc.h>
#include <sys/shm.h>
int shmget(key_t key, int size, int shmflg);
DESCRIPCI'ON
shmget() devuelve el identificador del segmento de memoria compartida
asociado con el valor del argumento key. Se crea un nuevo segmento de
memoria compartida, de tamano igual al valor de PAGE_SIZE redondeado
por arriba a un multiplo de size, si key tiene el valor IPC_PRIVATE o
key no es IPC_PRIVATE, no existe ningun segmento de memoria compartida
correspondiente a key, y IPC_CREAT esta declarado en shmflg (es decir,
shmflg&IPC_CREAT es distinto de cero).
El valor shmflg esta compuesto de:
IPC_CREAT para crear un nuevo segmento. Si este indicador no se usa,
shmget() encontrara el segmento asociado con key y
comprobara que el usuario tenga permiso para acceder al
segmento.
IPC_EXCL usado con IPC_CREAT para asegurar el fallo si el segmento
ya existe.
mode_flags (9 bits m'as bajos)
especifican los permisos otorgados al dueno, grupo y resto
del mundo. Actualmente el sistema no usa los permisos de
ejecucion.
Si se crea un nuevo segmento, los permisos de acceso de shmflg son
copiados al miembro shm_perm de la estructura shmid_ds que define el
segmento. La estructura shmid_ds tiene el siguiente aspecto:
struct shmid_ds {
struct ipc_perm shm_perm; /* permisos de operacion */
int shm_segsz; /* tamano del segmento (bytes) */
time_t shm_atime; /* tiempo de la ultima union */
time_t shm_dtime; /* tiempo de la ultima separacion */
time_t shm_ctime; /* tiempo del ultimo cambio */
unsigned short shm_cpid; /* pid del creador */
unsigned short shm_lpid; /* pid del ultimo operador */
short shm_nattch; /* no de uniones actuales */
};
struct ipc_perm {
key_t key;
ushort uid; /* euid y egid del dueno */
ushort gid;
ushort cuid; /* euid y egid del creador */
ushort cgid;
ushort mode; /* 9 bits mas bajos de shmflg */
ushort seq; /* numero de secuencia */
};
Cuando se crea un nuevo segmento de memoria compartida, la llamada al
sistema inicializa la estructura de datos shmid_ds como sigue:
shm_perm.cuid y shm_perm.uid son asignados al identificativo de
usuario efectivo (euid) del proceso creador.
shm_perm.cgid y shm_perm.gid son asignados al identificativo de
grupo efectivo (egid) del proceso creador.
Los 9 bits mas bajos de shm_perm.mode toman el valor de los 9
bits mas bajos de shmflg.
shm_segsz toma el valor de size.
shm_lpid, shm_nattch, shm_atime y shm_dtime son puestos a 0.
shm_ctime toma el valor del tiempo actual.
Si el segmento de memoria compartida ya existe, se verifican los
permisos de acceso, y se comprueba si esta marcado para destruccion.
LLAMADAS DEL SISTEMA
fork() Despues de un fork() el hijo hereda los segmentos de memoria
compartida unidos.
exec() Despues de un exec() todos los segmentos de memoria compartida
unidos son separados (no destruidos).
exit() A traves de exit() todos los segmentos de memoria compartida
unidos son separados (no destruidos).
VALOR DEVUELTO
En caso de exito se devuelve el identificativo valido de segmento
shmid. En caso de error se devuelve -1.
ERRORES
En caso de error, errno tomara uno de los siguientes valores:
EINVAL si se tiene que crear un nuevo segmento y size < SHMMIN o
size > SHMMAX, o no se tiene que crear un nuevo segmento,
existe un segmento con la clave dada, pero size es mayor
que el tamano de ese segmento.
EEXIST si se especifico IPC_CREAT | IPC_EXCL y el segmento existe.
ENOSPC si se han usado todos los identificativos posibles de
memoria compartida (SHMMNI), o si asignar un segmento del
tamano (size) solicitado causaria al sistema exceder su
propio limite de memoria compartida (SHMALL).
ENOENT si no existe segmento para el key dado, y no se especifico
IPC_CREAT.
EACCES si el usuario no tiene permiso para acceder al segmento de
memoria compartida.
ENOMEM si no pudo asignarse suficiente memoria para el segmento
requerido.
OBSERVACIONES
IPC_PRIVATE no es un indicador, sino un tipo key_t. Si se usa este
valor especial para key, la llamada del sistema ignora todos menos los
9 bits mas bajos de shmflg y crea un nuevo segmento de memoria
compartida (en caso de exito).
Los siguientes son los limites de los recursos de un segmento de
memoria compartida afectados por una llamada shmget:
SHMALL Maximo numero de paginas de memoria compartida de todo el
sistema. Dependiente del criterio que se use.
SHMMAX Maximo tamano en bytes de un segmento de memoria compartida.
Dependiente de la implementacion (actualmente 4M).
SHMMIN Minimo tamano en bytes de un segmento de memoria compartida.
Dependiente de la implementacion (actualmente 1 byte, aunque
PAGE_SIZE es el tamano minimo efectivo).
SHMMNI Maximo numero de segmentos de memoria compartida de todo el
sistema. Dependiente de la implementacion (actualmente
4096, era 128 antes de Linux 2.3.99).
La implementacion no tiene limites especificos respecto al maximo
numero de segmentos de memoria compartida por proceso (SHMSEG).
FALLOS
La eleccion del nombre IPC_PRIVATE fue quizas desafortunada, IPC_NEW
mostraria mas claramente su funcion.
CONFORME A
SVr4, SVID. SVr4 documenta la condicion de error adicional EEXIST.
Hasta la version 2.3.30 Linux devolvia EIDRM en una llamada shmget
sobre un segmento de memoria compartida planificado para borrado.
V'EASE TAMBI'EN
ftok(3), ipc(5), shmctl(2), shmat(2), shmdt(2)