ИМЯ

       mq_send, mq_timedsend - отправляет сообщение в очередь сообщений

LIBRARY

       Real-time library (librt, -lrt)

СИНТАКСИС

       #include <mqueue.h>

       int mq_send(mqd_t mqdes, const char msg_ptr[.msg_len],
                     size_t msg_len, unsigned int msg_prio);

       #include <time.h>
       #include <mqueue.h>

       int mq_timedsend(mqd_t mqdes, const char msg_ptr[.msg_len],
                     size_t msg_len, unsigned int msg_prio,
                     const struct timespec *abs_timeout);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       mq_timedsend():
           _POSIX_C_SOURCE >= 200112L

ОПИСАНИЕ

       Функция mq_send() добавляет сообщение, на которое указывает msg_ptr, в очередь сообщений,
       на которую ссылается дескриптор очереди сообщений mqdes. В аргументе msg_len задаётся
       длина сообщения, на которое указывает msg_ptr; эта длина должна быть меньше или равно
       атрибуту очереди mq_msgsize. Допускаются сообщения нулевой длины.

       Значение аргумента msg_prio представляет собой неотрицательное целое, которым определяется
       приоритет этого сообщения. Сообщения помещаются в очередь в порядке уменьшения приоритета,
       самые новые сообщения с одинаковым приоритетом размещаются после старых с тем же
       приоритетом. Описание диапазона приоритета сообщения смотрите в mq_overview(7).

       Если очередь сообщений заполнена (т. е., количество сообщений в очереди равно атрибуту
       очереди mq_maxmsg), то по умолчанию mq_send() блокируется до появления места для записи
       сообщения, или пока вызов не будет прерван обработчиком сигнала. Если в описании очереди
       сообщений включён флаг O_NONBLOCK, то вместо этого вызов сразу завершается с ошибкой
       EAGAIN.

       mq_timedsend()  behaves just like mq_send(), except that if the queue is full and the
       O_NONBLOCK flag is not enabled for the message queue description, then abs_timeout points
       to a structure which specifies how long the call will block.  This value is an absolute
       timeout in seconds and nanoseconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC),
       specified in a timespec(3)  structure.

       Если очередь сообщений полна и вышло время ожидания на момент вызова, то mq_timedsend()
       сразу же завершается.

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

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

ОШИБКИ

       EAGAIN Очередь была полна и в описании очереди сообщений, на которое ссылается mqdes,
              указан флаг O_NONBLOCK.

       EBADF  В mqdes указан некорректный или не открытый на запись дескриптор.

       EINTR  Вызов был прерван обработчиком сигнала; смотрите signal(7).

       EINVAL Вызов бы заблокировался и в abs_timeout указано некорректное значение, так как
              tv_sec меньше нуля или tv_nsec меньше нуля или более 1000 миллионов.

       EMSGSIZE
              msg_len больше, чем свойство очереди сообщений mq_msgsize.

       ETIMEDOUT
              Истёк период ожидания в вызове, раньше появления возможности передачи сообщения.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).

       ┌───────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │Интерфейс                                              │ Атрибут              │ Значение │
       ├───────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │mq_send(), mq_timedsend()                              │ Безвредность в нитях │ MT-Safe  │
       └───────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

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

ЗАМЕЧАНИЯ

       В  Linux  mq_timedsend()  является системным вызовом, а mq_send() — библиотечной функцией,
       реализованной на основе этого системного вызова:

СМ. ТАКЖЕ

       mq_close(3),  mq_getattr(3),  mq_notify(3),   mq_open(3),   mq_receive(3),   mq_unlink(3),
       timespec(3), mq_overview(7), time(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⟩.