Главная » 2017 » Ноябрь » 21 » man 2 msgget
01:00
man 2 msgget

SEO sprint - Всё для максимальной раскрутки!





ИМЯ


msgget - возвращает идентификатор очереди сообщений System V



ОБЗОР


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

int msgget(key_t key, int msgflg);



ОПИСАНИЕ


Системный вызов msgget() возвращает идентификатор очереди сообщений System V,
связанный со значением аргумента key. Он также создаёт новую очередь сообщений,
если значение key равно IPC_PRIVATE или если с параметром key не существует ни
одной очереди сообщений и в поле msgflg указан флаг IPC_CREAT.

Если в msgflg одновременно заданы IPC_CREAT и IPC_EXCL и с таким key очередь
сообщений уже существует, то msgget() завершится с ошибкой и errno будет равно
EEXIST (тот же эффект как для комбинации O_CREAT | O_EXCL у open(2)).

При создании права доступа к очереди сообщений определяются младшими битами
параметра msgflg. Эти биты прав имеют тот же формат и значение, что и права в
аргументе mode у вызова open(2) (право на исполнение не используется).

Если создаётся новая очередь сообщений, то этот системный вызов инициализирует
структуру данных msqid_ds (смотрите msgctl(2)) следующим образом:

Полям msg_perm.cuid и msg_perm.uid присваивается эффективный идентификатор
пользователя вызывающего процесса.

Полям msg_perm.cgid и msg_perm.gid присваивается эффективный идентификатор
группы вызывающего процесса.

Младшим 9 битам msg_perm.mode присваивается значение младших 9 битов
msgflg.

msg_qnum, msg_lspid, msg_lrpid, msg_stime и msg_rtime присваивается 0.

В поле msg_ctime записывается текущее время.

В поле msg_qbytes записывается системное ограничение MSGMNB.

Если очередь сообщений уже существует, то проверяются права доступа к ней и не
помечена ли она для удаления.



ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ


При успешном выполнении возвращается идентификатор очереди сообщений
(неотрицательное целое), иначе возвращается -1, а переменной errno присваивается
номер ошибки.



ОШИБКИ


При ошибке errno устанавливается в одно из следующих значений:

EACCES Очередь сообщений для ключа key существует, но вызывающий процесс не имеет
прав доступа к ней и не имеет мандата CAP_IPC_OWNER, который управляет его
пространством имён IPC.

ENOSPC Очередь сообщений необходимо создать, но лимит, определяющий количество
очередей сообщений (MSGMNI), уже достигнут.



СООТВЕТСТВИЕ СТАНДАРТАМ


POSIX.1-2001, POSIX.1-2008, SVr4.



ЗАМЕЧАНИЯ


Включение файлов <sys/types.h> и <sys/ipc.h> не требуется в Linux или любых версий
POSIX. Однако, некоторые старые реализации требуют включения данных заголовочных
файлов, и это также требуется по SVID. В приложениях, которые нужно перенести на
такие старые системы, может потребоваться включить данных заголовочные файлы.

IPC_PRIVATE является не полем с флагами, а имеет тип key_t. Если при работе с key
используется это специальное значение, то системный вызов игнорирует всё, кроме
9-ти младших битов в msgflg и создаёт новую очередь сообщений (если это возможно).

На вызов msgget() влияет системное ограничение по очередям сообщений:

MSGMNI Системное ограничение на максимальное количество очередей сообщений. В
системах Linux до версии 3.19, значением по умолчанию этого ограничения
рассчитывалось на основе формулы зависящей от доступной системной памяти.
Начиная с Linux 3.19, значение по умолчанию равно 32000. В Linux это
ограничение можно прочитать и изменять через /proc/sys/kernel/msgmni).

Замечания, касающиеся Linux
В Linux до версии 2.3.20 вызов msgget() возвращал значение EIDRM, если очередь
сообщений была запланирована к удалению.



ДЕФЕКТЫ


Имя IPC_PRIVATE, возможно, было выбрано неудачно, IPC_NEW отражает смысл действия
более ясно.



СМОТРИТЕ ТАКЖЕ


msgctl(2), msgrcv(2), msgsnd(2), ftok(3), capabilities(7), mq_overview(7),
svipc(7)



Категория: (2) Системные вызовы ядра (функции языка Си) | Просмотров: 35 | Добавил: Администратор | Рейтинг: 0.0/0
Всего комментариев: 0
avatar