5.3. Функции mq_getattr и mq_setattr
5.3. Функции mq_getattr и mq_setattr
У каждой очереди сообщений имеются четыре атрибута, которые могут быть получены функцией mq_getattr и установлены (по отдельности) функцией mq_setattr:
#include <mqueue.h>
int mq_getattr(mqd_t mqdes, struct mq_attr *attr);
int mq_setattr(mqd_t mqdes, const struct mq_attr *attr, struct mq_attr *oattr);
/* Обе функции возвращают 0 в случае успешного завершения; –1 – в случае возникновения ошибок */
Структура mq_attr хранит в себе эти четыре атрибута:
struct mq_attr {
long mq_flags; /* флаг очереди: 0, O_NONBLOCK */
long mq_maxmsg; /* максимальное количество сообщений в очереди */
long mq_msgsize; /* максимальный размер сообщения (в байтах) */
long mq_curmsgs; // текущее количество сообщений в очереди
}
Указатель на такую структуру может быть передан в качестве четвертого аргумента mq_open, что дает возможность установить параметры mq_maxmsg и mq_msgsize в момент создания очереди. Другие два поля структуры функцией mq_open игнорируются.
Функция mq_getattr присваивает полям структуры, на которую указывает attr, текущие значения атрибутов очереди.
Функция mq_setattr устанавливает атрибуты очереди, но фактически используется только поле mqflags той структуры, на которую указывает attr, что дает возможность сбрасывать или устанавливать флаг запрета блокировки. Другие три поля структуры игнорируются: максимальное количество сообщений в очереди и максимальный размер сообщения могут быть установлены только в момент создания очереди, а количество сообщений в очереди можно только считать, но не изменить.
Кроме того, если указатель oattr ненулевой, возвращаются предыдущие значения атрибутов очереди (mq_flags, mq_maxmsg, mq_msgsize) и текущий статус очереди (mq_curmsgs).
Данный текст является ознакомительным фрагментом.