ОБЗОР
#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 адрес raw-протокола адрес интерфейса IFA_LOCAL адрес raw-протокола локальный адрес IFA_LABEL строка asciiz название интерфейса IFA_BROADCAST адрес raw-протокола широковещательный адрес IFA_ANYCAST адрес raw-протокола адрес 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 ссылка на внешний определитель (не реализовано) rtm_protocol Происхождение маршрута 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 specific стат-ка по опр. модулю TCA_RATE struct tc_estimator ограничение по скорости Также, разрешены дополнительные атрибуты модуля qdisc. Дополнительную информацию можно получить из соответствующих заголовочных файлов.
- RTM_NEWTCLASS, RTM_DELTCLASS, RTM_GETTCLASS
- Добавление, удаление или получение класса трафика. В этих сообщениях содержится структура struct tcmsg, описанная ранее.
- RTM_NEWTFILTER, RTM_DELTFILTER, RTM_GETTFILTER
- Добавление, удаление или получение информации о фильтре трафика. В этих сообщениях содержится структура struct tcmsg, описанная ранее.