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.
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)