Прежде чем вызвать функцию

, мы выделяем в памяти место для буфера и для структуры , а затем инициализируем эту структуру. Мы показываем это на рис. 17.1, предполагая, что наш буфер имеет размер 1024 байта. Третий аргумент функции — это указатель на нашу структуру .

Рис. 17.1. Инициализация структуры ifconf перед вызовом SIOCGIFCONF

Если мы предположим, что ядро возвращает две структуры

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

Рис. 17.2. Значения, возвращаемые в результате вызова SIOCGIFCONF

Указатель на структуру

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

17.6. Функция get_ifi_info

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

, возвращающую связный список структур — по одной для каждого активного в настоящий момент интерфейса. В этом разделе мы покажем, как эта функция реализуется с помощью вызова функции , а в главе 18 мы создадим ее другую версию, использующую маршрутизирующие сокеты.

Сначала мы определяем структуру

в новом заголовочном файле, который называется , показанном в листинге 17.2.

Листинг 17.2. Заголовочный файл unpifi.h

 Связный список этих структур возвращается нашей функцией. Элемент каждой структуры указывает на следующую структуру. Мы возвращаем в этой структуре информацию, которая может быть востребована в типичном приложении: имя интерфейса, индекс интерфейса, MTU, аппаратный адрес (например, адрес Ethernet), флаги интерфейса (чтобы позволить приложению определить, поддерживает ли приложение широковещательную или многоадресную передачу и относится ли этот интерфейс к типу «точка-точка»), адрес интерфейса, широковещательный адрес, адрес получателя для связи «точка-точка». Вся память, используемая для хранения структур вместе со структурами адреса сокета, содержащимися в них, выделяется динамически. Следовательно, мы также предоставляем функцию для освобождения всей этой памяти.

Перед тем как представить реализацию нашей функции

, мы покажем простую программу, которая вызывает эту функцию и затем выводит информацию. Эта программа, представленная в листинге 17.3, является уменьшенной версией программы .

Листинг 17.3. Программа prifinfo, вызывающая нашу функцию ifi_info