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

Стивенс Уильям Ричард

ret =

sctp_sendmsg(sockfd, data, datasz, &dest, sizeof(dest), 24,

MSG_PR_SCTP_TTL, 1, 1000, 52);

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

msghdr

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

sctp_sendmsg

реализована через вызов

sendmsg

, то поле

flags

в последнем устанавливается равным 0.

9.10. Функция sctp_recvmsg

Функция

sctp_recvmsg

, подобно

sctp_sendmsg

, предоставляет удобный интерфейс к расширенным возможностям SCTP.

С ее помощью пользователь может получить не только адрес собеседника, но и поле

msg_flags

, которое обычно заполняется при вызове

recvmsg

(например,

MSG_NOTIFICATION

,

MSG_EOR

и так далее). Кроме того, функция дает возможность получить структуру

sctp_sndrcvinfo

, которая сопровождает сообщение, считанное в буфер. Обратите внимание, что если приложение хочет получать информацию, содержащуюся в структуре

sctp_sndrcvinfo

, оно должно быть подписано на событие

sctp_data_io_event

с параметром сокета

SCTP_EVENTS

(по умолчанию эта подписка включена).

ssize_t sctp_recvmsg(int sockfd, void * msg, size_t msgsz,

struct sockaddr * from, socklen_t * fromlen,

struct sctp_sndrcvinfo * sinfo, int *msg_ flags);

Возвращает, количество считанных байтов в случае успешного завершения, -1 в случае ошибки

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

msg

оказывается заполненным не более, чем

msgsz

байтами данных. Адрес отправителя сообщения помещается в аргумент

from

, а размер адреса — в аргумент

fromlen

. Флаги сообщения будут помещены в аргумент

msg_flags

. Если уведомление

sctp_data_io_event

включено (а по умолчанию это так и есть), структура

sctp_sndrcvinfo

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

sctp_recvmsg

реализована через вызов

recvmsg

, то поле

flags

в последнем устанавливается равным нулю.

9.11. Функция sctp_opt_info

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

getsockopt

для протокола SCTP. Дело в том, что некоторые параметры сокетов SCTP (например,

SCTP_STATUS

) требуют использования переменных типа «значение-результат» для передачи идентификатора ассоциации. Если функция

getsockopt

не поддерживает работу с такими переменными, разработчику придется вызывать

sctp_opt_info

. В системах типа FreeBSD, разрешающих указывать переменные типа «значение-результат» с параметрами сокетов, функция

sctp_opt_info

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

getsockopt

в нужном формате. В целях обеспечения переносимости разработчикам приложений рекомендуется использовать

sctp_opt_info

для всех параметров, требующих работы с переменными типа «значение-результат» (см. раздел 7.10).

int sctp_opt_info(int sockfd, sctp_assoc_t assoc_id, int opt,

void * arg, socklen_t * siz);

Возвращает: 0 в случае успешного завершения, -1 в случае ошибки

Здесь

sockfd

—

дескриптор сокета, с параметрами которого хочет работать пользователь. Аргумент

assoc_id

задает идентификатор ассоциации, которую нужно выделить из списка всех ассоциаций данного сокета. Аргумент

opt

задает параметр сокета для SCTP (список параметров приводится в разделе 7.10).

Arg

— аргумент параметра сокета,

siz

— указатель на переменную типа

socklen_t

, в которой хранится размер аргумента параметра сокета.

9.12. Функция sctp_peeloff

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

accept

с дополнительным аргументом. Процесс передает дескриптор

sockfd

сокета типа «один-ко-многим» и идентификатор

id

выделяемой ассоциации. Функция возвращает дескриптор нового сокета. Этот дескриптор имеет тип «один-к-одному», и он изначально связан с выбранной ассоциацией.

int sctp_peeloff(int sockfd, sctp_assoc_t id);

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

9.13. Функция shutdown

Обсуждавшаяся в разделе 9.6 функция

shutdown

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

shutdown

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

shutdown

вместо

close

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

close

, а затем создавать его снова здесь не требуется. SCTP разрешает конечной точке вызвать

shutdown

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

Рис. 9.4. Закрытие ассоциации SCTP вызовом shutdown

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

MSG_NOTIFICATION

. Если же он не подписался на эти события, функция

read

считает нулевое количество байтов. Результаты вызова shutdown для TCP были описаны в разделе 6.6. В документации howtoна функцию

shutdown

для SCTP перечислены следующие константы:

SHUT_RD

— та же семантика, что и для TCP (см. раздел 6.6); никаких особых действий протокол SCTP не предусматривает;

SHUT_WR

— запрещает отправку сообщений и инициирует процедуру завершения ассоциации SCTP. Этот параметр не дает возможности работать в наполовину закрытом состоянии, однако позволяет локальной конечной точке считать все данные, которые собеседник отправит до получения сообщения SCTP SHUTDOWN;

SHUT_RDWR

— запрещает вызовы read и write и инициирует процедуру завершения ассоциации SCTP. Данные, передававшиеся в момент вызова

shutdown

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