MSGGET(2)

НАЗВАНИЕ
msgget - получение идентификатора очереди сообщений

СИНТАКСИС


        #include <sys/types.h>

        #include <sys/ipc.h>

        #include <sys/msg.h>



        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 присваивается код ошибки.