Provided by: manpages-ru_4.19.0-7_all 
ИМЯ
mq_overview - обзор очередей сообщений POSIX
ОПИСАНИЕ
Очереди сообщений POSIX позволяют процессам обмениваться данными в виде сообщений. Данный
программный интерфейс отличается от используемого в очередях сообщений System V
(msgget(2), msgsnd(2), msgrcv(2), etc.), но предоставляет схожие возможности.
Очереди сообщений создаются и открываются с помощью mq_open(3); эта функция возвращает
дескриптор очереди сообщений (mqd_t), который используется в последующих вызовах для
ссылки на открытую очередь сообщений. Каждая очередь сообщений описывается именем в виде
/некое_имя; оно представляет собой строку с null в конце и длиной до NAME_MAX (т. е., 255)
символов, состоящую из начальной косой черты, одного и более символа (любого, кроме косой
черты). Два процесса могут работать через одну очередь, если укажут одинаковое имя в
mq_open(3).
Сообщения передаются в и из очереди с помощью функций mq_send(3) и mq_receive(3). Когда
процесс прекращает использовать очередь, он закрывает её с помощью функции mq_close(3), и
если очередь больше не нужна, то она может быть удалена с помощью функции mq_unlink(3).
Атрибуты очереди можно получить и (в некоторых случаях) изменить с помощью функций
mq_getattr(3) и mq_setattr(3). Процесс может запросить асинхронное уведомление о
поступлении сообщения в пустую очередь с помощью функции mq_notify(3).
Дескриптор очереди сообщений — это ссылка на открытое описание очереди сообщений (смотрите
open(2)). После вызова fork(2) потомок наследует копии дескрипторов очередей сообщений
родителя и эти дескрипторы ссылаются на те же открытые описания очередей сообщений
родителя. Соответствующие дескрипторы очередей сообщений двух процессов используют общий
флаг (mq_flags), который связан с открытым описанием очереди сообщений.
У каждого сообщения есть приоритет, и сначала в принимающий процесс всегда доставляются
сообщения наивысшим приоритетом. Диапазон приоритетов сообщений: 0 (низший) —
sysconf(_SC_MQ_PRIO_MAX) - 1 (высший). В Linux, sysconf(_SC_MQ_PRIO_MAX) возвращает 32768,
но в POSIX.1 требуется реализация поддержки только диапазона приоритетов от 0 до 31;
некоторые реализации предоставляют только этот диапазон.
Далее в разделе описываются особенности реализации очередей сообщений POSIX в Linux.
Библиотечные интерфейсы и системные вызовы
В большинстве случаев, перечисленные выше библиотечные интерфейсы mq_*() реализуются
поверх системных вызовов с теми же именами. Исключения из этого правила перечислены в
следующей таблице:
Библиотечный интерфейс Системный вызов
mq_close(3) close(2)
mq_getattr(3) mq_getsetattr(2)
mq_notify(3) mq_notify(2)
mq_open(3) mq_open(2)
mq_receive(3) mq_timedreceive(2)
mq_send(3) mq_timedsend(2)
mq_setattr(3) mq_getsetattr(2)
mq_timedreceive(3) mq_timedreceive(2)
mq_timedsend(3) mq_timedsend(2)
mq_unlink(3) mq_unlink(2)
Версии
POSIX message queues have been supported since Linux 2.6.6. glibc support has been
provided since glibc 2.3.4.
Конфигурация ядра
Поддержка очередей сообщений POSIX включается параметром настройки ядра
CONFIG_POSIX_MQUEUE. Данный параметр включён по умолчанию.
Устойчивость
Очереди сообщений POSIX располагаются в ядре. Пока очередь не удалёна с помощью
mq_unlink(3), она остаётся в системе до её выключения.
Компоновка
Программы, в которых используется программный интерфейс очереди сообщений POSIX, для
компоновки с библиотекой реального времени librt должны компилироваться с помощью cc -lrt.
Интерфейс /proc
Для ограничения потребления очередями сообщений POSIX памяти ядра и задания атрибутов по
умолчанию для новых очередей сообщений, можно использовать следующие интерфейсы:
/proc/sys/fs/mqueue/msg_default (начиная с Linux 3.5)
This file defines the value used for a new queue's mq_maxmsg setting when the queue
is created with a call to mq_open(3) where attr is specified as NULL. The default
value for this file is 10. The minimum and maximum are as for
/proc/sys/fs/mqueue/msg_max. A new queue's default mq_maxmsg value will be the
smaller of msg_default and msg_max. Before Linux 2.6.28, the default mq_maxmsg was
10; from Linux 2.6.28 to Linux 3.4, the default was the value defined for the
msg_max limit.
/proc/sys/fs/mqueue/msg_max
This file can be used to view and change the ceiling value for the maximum number
of messages in a queue. This value acts as a ceiling on the attr->mq_maxmsg
argument given to mq_open(3). The default value for msg_max is 10. The minimum
value is 1 (10 before Linux 2.6.28). The upper limit is HARD_MSGMAX. The msg_max
limit is ignored for privileged processes (CAP_SYS_RESOURCE), but the HARD_MSGMAX
ceiling is nevertheless imposed.
Определение HARD_MSGMAX изменялось в разных версиях ядра следующим образом:
• Up to Linux 2.6.32: 131072 / sizeof(void *)
• Linux 2.6.33 to Linux 3.4: (32768 * sizeof(void *) / 4)
• Начиная с Linux 3.5: 65536
/proc/sys/fs/mqueue/msgsize_default (начиная с Linux 3.5)
This file defines the value used for a new queue's mq_msgsize setting when the
queue is created with a call to mq_open(3) where attr is specified as NULL. The
default value for this file is 8192 (bytes). The minimum and maximum are as for
/proc/sys/fs/mqueue/msgsize_max. If msgsize_default exceeds msgsize_max, a new
queue's default mq_msgsize value is capped to the msgsize_max limit. Before Linux
2.6.28, the default mq_msgsize was 8192; from Linux 2.6.28 to Linux 3.4, the
default was the value defined for the msgsize_max limit.
/proc/sys/fs/mqueue/msgsize_max
This file can be used to view and change the ceiling on the maximum message size.
This value acts as a ceiling on the attr->mq_msgsize argument given to mq_open(3).
The default value for msgsize_max is 8192 bytes. The minimum value is 128 (8192
before Linux 2.6.28). The upper limit for msgsize_max has varied across kernel
versions:
• До Linux 2.6.28 верхний предел был равен INT_MAX.
• From Linux 2.6.28 to Linux 3.4, the limit is 1,048,576.
• Начиная с Linux 3.5 предел равен 16777216 (HARD_MSGSIZEMAX).
Предел msgsize_max игнорируется для привилегированных процессов (CAP_SYS_RESOURCE),
но, начиная с Linux 3.5, накладывается ограничение HARD_MSGSIZEMAX.
/proc/sys/fs/mqueue/queues_max
Данный файл можно использовать для просмотра и изменения системного ограничения на
количество сообщений в очереди. Значение queues_max по умолчанию равно 256. У
queues_max нет верхнего предела; привилегированные процессы (CAP_SYS_RESOURCE)
могут превышать ограничение (но смотрите ДЕФЕКТЫ).
Ограничение ресурса
Ограничение ресурса RLIMIT_MSGQUEUE, накладываемое на количество пространства, которое
могут занять все очереди сообщений, принадлежащие процессу с реальным пользовательским ID,
описано в getrlimit(2).
Монтирование файловой системы очереди сообщений
В Linux очереди сообщений создаются в виртуальной файловой системе (другие реализации
могут делать также, но, вероятно, по-другому). Данная файловая система может быть
смонтирована (суперпользователем) с помощью команд:
# mkdir /dev/mqueue
# mount -t mqueue none /dev/mqueue
Закрепляющий бит устанавливается на каталог назначения автоматически.
После примонтирования файловой системы очередь сообщений в системе можно просматривать и
изменять с помощью команд как с обычными файлами (например, ls(1) и rm(1)).
Содержимое каждого файла в каталоге состоит из одной строки, в которой представлена
информация об очереди:
$ cat /dev/mqueue/mymq
QSIZE:129 NOTIFY:2 SIGNO:0 NOTIFY_PID:8260
Эти поля означают следующее:
QSIZE Количество байтов данных во всех сообщениях очереди (но смотрите ДЕФЕКТЫ).
NOTIFY_PID
Если это значение не равно нулю, то процесс с данным PID использовал mq_notify(3)
для регистрации асинхронных уведомлений о сообщениях, а оставшиеся поля описывают
как производится уведомление.
NOTIFY Способ уведомления: 0 — SIGEV_SIGNAL; 1 — SIGEV_NONE; 2 — SIGEV_THREAD.
SIGNO Номер сигнала, который будет использован для SIGEV_SIGNAL.
Реализация дескрипторов очереди сообщений в Linux
В Linux дескриптор очереди сообщений представляет собой файловый дескриптор (в POSIX не
требуется этого от реализации). Это означает, что за дескриптором очереди сообщений можно
следить с помощью select(2), poll(2) или epoll(7). Это является непереносимым свойством.
Флаг close-on-exec (смотрите open(2)) устанавливается автоматически на файловом
дескрипторе, возвращаемом mq_open(2).
Пространства имён IPC
Обсуждение связи объектов очереди сообщений POSIX с пространствами IPC смотрите в
ipc_namespaces(7).
ЗАМЕЧАНИЯ
Очереди сообщений System V (msgget(2), msgsnd(2), msgrcv(2) и т. д.) — более старый
программный интерфейс обмена сообщениями между процессами. Очереди сообщений POSIX имеют
более проработанный интерфейс чем очереди сообщений System V; с другой стороны, очереди
сообщений POSIX не так широко распространены (особенно в старых системах) чем очереди
сообщений System V.
Linux does not currently (Linux 2.6.26) support the use of access control lists (ACLs) for
POSIX message queues.
ДЕФЕКТЫ
Since Linux 3.5 to Linux 3.14, the kernel imposed a ceiling of 1024 (HARD_QUEUESMAX) on
the value to which the queues_max limit could be raised, and the ceiling was enforced even
for privileged processes. This ceiling value was removed in Linux 3.14, and patches to
stable Linux 3.5.x to Linux 3.13.x also removed the ceiling.
Первоначально реализованное (и описанное) поле QSIZE показывало общее количество
(пользовательских) байт всех сообщений в очереди. Некоторые изменения в Linux 3.5
непреднамеренно изменили это поведение, и поле стало также включать байты издержек ядра,
которые требуются для хранения сообщений в очереди. Это было исправлено в Linux 4.2 (и
более ранних стабильных ядрах), и теперь снова считаются байты только пользовательских
сообщений в очереди.
ПРИМЕРЫ
Пример использования функций работы с очередью сообщений смотрите в mq_notify(3).
СМ. ТАКЖЕ
getrlimit(2), mq_getsetattr(2), poll(2), select(2), mq_close(3), mq_getattr(3),
mq_notify(3), mq_open(3), mq_receive(3), mq_send(3), mq_unlink(3), epoll(7), namespaces(7)
ПЕРЕВОД
Русский перевод этой страницы руководства был сделан aereiae <aereiae@gmail.com>, Alexey
<a.chepugov@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin
<dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, ITriskTI
<ITriskTI@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван
Павлов <pavia00@gmail.com> и Малянов Евгений Викторович <maljanow@outlook.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную
лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте
электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.