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)