table of contents
MSGGET(2) | Manual del Programador de Linux | MSGGET(2) |
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¶
1 noviembre 1993 | Linux 0.99.13 |