Unix Man (Справочное руководство)


GETMSG(2) - часть 2


По умолчанию системный вызов getmsg извлекает из очереди чтения в истоке первое сообщение, независимо от того, является оно приоритетным или нет. Пользователь, однако, может потребовать выдачи только приоритетного сообщения, установив по адресу flags значение RS_HIPRI. В этом случае будет извлечено первое из приоритетных сообщений, стоящих в очереди, даже если перед ним находятся несколько неприоритетных.

Если не установлен режим доступа без ожидания (флаг O_NDELAY), процесс, вызвавший getmsg, откладывается до тех пор, пока сообщение указанного типа (приоритетное или любое) не появится в очереди чтения в истоке потока. Если флаг O_NDELAY установлен, а сообщения указанного типа в очереди чтения нет, getmsg завершается неудачей и присваивает переменной errno значение EAGAIN.

Если в потоке, из которого извлекается сообщение, происходит освобождение линии, то системный вызов getmsg будет нормально работать, пока очередь чтения в истоке не станет пустой. После этого getmsg присвоит 0 компонентам len тех структур, на которые указывают аргументы ctlptr и dataptr.

Системный вызов getmsg завершается неудачей, если выполнено хотя бы одно из следующих условий:

[EAGAIN] Установлен флаг O_NDELAY, а сообщения указанного типа в очереди чтения нет. [EBADF] Аргумент fd не является корректным дескриптором открытого файла. [EBADMSG] Сообщение, которое должно читаться, не является корректным для getmsg. [EFAULT] Аргумент ctlptr, dataptr, или flags указывает за пределы отведенного процессу адресного пространства. [EINTR] Во время выполнения системного вызова перехвачен сигнал. [EINVAL] Аргумент flags имеет некорректное значение, или поток, на который ссылается fd, мультиплексируется. [ENOSTR] С дескриптором fd не ассоциирован поток.

Кроме того, системный вызов getmsg завершается неудачей, если, до обращения к getmsg, в истоке потока получено сообщение об ошибке псевдоустройства. В этом случае переменной errno присваивается значение, содержащееся в сообщении.

СМ. ТАКЖЕ


, , , , .

ДИАГНОСТИКА


При успешном завершении возвращается неотрицательное целое значение. Значение 0 означает, что все сообщение было успешно прочитано. Значение, равное MORECTL, означает, что осталась непрочитанной часть управляющей области. Значение, равное MOREDATA, означает, что осталась непрочитанной часть области данных. Значение, равное MOREDATA | MORECTL, означает, что осталась непрочитанной как часть области данных, так и часть управляющей области. Последующие вызовы getmsg позволяют извлечь остаток сообщения.

В случае ошибки возвращается -1, а переменной errno присваивается код ошибки.




Начало  Назад  Вперед



Книжный магазин