LinuxDoc.Rumsgop - работает с сообщениями
НАЗВАНИЕmsgop - работает с сообщениями
СИНТАКСИС
#include
#include
#include
int msgsnd(int msqid, struct msgbuf *msgp, size_t msgsz,
int msgflg);
ssize_t msgrcv(int msqid, struct msgbuf *msgp, size_t
msgsz, long msgtyp, int msgflg);
ОПИСАНИЕ
Для того, чтобы отослать или получить сообщения,
вызывающий процесс создает следующую структуру:
struct msgbuf {
long mtype; /* тип сообщения должен
быть > 0 */
char mtext[1]; /* содержимое сообщения
*/
};
, а размер массива mtext равен неотрицательному целому
числу msgsz. Поле mtype должно быть обозначено как
положительное целое число, используемое
процессом-получателем для выбора сообщений (см. раздел,
касающийся msgrcv).
При отправке сообщения вызывающий процесс должен иметь
права на запись данных в эту очередь, а при получении -
права на чтение.
Системный вызов msgsnd помещает сообщение, указанное
параметром msgp, в очередь сообщений, идентификатор
которой указывается в параметре msqid.
Параметр msgflg определяет поведение системы при помещении
в очередь сообщения, размер которого больше msg_qbytes.
При значении IPC_NOWAIT сообщение не будет послано, а
системный вызов возвратит ошибку, записав в переменную
errno значение EAGAIN. В противном случае работа процесса
приостанавливается до тех пор, пока причина остановки не
будет устранена (в этом случае сообщение будет послано, и
системный вызов будет выполнен успешно), или очередь
сообщений не будет удалена (в этом случае системный вызов
вернет ошибку, установив значение errno равным EIDRM), или
процесс не получит сигнал, который должен быть обработан
(системный вызов вернет ошибку, установив значение errno
равным EINTR).
При удачном завершении операции структура данных очереди
сообщений будет обновлена следующим образом: значение
msg_lspid будет установлено равным идентификатору
вызывающего процесса. Значение
msg_qnum будет увеличено на 1. Значение
msg_stime будет установлено равным текущему
времени.
Системный вызов msgrcv записывает сообщение из очереди
(идентификатор которой указан в msqid) в буфер msgbuf
(находящийся в msgp), удаляя сообщение при удачном
завершении операции.
Параметр msgsz задает максимальный размер элемента mtext
структуры, находящейся по адресу, указанному в аргументе
msgp. Если длина текста сообщения больше, чем msgsz, и
флаг msgflg установлен в MSG_NOERROR, то текст сообщения
будет урезан (а урезанная часть потеряна), иначе сообщение
не удаляется из очереди, а системный вызов возвращает
ошибку, установив значение errno , равное E2BIG.
Параметр msgtyp задает тип сообщения следующим образом:
если msgtyp равен нулю, то используется первое
сообщение из очереди;
если msgtyp больше нуля, то из очереди берется
первое сообщение типа msgtyp (если только во флаге
msgflg нет бита MSG_EXCEPT. В этом случае из
очереди берется первое сообщение, тип которого не
равен msgtyp).
Если msgtyp меньше нуля, то из очереди берется
первое сообщение со значением, меньшим, чем
абсолютное значение msgtyp.
Параметр msgflg состоит из комбинации следующих флагов:
IPC_NOWAIT , который указывает на немедленный
возврат из функции, если в очереди нет сообщений
необходимого типа. При этом системный вызов
возвращает ошибку, устанавливая значение errno
равным ENOMSG;
MSG_EXCEPT , который используется (если msgtyp
больше, чем 0) для чтения первого сообщения, тип
которого не равен msgtyp;
MSG_NOERROR , используемый для урезания текста
сообщения, размер которого больше msgsz байтов.
Если в очереди нет сообщения необходимого типа, и в msgflg
не установлен флаг IPC_NOWAIT, то вызывающий процесс будет
заблокирован до тех пор, пока не произойдет одно из
следующих событий:
сообщение необходимого типа помещено в очередь;
очередь сообщений удалена из системы (в этом случае
системный вызов возвращает ошибку, устанавливая
значение errno , равное EIDRM).
Вызывающий процесс получает сигнал, который он
должен обработать. В этом случае системный вызов
возвращает ошибку, устанавливая значение переменной
errno , равное EINTR.
При удачном завершении операции структура данных очереди
сообщений будет обновлена следующим образом: значение
msg_lrpid будет обозначать идентификатор
вызывающего процесса;
msg_qnum уменьшается на 1; значение
msg_rtime будет равно значению текущего времени.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При ошибке обе функции возвращают -1, а переменная errno
приобретает соответствующее значение. В противном случае
msgsnd возвращает 0, а msgrvc возвращает количество
байтов, скопированных в массив mtext.
КОДЫ ОШИБОК
Значения errno, устанавливаемые при выполнении функции
msgsnd:
EAGAIN Сообщение не может быть помещено в очередь,
потому что размер очереди превысит лимит,
равный msg_qbytes , а в параметре mgsflg
установлен флаг IPC_NOWAIT.
EACCES Вызывающий процесс не имеет прав записи в
очередь.
EFAULT Память с адресом, указанным msgp, недоступна.
EIDRM Очередь сообщений была удалена из системы.
EINTR Процесс ждал свободного места в очереди и
получил сигнал, который он должен обработать.
EINVAL Задано неправильное значение msqid,
неположительное значение mtype или неправильное
значение msgsz (меньшее, чем 0, или большее,
чем системный лимит, заданный MSGMAX).
ENOMEM В системе недостаточно памяти для копирования
содержимого буфера msgbuf.
Значения errno, устанавливаемые при выполнении функции
msgrcv:
E2BIG Длина текста получаемого сообщения больше, чем
msgsz, а в поле msgflg не установлен флаг
MSG_NOERROR.
EACCES Вызывающий процесс не имеет прав на чтение
очереди сообщений.
EFAULT Память с адресом, указанным msgp, недоступна.
EIDRM Процесс ждал появления сообщения в очереди, и в
это время она была удалена.
EINTR Процесс ждал появления сообщения в очереди и
получил сигнал, который должен обработать.
EINVAL Задано неправильное значение msqid, или
значение msgsz меньше, чем 0.
ENOMSG В очереди нет сообщения необходимого типа, а в
параметре msgflg установлен флаг IPC_NOWAIT.
ЗАМЕЧАНИЯ
На работу системного вызова msgsnd влияют следующие
системные лимиты:
MSGMAX Максимальный размер текста сообщения: по
умолчанию он равен 4080-и байтам.
MSGMNB Максимальный размер очереди сообщений зависит
от настроек системы. Суперпользователь может
устанавливать больший размер очереди сообщений,
чем MSGMNB, при помощи системного вызова
msgctl.
В принципе, нет существенных ограничений в количестве
заголовков сообщений (MSGTQL) и в размере пула сообщений
(MSGPOOL).
СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, SVID.
ЗАМЕЧАНИЕ
Аргумент-указатель обозначен как struct msgbuf * в libc4,
libc5, glibc 2.0, glibc 2.1. В glibc 2.2, в соответствии с
SUSv2, он обозначен как void *.