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

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

Билл Феннер , Уильям Ричард Стивенс , Эндрю М. Рудофф

ПРИМЕЧАНИЕ

Обратите внимание на аналогию между структурами strbuf и netbuf. Имена элементов обеих структур одинаковы.

Однако обе длины в структуре netbuf относятся к типу данных unsigned int (целое без знака), тогда как обе длины в структуре srtbuf — к типу int (целое со знаком). Причина в том, что некоторые потоковые функции используют значение -1 элементов len и maxlen для указания на определенные специальные ситуации.

С помощью функции putmsgмы можем отправлять или данные, или управляющую информацию, или и то и другое вместе. Для указания на отсутствие управляющей информации мы можем или задать ctlptrкак пустой указатель, или установить значение ctlptr-lenравным -1. Этот же способ используется для указания на отсутствие данных.

При отсутствии управляющей информации функцией putmsgгенерируется сообщение типа M_DATA(см. табл. 31.1), в противном случае генерируется сообщение типа M_PROTOлибо M_PCPROTOв зависимости от значения аргумента flags. Этот аргумент функции putmsgимеет нулевое значение для обычных сообщений, а для сообщений с высоким приоритетом его значение равно RS_HIPRI.

Последний аргумент функции getmsgимеет тип «значение-результат». Если при вызове функции целочисленное значение, на которое указывает аргумент flagsp, — это 0, то возвращается первое сообщение из потока (которое может быть как обычным, так и имеющим высокий приоритет). Если при вызове функции целочисленное значение соответствует RS_HIPRI, то функция будет ждать появления в головном модуле потока сообщения с высоким приоритетом. В обоих случаях в зависимости от типа возвращенного сообщения значение, на которое указывает аргумент flagsp, будет либо 0, либо RS_HIPRI.

Предположим, что мы передаем функции getmsgнепустые указатели ctlptrи dataptr. Тогда указанием на отсутствие управляющей информации (возвращается сообщение типа M_DATA) является значение ctlptr-len, установленное в -1. Аналогично, если отсутствуют данные, указанием на это является значение -1 элемента dataptr-len.

Если функция putmsgвыполнилась успешно, то она возвращает нулевое значение, а в случае ошибки возвращается значение -1. Но функция getmsgвозвращает нулевое значение только в том случае, если вызывающему процессу было доставлено все сообщение целиком. Если буфер, предназначенный для приема управляющей информации, слишком мал, то возвращается значение MORECTL(о котором заранее известно, что оно является неотрицательным). Аналогично, если буфер для приема данных оказывается слишком мал, возвращается значение MOREDATA. Если же оба эти буфера оказываются слишком малы, то возвращается логическая сумма этих двух флагов.

<p>31.4. Функции getpmsg и putpmsg</p>

Когда с выпуском SVR4 к потоковым системам была добавлена поддержка различных полос приоритета, появились новые варианты функций getmsgи putmsg.

#include stropts.h

int getpmsg(int fd, struct strbuf * ctlptr,

struct strbuf * dataptr, int * bandp, int * flagsp);

int putpmsg(int fd, const struct strbuf * ctlptr,

const struct strbuf * dataptr, int band, int flags);

Обе функции возвращают: неотрицательное значение в случае успешного выполнения, -1 в случае ошибки

Аргумент bandфункции putpmsgдолжен иметь значение в пределах от 0 до 255 включительно. Если аргумент flagsимеет значение MSG_BAND, то генерируется сообщение в соответствующей полосе приоритета. Присваивание аргументу flagsзначения MSG_BANDи задание полосы 0 эквивалентно вызову функции putmsg. Если значение аргумента flagsравно MSG_HIPRI, то аргумент bandдолжен быть равен нулю, и тогда генерируется сообщение с высоким приоритетом. (Обратите внимание на то, что этот флаг имеет название, отличающееся от названия RS_HIPRI, используемого в случае функции putmsg.)