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

Обе составляющие сообщения — и сами данные, и управляющая информация — описываются структурой

:

С помощью функции

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

При отсутствии управляющей информации функцией

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

Последний аргумент функции

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

Предположим, что мы передаем функции

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

Если функция

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

31.4. Функции getpmsg и putpmsg

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

и .

Аргумент

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

Два целочисленных значения, на которые указывают аргументы

и функции , являются аргументами типа «значение-результат». Целочисленное значение, на которое указывает аргумент функции , может соответствовать (для чтения сообщений с высоким приоритетом), (для чтения сообщений из полосы приоритета, по меньшей мере равной целочисленному значению, на которое указывает аргумент ) или (для чтения любых сообщений). По завершении функции целочисленное значение, на которое указывает аргумент , указывает на полосу приоритета прочитанного сообщения, а целое число, на которое указывает аргумент , соответствует (если было прочитано сообщение с высоким приоритетом) или MSG_BAND (если было прочитано иное сообщение).