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

9.8. Функция sctp_freeladdrs

Функция

освобождает ресурсы, выделенные при вызове .

Здесь

указывает на список адресов, возвращаемый .

9.9. Функция sctp_sendmsg

Приложение может управлять параметрами SCTP, используя функцию

со вспомогательными данными (см. главу 14). Однако из-за неудобств, связанных с применением вспомогательных данных, многие реализации SCTP предоставляют дополнительный библиотечный вызов (который на самом деле может быть и системным вызовом), упрощающий обращение к расширенным функциям SCTP. Вызов функции должен иметь следующий формат:

Использование

значительно упрощает отправку параметров, но требует указания большего количества аргументов. В поле помещается дескриптор сокета, возвращенный системным вызовом socket. Аргумент указывает на буфер размера , содержимое которого должно быть передано собеседнику. В поле помещается длина адреса, передаваемого через аргумент . В поле помещается идентификатор протокола, который будет передан вместе с порцией данных. Поле передается стеку SCTP. Разрешенные значения этого поля приводятся в табл. 7.5.

Номер потока SCTP указывается вызывающим приложением в аргументе

. Процесс может указать время жизни сообщения в миллисекундах в поле . Значение 0 соответствует бесконечному времени жизни. Пользовательский контекст, при наличии такового, может быть указан в поле . Пользовательский контекст связывает неудачную передачу сообщения (о которой получено уведомление) с локальным контекстом, имеющим отношение к приложению. Например, чтобы отправить сообщение в поток 1 с флагом отправки , временем жизни равным 1000 мс, идентификатором протокола 24 и контекстом 52, процесс должен сделать следующий вызов:

Этот подход значительно проще выделения памяти под необходимые вспомогательные данные и настройки структур, входящих в

. Обратите внимание, что если функция реализована через вызов , то поле в последнем устанавливается равным 0.

9.10. Функция sctp_recvmsg

Функция

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

По возвращении из этого вызова аргумент

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

9.11. Функция sctp_opt_info

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

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