Уильям Стивенс - UNIX: разработка сетевых приложений

Листинг 17.1. Структуры ifconf и ifreq, используемые в различных вызовах функции ioctl, относящихся к интерфейсам

// struct ifconf {

int ifc_len; /* размер буфера, "значение-результат" */

union {

caddr_t ifcu_buf; /* ввод от пользователя к ядру */

struct ifreq *ifcu_req; /* ядро возвращает пользователю */

} ifc_ifcu;

};

#define ifc_buf ifc_ifcu.ifcu_buf /* адрес буфера */

#define ifc_req ifc_ifcu.ifcu_req /* массив возвращенных структур */

#define IFNAMSIZ 16

struct ifreq {

char ifr_name[IFNAMSIZ]; /* имя интерфейса, например "le0" */

union {

struct sockaddr ifru_addr;

struct sockaddr ifru_dstaddr;

struct sockaddr ifru_broadaddr;

short ifru_flags;

int ifru_metric;

caddr_t ifru_data;

} ifr_ifru;

};

#define ifr_addr ifr_ifru.ifru_addr /* адрес */

#define ifr_dstaddr ifr_ifru.ifru_dstaddr /* другой конец линии передачи, называемой

"точка-точка" */

#define ifr_broadaddr ifr_ifru.ifru_broadaddr /* широковещательный адрес */

#define ifr_flags ifr_ifru.ifru_flags /* флаги */

#define ifr_metric ifr_ifru.ifru_metric /* метрика */

#define ifr_data ifr_ifru.ifru_data /* с использованием интерфейсом */

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

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

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

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

BSD/OS предоставляет функцию getifaddrs, имеющую аналогичную функциональность.

Поиск по всему дереву исходного кода BSD/OS 2.1 показывает, что 12 программ выполняют вызов SIOCGIFCONF функции ioctl для определения присутствующих интерфейсов.

Сначала мы определяем структуру ifi_infoв новом заголовочном файле, который называется unpifi.h, показанном в листинге 17.2.

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

//ioctl/unpifi.h

1 /* Наш собственный заголовочный файл для программ, которым требуется

2 информация о конфигурации интерфейса. Включаем его вместо "unp.h". */

3 #ifndef __unp_ifi_h

4 #define __unp_ifi_h

5 #include "unp.h"

6 #include

7 #define IFI_NAME 16 /* то же, что и IFNAMSIZ в заголовке */

8 #define IFI_HADDR 8 /* с учетом 64-битового интерфейса EUI-64 в будущем */

9 struct ifi_info {

10 char ifi_name[IFI_NAME]; /* имя интерфейса, заканчивается

символом конца строки */

11 short ifi_index; /* индекс интерфейса */

12 short ifi_mtu; /* MTU для интерфейса */

13 u_char ifi_haddr[IFI_HADDR]; /* аппаратный адрес */

14 u_short ifi_hlen; /* количество байтов в аппаратном адресе: 0, 6, 8 */

15 short ifi_flags; /* константы IFF_xxx из */

16 short if_myflags; /* наши флаги IFI_xxx */

17 struct sockaddr *ifi_addr; /* первичный адрес */

18 struct sockaddr *ifi_brdaddr; /* широковещательный адрес */

19 struct sockaddr *ifi_dstaddr; /* адрес получателя */

20 s truct ifi_info *ifi_next; /* следующая из этих структур */

21 };

22 #define IFI_ALIAS 1 /* ifi_addr - это псевдоним */

23 /* прототипы функций */

24 struct ifi_info *get_ifi_info((int, int);

25 struct ifi_info *Get_ifi_info(int, int);

26 void free_ifi_info(struct ifi_info*);

27 #endif /* _unp_ifi_h */

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

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

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

//ioctl/prifinfo.c

1 #include "unpifi.h"

2 int

3 main(int argc, char **argv)

4 {

5 struct ifi_info *ifi, *ifihead;

6 struct sockaddr *sa;

7 u_char *ptr;

8 int i, family, doaliases;

9 if (argc != 3)

10 err_quit("usage: prifinfo ");

11 if (strcmp(argv[1], "inet4") == 0)

12 family = AF_INET;

13 else if (strcmp(argv[1], "inet6") == 0)

14 family = AF_INET6;

15 else

16 err_quit("invalid ");

17 doaliases = atoi(argv[2]);

18 for (ifihead = ifi = Get_ifi_info(family, doaliases);

19 ifi ! = NULL; ifi = ifi->ifi_next) {

20 printf("%s: \n");

30 if ((i = ifi->ifi_hlen) > 0) {

31 ptr = ifi->ifi_haddr;

32 do {

33 printf("%s%x", (i == ifi->ifi_hlen) ? " " : ":", *ptr++);

34 } while (--i > 0);

35 printf("\n");

36 }

37 if (ifi->ifi_mtu != 0)

38 printf(" MTU: %d\n". ifi->ifi_mtu);

39 if ((sa = ifi->ifi_addr) != NULL)

40 printf(" IP addr: %s\n", Sock_ntop_host(sa, sizeof(*sa)));

41 if ((sa = ifi->ifi_brdaddr) != NULL)

42 printf(" broadcast addr, %s\n",

43 Sock_ntop_host(sa, sizeof(*sa)));

44 if ((sa = ifi->ifi_dstaddr) != NULL)

45 printf(" destination addr %s\n\",

46 Sock_ntop_host(sa, sizeof(*sa)));

47 }

48 free_ifi_info(ifihead);

49 exit(0);

59 }

18-47 Программа представляет собой цикл for, в котором один раз вызывается функция get_ifi_info, а затем последовательно перебираются все возвращаемые структуры ifi_info.