MSGGET(2)

NOMBRE
msgget - devuelve el identificador para una cola de mensajes

SINTAXIS
# include <sys/types.h>
# include <sys/ipc.h>
# include <sys/msg.h>

int msgget ( key_t key, int msgflg )

DESCRIPCION
La funcion devuelve el identificador de la cola de la mensajes asociado al valor del argumento key Una cola de mensajes nueva es creada si key tiene el valor IPC_PRIVATE o si keya no es IPC_PRIVATE, ninguna cola de mensajes existente es asociada con key, y IPC_CREAT es insertado en msgflg (esto es, msgflg&IPC_CREAT es distinto de cero). La presencia en msgflg de los campos IPC_CREAT y IPC_EXCL efectuan el mismo role, con respecto a la existencia de la cola de mensajes, así como la presencia de O_CREAT y O_EXCL en el argumento "mode" de la llamada al sistema open(2) ,esto es, la funcion msgget falla si msgflg insera IPC_CREAT y IPC_EXCL y ya esiste una cola de mensajes para key.

En la creacion, los 9 bits mas bajos del argumento msgflg definen los permisos de acceso a la cola de mensajes. Estos bits para los permisos tienen la misma forma y semántica que los parametros para los permisos de acceso en las llamadas al sistema open(2) o creat(2) (Los permisos de ejecucion no son usados.)

Ademas, durante la creacion, la llamada al sistema inicializa la estructura de datos del sistema para la cola msqid_ds como se muestra:

    msg_perm.cuid y msg_perm.uid son fijados al identificador del usuario efectivo del proceso invocador.

    msg_perm.cgid y msg_perm.gid son fijados al identificador de grupo efectivo del proveso invocador.

    Los 9 bits mas bajois (menor orden) de msg_perm.mode son fijados a los 9 bits mas bajos de msgflg.

    msg_qnum, msg_lspid, msg_lrpid, msg_stime y msg_rtime son puestos a 0.

    msg_ctime contendra la hora actual

    msg_qbytes sera igual al limite impuesto por el sistema MSGMNB.

Si la cola de mensajes ya existe los permisos de acceso son verificados, y un chequeo es realizado a fin de veriticar si esta marcado para su destrucción.

VALOR DEVUELTO
Si ha funcionado correctamente, el valor de retorno sera el idenficador para la cola de mensajes (un entero no negativo), en otro caso -1 con errno indicando el error.

ERRORS
Para un retorno fallido, errno tendra uno de los siguientes valores:

EACCES
    Existe una cola de mensajes para key, pero el proceso no tiene permisos de acceso a la cola.

EEXIST
    Existe una cola de mensajes para key y msgflg contiene IPC_CREAT y IPC_EXCL.

EIDRM
    La cola esta marcada para ser eliminada.

ENOENT
    No existe una cola de mensajes para key y msgflg no contiene IPC_CREAT.

ENOMEM
    Una cola de mensajes ha de ser creada pero el sistema no contiene suficiente memoria para la nueva estructura de datos.

ENOSPC
    Una cola de mensajes ha de ser creada pero el limite del sistema para el máximo número de colas de mensajes (MSGMNI) será superado.

NOTAS
IPC_PRIVATE no es un campo de tipo bandera, es del tipo key_t Si este valor especial es utilizado por key, la llamada al sistema ignorara todo excpeto los 9 bits de menor orden de msgflg y crea una nueva cola de mensajes (si ha funcionado).

Lo siguiente es una limitacion en los recursos del sistema que afecta a la llamada msgget

MSGMNI
    Numero maximo de colas de mensajes soportadas por el sistema: depende de la política tomada.

ERRORES
El uso de IPC_PRIVATE no prohibe a otros procesos tener acceso a la cola de mensajes creada.

Como en el caso de los ficheros, no existe una forma intrinseca de asegurar el acceso exclusivo a la cola de mensajes. Insertando IPC_CREAT y IPC_EXCL en msgflg solo garantiza que la nueva cola de mensajes sera creada, no implica acceso exclusivo a la cola de mensajes.

COMPATIBLE CON
SVr4, SVID. SVr4 no documenta el codigo de error EIDRM.

VER TAMBIEN
ftok(3), ipc(5), msgctl(2), msgsnd(2), msgrcv(2).