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

Функция

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

Функция

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

Для завершения расширяющего заголовка вызывается функция

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

Функция

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

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

, (один раз для каждого параметра) и , передавая нулевой указатель и 0 в качестве аргументов и соответственно. Затем можно динамически выделить буфер, использовав в качестве размера значение, возвращенное . Этот буфер будет передаваться в качестве аргумента при втором проходе. Во время второго прохода вызываются функции и . Копирование значений параметров может выполняться как «вручную», так и при помощи функции . Наконец, мы должны вызвать . Альтернативный вариант действий состоит в выделении буфера достаточно большого размера для нашего параметра. В этом случае первый проход можно не выполнять. Однако если изменение параметров приведет к переполнению выделенного буфера, в программе возникнет ошибка.

Оставшиеся три функции обрабатывают полученный параметр.

Функция

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