SHMGET(2) | Manual del Programador de Linux | SHMGET(2) |
shmget - asigna un segmento de memoria compartida
#include <sys/ipc.h>
#include <sys/shm.h>
int shmget(key_t key, int size, int shmflg);
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:
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:
Si el segmento de memoria compartida ya existe, se verifican los permisos de acceso, y se comprueba si está marcado para destrucción.
En caso de éxito se devuelve el identificativo válido de segmento shmid. En caso de error se devuelve -1.
En caso de error, errno tomará uno de los siguientes valores:
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:
La implementación no tiene límites específicos respecto al máximo número de segmentos de memoria compartida por proceso (SHMSEG).
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.
28 noviembre 1993 | Linux 0.99.11 |