RTNETLINK(7)

ИМЯ
rtnetlink - сокет маршрутизации IPv4 в Linux

ОБЗОР
#include <asm/types.h>
#include <linux/netlink.h>
#include <linux/rtnetlink.h>
#include <sys/socket.h>

rtnetlink_socket = socket(AF_NETLINK, int socket_type, NETLINK_ROUTE);

ОПИСАНИЕ
Rtnetlink позволяет читать и изменять таблицы маршрутизации ядра. Он используется для взаимодействия различных подсистем внутри ядра (это здесь не описано), а также для взаимодействия пользовательских программ. Сетевыми маршрутами, IP-адресами, параметрами связи (link parameters), настройками соседства (neighbor setups), алгоритмами планирования очереди (queueing disciplines), классификацией трафика и и пакетными классификаторами можно управлять через сокеты NETLINK_ROUTE. Они основываются на сообщениях netlink; подробности смотрите в netlink(7).

  Атрибуты маршрутизации
Некоторые сообщения rtnetlink содержат необязательные атрибуты после начального заголовка:

    struct rtattr {
        unsigned short rta_len;    /* длина параметра */
        unsigned short rta_type;   /* тип параметра */
        /* данные … */
    };

Этими атрибутами нужно управлять только с помощью макросов RTA_* или libnetlink, смотрите rtnetlink(3).

  Сообщения
Rtnetlink поддерживает следующие типы сообщений (в дополнении к стандартным сообщениям netlink):

RTM_NEWLINK, RTM_DELLINK, RTM_GETLINK
    Создание, удаление и получение информации об определённом сетевом интерфейсе. Эти сообщения содержат структуру ifinfomsg, за которой следует ряд структур rtattr.

        struct ifinfomsg {
            unsigned char  ifi_family; /* AF_UNSPEC */
            unsigned short ifi_type;   /* тип устройства */
            int            ifi_index;  /* индекс интерфейса */
            unsigned int   ifi_flags;  /* флаги устройства */
            unsigned int   ifi_change; /* маска изменения */
        };

    В ifi_flags содержатся флаги устройства, смотрите netdevice(7); в ifi_index — уникальный индекс интерфейса (начиная с Linux 3.7 возможно передать ненулевое значение в сообщении RTM_NEWLINK; в этом случае создаётся связь (link) с заданным ifindex); элемент ifi_change зарезервирован на будущее и его значение всегда должно быть равно 0xFFFFFFFF.
    Атрибуты маршрутизации
    rta_type | тип значения | описание
    IFLA_UNSPEC | - | не определено
    IFLA_ADDRESS | аппаратный адрес | адрес интерфейса L2
    IFLA_BROADCAST | аппаратный адрес | широковещательный адрес L2
    IFLA_IFNAME | строка asciiz | имя устройства
    IFLA_MTU | unsigned int | MTU устройства
    IFLA_LINK | int | тип связи
    IFLA_QDISC | строка asciiz | алгоритм очереди
    IFLA_STATS | смотрите ниже | статистика интерфейса

Тип значения для IFLA_STATS — struct rtnl_link_stats (в Linux 2.4 и старее — struct net_device_stats).

RTM_NEWADDR, RTM_DELADDR, RTM_GETADDR
    Добавление, удаление или получение информации об IP-адресе, назначенном интерфейсу. В Linux 2.2 интерфейс может иметь несколько IP-адресов; эта концепция пришла на смену псевдонимам устройства, использовавшимся в версии 2.0. В Linux 2.2 эти сообщения поддерживают адреса IPv4 и IPv6. В них содержится структура ifaddrmsg, которая может быть указана после атрибутов маршрутизации rtattr.

        struct ifaddrmsg {
            unsigned char ifa_family;    /* тип адреса */
            unsigned char ifa_prefixlen; /* длина префикса адреса */
            unsigned char ifa_flags;     /* флаги адреса */
            unsigned char ifa_scope;     /* область адреса */
            int           ifa_index;     /* индекс интерфейса */
        };

    Поле ifa_family представляет тип адресного семейства (AF_INET или AF_INET6), ifa_prefixlen — длину адресной маски адреса, если это применимо для семейства (в IPv4), ifa_scope — область адреса, ifa_index — индекс интерфейса, которому назначен адрес. Поле ifa_flags — слово флагов: IFA_F_SECONDARY — вторичный адрес (старый псевдоним интерфейса), IFA_F_PERMANENT — постоянный адрес, назначенный пользователем и другие недокументированные флаги.
    Атрибуты
    rta_type | тип значения | описание
    IFA_UNSPEC | - | не определено
    IFA_ADDRESS | адрес неструктурированного протокола | адрес интерфейса
    IFA_LOCAL | адрес неструктурированного протокола | локальный адрес
    IFA_LABEL | строка asciiz | название интерфейса
    IFA_BROADCAST | адрес неструктурированного протокола | широковещательный адрес
    IFA_ANYCAST | адрес неструктурированного протокола | адрес anycast
    IFA_CACHEINFO | struct ifa_cacheinfo | информация об адресе

RTM_NEWROUTE, RTM_DELROUTE, RTM_GETROUTE
    Создание, удаление или получение информации о сетевом маршруте. Эти сообщения содержат структуру rtmsg с необязательными дополнительными структурами rtattr. Для RTM_GETROUTE, если rtm_dst_len и rtm_src_len задать значение 0, то вы получите все записи определённой таблицы маршрутизации. В других полях, кроме rtm_table и rtm_protocol, 0 считается шаблоном (wildcard).

        struct rtmsg {
            unsigned char rtm_family;   /* адресное семейство маршрута */
            unsigned char rtm_dst_len;  /* длина назначения */
            unsigned char rtm_src_len;  /* длина источника */
            unsigned char rtm_tos;      /* фильтр TOS */
            unsigned char rtm_table;    /* ID таблицы маршрутизации */
            unsigned char rtm_protocol; /* протокол марш-ции; см. ниже */
            unsigned char rtm_scope;    /* см. ниже */
            unsigned char rtm_type;     /* см. ниже */
            unsigned int  rtm_flags;
        };
    rtm_type | Тип маршрута
    RTN_UNSPEC | неизвестный маршрут
    RTN_UNICAST | шлюз или прямой маршрут
    RTN_LOCAL | маршрут локального интерфейса
    RTN_BROADCAST | локальный широковещательный маршрут (широковещательная отправка)
    RTN_ANYCAST | локальный широковещательный маршрут (однонаправленная отправка)
    RTN_MULTICAST | многоадресный маршрут
    RTN_BLACKHOLE | маршрут для отброса пакетов
    RTN_UNREACHABLE | недостижимый пункт назначения
    RTN_PROHIBIT | маршрут для отклонения пакетов
    RTN_THROW | продолжение поиска маршрута в другой таблице
    RTN_NAT | правило трансляции сетевого адреса
    RTN_XRESOLVE | ссылка на внешний определитель (не реализовано)
     | Происхождение маршрута
    RTPROT_UNSPEC | неизвестно
    RTPROT_REDIRECT | из-за перенаправления полученном по ICMP (не используется)
    RTPROT_KERNEL | посылается ядром
    RTPROT_BOOT | при загрузке машины
    RTPROT_STATIC | указан администратором

    Значения больше RTPROT_STATIC не учитываются ядром, они предназначены только для пользовательской информации. Они могут использоваться для пометки источника информации о маршрутизации или для отличения различных служб маршрутизации друг от друга. Уже назначенные идентификаторы для служб маршрутизации можно найти в <linux/rtnetlink.h>.

    rtm_scope — расстояние до назначения:
    RT_SCOPE_UNIVERSE | глобальный маршрут
    RT_SCOPE_SITE | внутренний маршрут в локальной автономной системе
    RT_SCOPE_LINK | маршрут на эту связь
    RT_SCOPE_HOST | маршрут на локальный узел
    RT_SCOPE_NOWHERE | назначение не существует

    Значения от RT_SCOPE_UNIVERSE и до RT_SCOPE_SITE доступны пользователю.

    Поле rtm_flags может иметь следующие значения:
    RTM_F_NOTIFY | если маршрут изменился — уведомить пользователя через rtnetlink
    RTM_F_CLONED | маршрут склонирован из другого маршрута
    RTM_F_EQUALIZE | многопутевой уравниватель (не реализовано)

    В rtm_table задаётся таблица маршрутизации:
    RT_TABLE_UNSPEC | таблица маршрутизации не задана
    RT_TABLE_DEFAULT | таблица по умолчанию
    RT_TABLE_MAIN | главная таблица
    RT_TABLE_LOCAL | локальная таблица

    Пользователь может назначать произвольные значения от RT_TABLE_UNSPEC и до RT_TABLE_DEFAULT.
    Атрибуты
    rta_type | тип значения | описание
    RTA_UNSPEC | - | игнорируется
    RTA_DST | адрес протокола | адрес маршрута назначения
    RTA_SRC | адрес протокола | адрес маршрута источника
    RTA_IIF | int | индекс входного интерфейса
    RTA_OIF | int | индекс выходного интерфейса
    RTA_GATEWAY | адрес протокола | шлюз маршрута
    RTA_PRIORITY | int | приоритет маршрута
    RTA_PREFSRC |  |
    RTA_METRICS | int | метрика маршрута
    RTA_MULTIPATH |  |
    RTA_PROTOINFO |  |
    RTA_FLOW |  |
    RTA_CACHEINFO |  |

    Заполнить эти значения!

RTM_NEWNEIGH, RTM_DELNEIGH, RTM_GETNEIGH
    Добавление, удаление или получение информации о записи соседей по таблице (например, запись ARP). В сообщении содержится структура ndmsg:

        struct ndmsg {
            unsigned char ndm_family;
            int           ndm_ifindex;  /* индекс интерфейса */
            __u16         ndm_state;    /* состояние */
            __u8          ndm_flags;    /* флаги */
            __u8          ndm_type;
        };
        struct nda_cacheinfo {
            __u32         ndm_confirmed;
            __u32         ndm_used;
            __u32         ndm_updated;
            __u32         ndm_refcnt;
        };

    В ndm_state содержится битовая маска следующих состояний:
    NUD_INCOMPLETE | запись кэша в данный момент определяется
    NUD_REACHABLE | подтверждённая рабочая запись кэша
    NUD_STALE | устаревшая запись кэша
    NUD_DELAY | запись ожидает срабатывания таймера
    NUD_PROBE | запись кэша в данный момент проверяется повторно
    NUD_FAILED | некорректная запись кэша
    NUD_NOARP | устройство без кэша назначений
    NUD_PERMANENT | статическая запись

    Допустимые значения ndm_flags:
    NTF_PROXY | запись прокси arp
    NTF_ROUTER | маршрутизатор IPv6

    Структура rtattr имеет следующие значения для поля rta_type:
    NDA_UNSPEC | неизвестный тип
    NDA_DST | кэш адресов назначения соседей на сетевом уровне
    NDA_LLADDR | кэш адресов соседей на уровне связей
    NDA_CACHEINFO | статистика кэша

    Если значение поля rta_type равно NDA_CACHEINFO, то присутствует заголовок struct nda_cacheinfo.

RTM_NEWRULE, RTM_DELRULE, RTM_GETRULE
    Добавление, удаление или получение правила маршрутизации. Содержит struct rtmsg.

RTM_NEWQDISC, RTM_DELQDISC, RTM_GETQDISC
    Добавление, удаление или получение планирования очереди. В сообщении содержится struct tcmsg, а также может быть серия атрибутов.

        struct tcmsg {
            unsigned char    tcm_family;
            int              tcm_ifindex;   /* индекс интерфейса */
            __u32            tcm_handle;    /* описатель qdisc */
            __u32            tcm_parent;    /* предок qdisc */
            __u32            tcm_info;
        };
    Атрибуты
    rta_type | тип значения | Описание
    TCA_UNSPEC | - | не определено
    TCA_KIND | строка asciiz | имя план-ания очереди
    TCA_OPTIONS | байтовая последовательность | есть параметры qdisc
    TCA_STATS | struct tc_stats | статистика qdisc
    TCA_XSTATS | относится к qdisc | стат-ка по опр. модулю
    TCA_RATE | struct tc_estimator | ограничение по скорости

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

RTM_NEWTCLASS, RTM_DELTCLASS, RTM_GETTCLASS
    Добавление, удаление или получение класса трафика. В этих сообщениях содержится структура struct tcmsg, описанная ранее.

RTM_NEWTFILTER, RTM_DELTFILTER, RTM_GETTFILTER
    Добавление, удаление или получение информации о фильтре трафика. В этих сообщениях содержится структура struct tcmsg, описанная ранее.

ВЕРСИИ
Свойство rtnetlink появилось в Linux 2.2.

ДЕФЕКТЫ
Данная справочная страница не полна.

СМОТРИТЕ ТАКЖЕ
cmsg(3), rtnetlink(3), ip(7), netlink(7)