UNIX: разработка сетевых приложений

 short revents; /* события, произошедшие на дескрипторе fd */

};

Проверяемые условия задаются элементом events, и состояние этого дескриптора функция возвращает в соответствующем элементе revents. (Наличие двух переменных для каждого дескриптора, одна из которых — значение, а вторая — результат, дает возможность обойтись без аргументов типа «значение-результат». Вспомните, что три средних аргумента функции selectимеют тип «значение-результат».) Каждый из двух элементов состоит из одного или более битов, задающих определенное условие. В табл. 6.2 перечислены константы, используемые для задания флага eventsи для проверки флага revents.

Таблица 6.2. Различные значения флагов events и revents для функции poll

Константа	На входе (events)	На выходе (revents)	Описание
POLLIN	•	•	Можно считывать обычные или приоритетные данные
POLLRDNORM	•	•	Можно считывать обычные данные
POLLRDBAND	•	•	Можно считывать приоритетные данные
POLLPRI	•	•	Можно считывать данные с высоким приоритетом
POLLOUT	•	•	Можно записывать обычные данные
POLLWRNORM	•	•	Можно записывать обычные данные
POLLWRBAND	•	•	Можно записывать приоритетные данные
POLLERR		•	Произошла ошибка
POLLHUP		•	Произошел разрыв соединения
POLLNVAL		•	Дескриптор не соответствует открытому файлу

Мы разделили эту таблицу на три части: первые четыре константы относятся ко вводу, следующие три — к выводу, а последние три — к ошибкам. Обратите внимание, что последние три константы не могут устанавливаться в элементе events, но всегда возвращаются в revents, когда выполняется соответствующее условие.

Существует три класса данных, различаемых функцией poll: обычные, приоритетныеи данные с высоким приоритетом. Эти термины берут начало в реализациях, основанных на потоках (см. рис. 31.5).

ПРИМЕЧАНИЕ

Константа POLLIN может быть задана путем логического сложения констант POLLRDNORM и POLLRDBAND. Константа POLLIN существовала еще в реализациях SVR3, которые предшествовали полосам приоритета в SVR4, то есть эта константа существует в целях обратной совместимости. Аналогично, константа POLLOUT эквивалентна POLLWRNORM, и первая из них предшествовала второй.

Для сокетов TCP и UDP при описанных условиях функция pollвозвращает указанный флаг revent. К сожалению, в определении функции pollстандарта POSIX имеется множество слабых мест (неоднозначностей):

 Все регулярные данные TCP и все данные UDP считаются обычными.

 Внеполосные данные TCP (см. главу 24) считаются приоритетными.

 Когда считывающая половина соединения TCP закрывается (например, если получен сегмент FIN), это также считается равнозначным обычным данным, и последующая операция чтения возвратит нуль.

 Наличие ошибки для соединения TCP может расцениваться либо как обычные данные, либо как ошибка ( POLLERR). В любом случае последующая функция read возвращает -1, что сопровождается установкой переменной errnoв соответствующее значение. Это происходит при получении RST или истечении таймера.

 Информация о доступности нового соединения на прослушиваемом сокете может считаться либо обычными, либо приоритетными данными. В большинстве реализаций эта информация рассматривается как обычные данные.

Число элементов в массиве структур задается аргументом nfds.

ПРИМЕЧАНИЕ

Исторически этот аргумент имел тип long без знака, что является некоторым излишеством. Достаточно будет типа int без знака. В Unix 98 для этого аргумента определяется новый тип — nfds_t.

Аргумент timeoutопределяет, как долго функция находится в ожидании перед завершением. Положительным значением задается количество миллисекунд — время ожидания. В табл. 6.3 показаны возможные значения аргумента timeout.

Таблица 6.3. Значения аргумента timeout для функции poll