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

union sctp_notification {
 struct sctp_tlv sn_header;
 struct sctp_assoc_change sn_assoc_change;
 struct sctp_paddr_change sn_paddr_change;
 struct sctp_remote_error sn_remote_error;
 struct sctp_send_failed sn_send_failed;
 struct sctp_shutdown_event sn_shutdown_event;
 struct sctp_adaption_event sn_adaption_event;
 struct sctp_pdapi_event sn_pdapi_event;
};
Обратите внимание, что для интерпретации значения типа используется поле 
sn_header
. Таблица 9.2 содержит значения, которые могут помещаться в поля 
sn_header
, 
sn_type
, а также соответствующие значения поля подписки, которые используются с параметром сокета 
SCTP_EVENTS
.
Таблица 9.2. Тип и поле подписки
 
 
sn_type
 
Поле подписки
 
 
 
SCTP_ASSOC_CHANGE
 
sctp_association_event
 
 
 
SCTP_PEER_ADDR_CHANGE
 
sctp_address_event
 
 
 
SCTP_REMOTE_ERROR
 
sctp_peer_error_event
 
 
 
SCTP_SEND_FAILED
 
sctp_send_failure_event
 
 
 
SCTP_SHUTDOWN_EVENT
 
sctp_shutdown_event
 
 
 
SCTP_ADAPTION_INDICATON
 
sctp_adaption_layer_event
 
 
 
SCTP_PARTIAL_DELIVERY_EVENT
 
sctp_partial_delivery_event
 
 
У каждого уведомления имеется своя собственная структура, которая содержит подробную информацию о произошедшем событии.
■ 
SCTP_ASSOC_CHANGE
Это уведомление сообщает приложению о том, что произошло изменение, связанное с ассоциациями: возникла новая ассоциация или завершилась существующая. Структура данных имеет следующий формат:
struct sctp_assoc_change {
 u_int16_t sac_type;
 u_int16_t sac_flags;
 u_int32_t sac_length;
 u_int16_t sac_state;
 u_int16_t sac_error;
 u_int16_t sac_outbound_streams;
 u_int16_t sac_inbound_streams;
 sctp_assoc_t sac_assoc_id;
 uint8_t sac_info[];
};
Поле 
sac_state
 определяет тип события, связанного с ассоциацией. Оно может принимать следующие значения:
 □ 
SCTP_COMM_UP
 — создана новая ассоциация. Поля входящих и исходящих потоков (
inbound_streams
 и 
outbound_streams
) говорят о том, сколько потоков доступно в соответствующих направлениях. Идентификатор ассоциации позволяет взаимодействовать со стеком SCTP;
 □ 
SCTP_COMM_LOST
 — ассоциация закрыта из-за превышения порога недоступности (заданное количество раз был превышен тайм-аут) или собеседник выполнил аварийное закрытие ассоциации (при помощи параметра сокета 
SO_LINGER
 или вызовом 
sendmsg
 с флагом 
MSG_ABORT
). Пользовательские данные могут быть помещены в поле 
sac_info
;
  
 □ 
SCTP_RESTART
 — собеседник перезапущен. Наиболее типичной причиной этого уведомления бывает выход из строя и перезапуск собеседника. Приложение должно проверить количество потоков в обоих направлениях, потому что при перезапуске эти значения могут измениться;
 □ 
SCTP_SHUTDOWN_COMP
 — закончено завершение соединения, инициированное локальной конечной точкой (вызовом 
shutdown
 или 
sendmsg
 с флагом 
MSG_EOF
). После получения этого сообщения сокет типа «один-к-одному» может быть использован для подключения к другому собеседнику;
 □ 
SCTP_CANT_STR_ASSOC
 — собеседник не ответил при попытке установления ассоциации.
Поле 
sac_error
 содержит коды причин ошибок протокола SCTP, которые могли привести к изменению состояния ассоциации. Поля 
sac_inbound_streams
 и 
sac_outbound_streams
 говорят о том, какое количество потоков в каждом направлении было согласовано во время установки ассоциации. Поле sac_
assoc
_id содержит уникальный идентификатор ассоциации, который может использоваться как при работе с параметрами сокета, так и в последующих уведомлениях. Наконец, поле 
sac
_info может содержать дополнительные пользовательские сведения. Например, если ассоциация была разорвана собеседником в связи с ошибкой, определенной пользователем, код этой ошибки будет помещен в поле 
sac_info
.
■ 
SCTP_PEER_ADDR_CHANGE
 Это уведомление говорит об изменении состояния одного из адресов собеседника. Изменение может заключаться либо в отказе (отсутствии подтверждения отправленных на этот адрес данных), либо в восстановлении (ответе отказавшего ранее адреса). Структура данных имеет следующий формат:
struct sctp_paddr_change {
 u_int16_t spc_type;
 u_int16_t spc_flags;
 u_int32_t spc_length;
 struct sockaddr_storage spc_aaddr;
 u_int32_t spc_state;
 u_int32_t spc_error;
 sctp_assoc_t spc_assoc_id;
};
Поле 
spc_aaddr
 содержит адрес собеседника, с которым связано данное событие. Поле 
spc_state
 может принимать одно из значений, перечисленных в табл. 9.3.
Таблица 9.3. Уведомление о состоянии адреса собеседника
 
 
spc_state
 
Значение
 
 
 
SCTP_ADDR_ADDED
 
Адрес добавлен к ассоциации
 
 
 
SCTP_ADDR_AVAILABLE
 
Адрес доступен
 
 
 
SCTP_ADDR_CONFIRMED
 
Адрес подтвержден и считается действующим
 
 
 
SCTP_ADDR_MADE_PRIM
 
Адрес сделан основным
 
 
 
SCTP_ADDR_REMOVED
 
Адрес удален из списка адресов ассоциации
 
 
 
SCTP_ADDR_UNREACHABLE
 
Адрес недоступен