|
Сервер содержит море(!) аналитической информации
|
CIT Forum CD-ROM
|
|
MSGCTL(2) MSGCTL(2)
НАЗВАНИЕ
msgctl - операции управления очередью сообщений
СИНТАКСИС
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/msg.h>
int msgctl (msqid, cmd, buf)
int msqid, cmd;
struct msqid_ds *buf;
ОПИСАНИЕ
Системный вызов msgctl позволяет выполнять операции управления очередью сообщений. Операция определяется значением аргумента cmd, которое должно быть одним из следующих:
- IPC_STAT
- Поместить текущее значение каждого поля структуры
данных, ассоциированной с идентификатором очереди
сообщений msqid, в структуру, на которую указывает
buf. Содержимое структуры описано в intro(2).
{Требуется право на чтение.}
- IPC_SET
- Присвоить следующим полям структуры данных, ассоциированной с идентификатором msqid, соответствующие значения, находящиеся в структуре, на которую
указывает buf:
msg_perm.uid
msg_perm.gid
msg_perm.mode /* Только младшие 9 бит */
msg_qbytes
Это действие может выполняться только процессом,
действующий идентификатор пользователя которого
равен либо идентификатору суперпользователя, либо
значению поля msg_perm.cuid или msg_perm.uid в
структуре данных, ассоциированной с msqid. Только
суперпользователь может увеличивать значение поля
msg_qbytes.
- IPC_RMID
- Удалить из системы идентификатор очереди сообщений, определяемый значением msqid, ликвидировать
очередь сообщений и ассоциированную с ней структуру данных. Эта команда может выполняться только
процессом, который имеет действующий идентификатор
пользователя, равный либо идентификатору суперпользователя, либо значению поля msg_perm.cuid или
msg_perm.uid в структуре данных, ассоциированной с
msqid.
Системный вызов msgctl завершается неудачей, если выполнено хотя бы одно из следующих условий:
- [EINVAL]
- Значение аргумента msgid не является корректным идентификатором очереди сообщений.
- [EINVAL]
- Некорректное значение аргумента cmd, определяющее выполняемое действие.
- [EACCES]
- Значение аргумента cmd равно IPC_STAT и нет
прав на чтение у вызывающего процесса
- [см.
intro(2)].
- [EPERM]
- Значение аргумента cmd равно IPC_RMID или
IPC_SET и действующий идентификатор пользователя вызывающего процесса не равен ни
идентификатору суперпользователя, ни значению поля msg_perm.cuid или msg_perm.uid в
структуре данных, ассоциированной с msqid.
- [EPERM]
- Значение аргумента cmd равно IPC_SET и была
предпринята попытка увеличить значение поля
msg_qbytes, а действующий идентификатор
пользователя вызывающего процесса не равен
идентификатору суперпользователя.
- [EFAULT]
- Аргумент buf указывает за пределы отведенного процессу адресного пространства.
СМ. ТАКЖЕ
intro(2), msgget(2), msgop(2).
ДИАГНОСТИКА
При успешном завершении результат равен 0; в случае
ошибки возвращается -1, а переменной errno присваивается код ошибки.
