Provided by: manpages-es_1.55-10_all bug

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)