MSGGET(2) MSGGET(2)
НАЗВАНИЕ
msgget - получение идентификатора очереди сообщений
СИНТАКСИС
#include
#include
#include
int msgget (key, msgflg)
key_t key;
int msgflg;
ОПИСАНИЕ
Системный вызов msgget возвращает идентификатор очереди
сообщений, ассоциированный с ключом key.
Идентификатор очереди сообщений и ассоциированные с ним
очередь и структура данных [см. intro(2)] создаются для
ключа key в следующих случаях:
1. Значение аргумента key равно IPC_PRIVATE.
2. Ключ key еще не имеет ассоциированного с ним иден-
тификатора очереди сообщений и выражение (msgflg &
IPC_CREAT) истинно.
При создании структуры данных, ассоциированной с новым
идентификатором очереди сообщений, выполняются следую-
щие инициализирующие действия:
1. Значения полей msg_perm.cuid, msg_perm.uid,
msg_perm.cgid и msg_perm.gid устанавливаются рав-
ными действующему идентификатору пользователя и,
соответственно, действующему идентификатору группы
вызывающего процесса.
2. Младшие 9 бит поля msg_perm.mode устанавливаются
равными 9 младшим битам аргумента msgflg.
3. Значения полей msg_qnum, msg_lspid, msg_lrpid,
msg_stime и msg_rtime устанавливаются равными 0.
4. Значение поля msg_ctime устанавливается равным те-
кущему времени.
5. Значение поля msg_qbytes устанавливается равным
системному лимиту.
Системный вызов msgget завершается неудачей, если вы-
полнено хотя бы одно из следующих условий:
[EACCES] Для ключа key уже существует идентификатор
очереди сообщений, но не могут быть предос-
тавлены права доступа, определенные в 9
младших битах аргумента msgflg.
[ENOENT] Для ключа key не существует идентификатор
очереди сообщений и выражение (msgflg &
IPC_CREAT) ложно.
[ENOSPC] Идентификатор очереди сообщений должен быть
создан, но тогда будет превышено максималь-
но допустимое количество идентификаторов в
системе.
[EEXIST] Для ключа key уже существует идентификатор
очереди сообщений и выражение ((msgflg &
IPC_CREAT) & (msgflg & IPC_EXCL)) истинно.
СМ. ТАКЖЕ
intro(2), msgctl(2), msgop(2).
ДИАГНОСТИКА
При успешном завершении системного вызова возвращается
неотрицательное целое число - идентификатор очереди со-
общений. В случае ошибки возвращается -1, а переменной
errno присваивается код ошибки.
|