Sistemi operativi - Syscall msgget

Msgget - get the message queue identifier

SYNOPSIS

#include <sys/msg.h>
int msgget(key_t intkey, msgflg);

DESCRIPTION

La funzione msgget() restituisce l'identificatore della coda di messaggi associata con l'argomento key. Un identificatore di coda di messaggi, la coda di messaggi associata e la struttura dati (vedi <sys/msg.h>), sono creati per l'argomento key se una delle seguenti condizioni è vera:

• L'argomento key è uguale a IPC_PRIVATE.
• L'argomento key non ha già un identificatore di coda di messaggi associato, e (msgflg & IPC_CREAT) è diverso da zero.

Al momento della creazione, la struttura dati associata al nuovo identificatore di coda di messaggi viene inizializzata come segue: msg_perm.cuid, msg_perm.uid, msg_perm.cgid, msg_perm.gid sono impostati uguali all'ID utente effettivo e all'ID gruppo effettivo del processo chiamante. I 9 bit meno significativi di msg_perm.mode sono impostati uguali ai 9 bit meno significativi di msgflg. msg_qnum, msg_lspid, msg_lrpid, msg_stime sono impostati uguali a 0. msg_rtime è impostato uguale all'ora corrente. msg_ctime è impostato uguale al limite di sistema. msg_qbytes è impostato uguale al limite di sistema.

RETURN VALUE

Al completamento con successo, msgget() restituisce un numero intero non negativo, ovvero un identificatore di coda di messaggi. In caso contrario, restituisce -1 e errno è impostato per indicare l'errore.

ERRORS

La funzione msgget() fallisce se:

• [EACCES] Un identificatore di coda di messaggi esiste per l'argomento key, ma il permesso di operazione come specificato dai 9 bit meno significativi di msgflg non verrebbe concesso, vedi IPC.