Manpages

NOMBRE

msgget − devuelve el identificador para una cola de mensajes

SINOPSIS

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

int msgget(key_t key, int msgflg);

DESCRIPCIÓN

La función devuelve el identificador de la cola de mensajes asociada a key. Se crea una nueva cola de mensajes si key tiene el valor IPC_PRIVATE, o si key no es IPC_PRIVATE pero no existe ninguna cola de mensajes asociada a key, y IPC_CREAT se inserta en msgflg (esto es, msgflg&IPC_CREAT es distinto de cero). La presencia en msgflg de los campos IPC_CREAT y IPC_EXCL desempeñan el mismo papel, con respecto a la existencia de la cola de mensajes, que O_CREAT y O_EXCL en el argumento "mode" de la llamada al sistema open(2), es decir, la función msgget falla si msgflg inserta IPC_CREAT y IPC_EXCL y ya esiste una cola de mensajes para key.

En la creación, los 9 bits más 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 de los permisos de acceso en las llamadas al sistema open(2) o creat(2) (Los permisos de ejecución no son usados.)

Si se crea una nueva cola de mensajes, 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 más bajo de msg_perm.mode son fijados a los 9 bits más bajos de msgflg.

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

msg_ctime contendrá la hora actual

msg_qbytes será igual al límite impuesto por el sistema MSGMNB.

Si la cola de mensajes ya existe, se verifican los permisos de acceso, y ser realiza una comprobación a fin de verificar si está marcada para su destrucción.

VALOR DEVUELTO

Si ha funcionado correctamente, devuelve el idenficador para la cola de mensajes (un entero no negativo), en otro caso −1 con errno indicando el error.

ERRORES

En caso de error, errno tendrá uno de los siguientes valores:

EACCES

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

EEXIST

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

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 límite del sistema para el máximo número de colas de mensajes (MSGMNI) será superado.

OBSERVACIONES

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 ignorará todo excepto los 9 bits de menor orden de msgflg y crea una nueva cola de mensajes (si ha funcionado).

Lo siguiente es una limitación en los recursos del sistema que afecta a la llamada msgget

MSGMNI

Número máximo de colas de mensajes soportadas por el sistema: depende de la política tomada.

FALLOS

La elección del nombre IPC_PRIVATE puede que fuera desafortunada, IPC_NEW mostraría más claramente su función.

CONFORME A

SVr4, SVID. Hasta la versión 2.3.20 Linux devolvía EIDRM cuando se llamaba a msgget con una cola de mensajes planificada para ser borrada.

VÉASE TAMBIÉN

ftok(3), ipc(5), msgctl(2), msgsnd(2), msgrcv(2)