GETIFADDRS(3)

ИМЯ
getifaddrs, freeifaddrs - возвращают адреса интерфейса

ОБЗОР
#include <sys/types.h>
#include <ifaddrs.h>

int getifaddrs(struct ifaddrs **ifap);

void freeifaddrs(struct ifaddrs *ifa);

ОПИСАНИЕ
Функция getifaddrs() создаёт связный список структур, описывающих сетевые интерфейсы локальной системы, и сохраняет адрес первого элемента списка в *ifap. Список состоит из структур ifaddrs:

struct ifaddrs {
    struct ifaddrs  *ifa_next;    /* след. элемент в списке */
    char            *ifa_name;    /* имя интерфейса */
    unsigned int     ifa_flags;   /* флаги из SIOCGIFFLAGS */
    struct sockaddr *ifa_addr;    /* адрес интерфейса */
    struct sockaddr *ifa_netmask; /* сетевая маска интерфейса */
    union {
        struct sockaddr *ifu_broadaddr;
                         /* широковещательный адрес интерфейса */
        struct sockaddr *ifu_dstaddr;
                         /* адрес назначения точка-точка */
    } ifa_ifu;
#define              ifa_broadaddr ifa_ifu.ifu_broadaddr
#define              ifa_dstaddr   ifa_ifu.ifu_dstaddr
    void            *ifa_data;    /* спец. данные для адреса */
};

В поле ifa_next содержится указатель на следующую структуру в списке или NULL, если это последний элемент в списке.

Поле ifa_name указывает на имя интерфейса (заканчивающееся null).

В поле ifa_flags содержатся флаги интерфейса, полученные операцией SIOCGIFFLAGS ioctl(2) (список флагов приведён в netdevice(7)).

Поле ifa_addr указывает на структуру, содержащую адрес интерфейса (для определения формата структуры адреса обратитесь к подполю sa_family). Это поле может содержать указатель null.

Поле ifa_netmask указывает на структуру, содержащую маску сети для ifa_addr (если она используется в адресном семействе). Это поле может содержать указатель null.

В зависимости от наличия флага IFF_BROADCAST или IFF_POINTOPOINT в ifa_flags (может быть установлен какой-то один), в ifa_broadaddr будет содержаться широковещательный адрес ifa_addr (если он используется в адресном семействе) или ifa_dstaddr будет содержать адрес назначения интерфейса типа точка-точка.

Поле ifa_data указывает на буфер, содержащий данные, присущие адресному семейству; это поле может быть равно NULL, если данных для этого интерфейса нет.

Память под структуру данных, возвращаемая getifaddrs(), выделяется динамически и должна освобождаться с помощью freeifaddrs(), когда больше не нужна.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении getifaddrs() возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ
Функция getifaddrs() может завершиться с ошибками и назначить переменной errno значения, перечисленные в socket(2), bind(2), getsockname(2), recvmsg(2), sendto(2), malloc(3) или realloc(3).

ВЕРСИИ
Впервые функция getifaddrs() появилась в glibc 2.3, но до glibc 2.3.3 реализация поддерживала только интерфейсы с адресами IPv4; поддержка IPv6 добавлена в glibc 2.3.3. Поддержка семейств адресов не IPv4 доступна только в ядрах, поддерживающих netlink.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
getifaddrs(), freeifaddrs() | безвредность в нитях | безвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ
Нет в POSIX.1. Данная функция впервые появилась в BSDi и существует в системах BSD, но со слегка другой семантикой — возвращается одна запись на интерфейс, а не на адрес. Это означает, что ifa_addr и другие поля могут быть равны NULL, если интерфейс не имеет адресов, и адрес канального уровня не возвращается, если интерфейсу назначен IP-адрес. Также в разных системах различается способ выбора между ifa_broadaddr и ifa_dstaddr.

ЗАМЕЧАНИЯ
Адреса, возвращаемые в Linux, обычно, являются адресами IPv4 и IPv6, назначенными интерфейсу, но также есть один адрес AF_PACKET на интерфейс, содержащий канальные настройки интерфейса и его физический уровень. В этом случае поле ifa_data может содержать указатель на struct rtnl_link_stats, определённую в <linux/if_link.h> (в Linux 2.4 и ранее — struct net_device_stats, определена в <linux/netdevice.h>), которая содержит различные атрибуты интерфейса и статистику.

ПРИМЕР
В программе, показанной далее, демонстрируется использование getifaddrs(), freeifaddrs(), и getnameinfo(3). Вот результат запуска этой программы:
$ ./a.out
lo       AF_PACKET (17)
                tx_packets =        524; rx_packets =        524
                tx_bytes   =      38788; rx_bytes   =      38788
wlp3s0   AF_PACKET (17)
                tx_packets =     108391; rx_packets =     130245
                tx_bytes   =   30420659; rx_bytes   =   94230014
em1      AF_PACKET (17)
                tx_packets =          0; rx_packets =          0
                tx_bytes   =          0; rx_bytes   =          0
lo       AF_INET (2)
                адрес: <127.0.0.1>
wlp3s0   AF_INET (2)
                адрес: <192.168.235.137>
lo       AF_INET6 (10)
                адрес: <::1>
wlp3s0   AF_INET6 (10)
                адрес: <fe80::7ee9:d3ff:fef5:1a91%wlp3s0>

  Исходный код программы
#define _GNU_SOURCE     /* чтобы получить NI_MAXSERV и NI_MAXHOST */
#include <arpa/inet.h>
#include <sys/socket.h>
#include <netdb.h>
#include <ifaddrs.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <linux/if_link.h>
int main(int argc, char *argv[])
{
    struct ifaddrs *ifaddr, *ifa;
    int family, s, n;
    char host[NI_MAXHOST];
    if (getifaddrs(&ifaddr) == -1) {
        perror("getifaddrs");
        exit(EXIT_FAILURE);
    }
    /* обходим связный список, сохраняя начальный указатель, чтобы
       освободить список позже */
    for (ifa = ifaddr, n = 0; ifa != NULL; ifa = ifa->ifa_next, n++) {
        if (ifa->ifa_addr == NULL)
            continue;
        family = ifa->ifa_addr->sa_family;
        /* вывод имени интерфейса и семейства (включая символический
           вид для общих семейств) */
        printf("%-8s %s (%d)\n",
               ifa->ifa_name,
               (family == AF_PACKET) ? "AF_PACKET" :
               (family == AF_INET) ? "AF_INET" :
               (family == AF_INET6) ? "AF_INET6" : "???",
               family);
        /* для адресов интерфейса AF_INET* показываем адрес */
        if (family == AF_INET || family == AF_INET6) {
            s = getnameinfo(ifa->ifa_addr,
                    (family == AF_INET) ? sizeof(struct sockaddr_in) :
                                          sizeof(struct sockaddr_in6),
                    host, NI_MAXHOST,
                    NULL, 0, NI_NUMERICHOST);
            if (s != 0) {
                printf("ошибка getnameinfo(): %s\n", gai_strerror(s));
                exit(EXIT_FAILURE);
            }
            printf("\t\tадрес: <%s>\n", host);
        } else if (family == AF_PACKET && ifa->ifa_data != NULL) {
            struct rtnl_link_stats *stats = ifa->ifa_data;
            printf("\t\ttx_packets = %10u; rx_packets = %10u\n"
                   "\t\ttx_bytes   = %10u; rx_bytes   = %10u\n",
                   stats->tx_packets, stats->rx_packets,
                   stats->tx_bytes, stats->rx_bytes);
        }
    }
    freeifaddrs(ifaddr);
    exit(EXIT_SUCCESS);
}

СМОТРИТЕ ТАКЖЕ
bind(2), getsockname(2), socket(2), packet(7), ifconfig(8)