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

На рис. 27.6 показан формат объектов вспомогательных данных, используемый для отправки и получения параметров транзитных узлов и параметров получателя.

Рис. 27.6. Объекты вспомогательных данных, используемые для параметров транзитных узлов и параметров получателя

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

#include netinet/in.h

int inet6_opt_init(void * extbuf, socklen_t extlen);

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

int inet6_opt_append(void * extbuf, socklen_t extlen,

 int offset, uint8_t type, socklen_t len, uint_t align, void ** databufp);

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

int inet6_opt_finish(void * extbuf, socklen_t extlen, int offset);

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

int inet6_opt_set_val(void * databuf, int offset,

 const void * val, socklen_t vallen);

Возвращает: новое смещение в буфере databuf

Функция inet6_opt_initвозвращает количество байтов, необходимое для данного параметра. Если аргумент extbufне является нулевым указателем, функция инициализирует заголовок расширения. Значение -1 возвращается при аварийном завершении работы в том случае, если аргумент extlenне кратен 8. (Все заголовки параметров транзитных узлов и получателя в IPv6 должны быть кратны 8.)

Функция inet6_opt_appendвозвращает общую длину заголовка расширения после добавления указанного при вызове параметра. Если аргумент extbufне является нулевым указателем, функция дополнительно выполняет инициализацию параметра и вставляет необходимое заполнение. Значение -1 возвращается в случае аварийного завершения работы, если параметр не помещается в выделенный буфер. Аргумент offsetпредставляет собой текущую полную длину, то есть значение, возвращенное при предыдущем вызове inet6_opt_appendили inet6_opt_init. Аргументы typeи lenзадают тип и длину параметра, они копируются непосредственно в его заголовок. Аргумент alignуказывает условие выравнивания, то есть значение x из выражения xn + y. Значение у вычисляется по alignи len, поэтому указывать его явным образом необходимости нет. Аргумент databufpпредставляет собой адрес будущего указателя на значение параметра. Значение параметра копируется вызывающим процессом при помощи функции inet6_opt_set_valили любым другим методом.

Для завершения расширяющего заголовка вызывается функция inet6_opt_finish, которая добавляет в заголовок заполнение, делая его длину кратной 8 байтам. Как и раньше, заполнение добавляется в буфер только в том случае, если аргумент extbufпредставляет собой непустой указатель. В противном случае функция вычисляет обновленное значение длины. Подобно inet6_opt_append, аргумент offsetзадает текущую полную длину (значение, возвращаемое inet6_opt_appendи inet6_opt_init). Функция inet6_opt_finishвозвращает полную длину возвращаемого заголовка или -1, если требуемое заполнение не помещается в предоставленный буфер.

Функция inet6_opt_set_valкопирует значение параметра в буфер данных, возвращаемый inet6_opt_append. Аргумент databufпредставляет собой указатель, возвращаемый inet6_opt_append. Аргумент offsetпредставляет собой текущую длину внутри параметра, его необходимо инициализировать нулем для каждого параметра, а затем использовать возвращаемые inet6_opt_set_valзначения по мере построения параметра. Аргументы valи vallenопределяют значение для копирования в буфер значения параметра.