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ÓN
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 tamaño igual al valor de PAGE_SIZE redondeado
por arriba a un múltiplo de size, si key tiene el valor IPC_PRIVATE o key no es IPC_PRIVATE, no existe
ningún segmento de memoria compartida correspondiente a key, y IPC_CREAT está declarado en shmflg (es
decir, shmflg&IPC_CREAT es distinto de cero).
El valor shmflg está compuesto de:
IPC_CREAT para crear un nuevo segmento. Si este indicador no se usa, shmget() encontrará el segmento
asociado con key y comprobará 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ás bajos)
especifican los permisos otorgados al dueño, grupo y resto del mundo. Actualmente el sistema
no usa los permisos de ejecución.
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 operación */
int shm_segsz; /* tamaño del segmento (bytes) */
time_t shm_atime; /* tiempo de la última unión */
time_t shm_dtime; /* tiempo de la última separación */
time_t shm_ctime; /* tiempo del último cambio */
unsigned short shm_cpid; /* pid del creador */
unsigned short shm_lpid; /* pid del último operador */
short shm_nattch; /* nº de uniones actuales */
};
struct ipc_perm {
key_t key;
ushort uid; /* euid y egid del dueño */
ushort gid;
ushort cuid; /* euid y egid del creador */
ushort cgid;
ushort mode; /* 9 bits más bajos de shmflg */
ushort seq; /* número 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 más bajos de shm_perm.mode toman el valor de los 9 bits más 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
está marcado para destrucción.
LLAMADAS DEL SISTEMA
fork() Después de un fork() el hijo hereda los segmentos de memoria compartida unidos.
exec() Después de un exec() todos los segmentos de memoria compartida unidos son separados (no
destruidos).
exit() A través de exit() todos los segmentos de memoria compartida unidos son separados (no destruidos).
VALOR DEVUELTO
En caso de éxito se devuelve el identificativo válido de segmento shmid. En caso de error se devuelve
-1.
ERRORES
En caso de error, errno tomará 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
tamaño de ese segmento.
EEXIST si se especificó 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 tamaño (size) solicitado causaría al sistema exceder su propio límite
de memoria compartida (SHMALL).
ENOENT si no existe segmento para el key dado, y no se especificó 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 más bajos de shmflg y crea un nuevo segmento de memoria
compartida (en caso de éxito).
Los siguientes son los límites de los recursos de un segmento de memoria compartida afectados por una
llamada shmget:
SHMALL Máximo número de páginas de memoria compartida de todo el sistema. Dependiente del criterio
que se use.
SHMMAX Máximo tamaño en bytes de un segmento de memoria compartida. Dependiente de la implementación
(actualmente 4M).
SHMMIN Mínimo tamaño en bytes de un segmento de memoria compartida. Dependiente de la implementación
(actualmente 1 byte, aunque PAGE_SIZE es el tamaño mínimo efectivo).
SHMMNI Máximo número de segmentos de memoria compartida de todo el sistema. Dependiente de la
implementación (actualmente 4096, era 128 antes de Linux 2.3.99).
La implementación no tiene límites específicos respecto al máximo número de segmentos de memoria
compartida por proceso (SHMSEG).
FALLOS
La elección del nombre IPC_PRIVATE fue quizás desafortunada, IPC_NEW mostraría más claramente su función.
CONFORME A
SVr4, SVID. SVr4 documenta la condición de error adicional EEXIST. Hasta la versión 2.3.30 Linux
devolvía EIDRM en una llamada shmget sobre un segmento de memoria compartida planificado para borrado.
VÉASE TAMBIÉN
ftok(3), ipc(5), shmctl(2), shmat(2), shmdt(2)
Linux 0.99.11 28 noviembre 1993 SHMGET(2)