ПРИМЕЧАНИЕ
Пользователи обычно задают имя интерфейса le0 или ether0, а IP-адрес и индекс интерфейса не используются. Например, tcpdump является одной из немногих программ, позволяющих пользователю задавать интерфейс, а ее параметр -i принимает имя интерфейса в качестве аргумента.
Функция
mcast_leave
выводит узел из группы с IP-адресом, содержащимся в структуре адреса сокета, на которую указывает аргумент
grp
.
Функция
mcast_block_source
блокирует получение через конкретный сокет пакетов, относящихся к определенной группе и исходящих от определенного источника. IP-адреса группы и источника хранятся в структурах адреса сокета, на которые указывают аргументы
grp
и
src
соответственно. Длины структур задаются параметрами
srclen
и
grplen
. Для успешного завершения функции необходимо, чтобы до ее вызова уже была вызвана функция
mcast_join
для того же сокета и той же группы.
Функция
mcast_unblock_source
разблокирует получение трафика от источника из заданной группы. Аргументы
src
,
srclen
,
grp
и
grplen
имеют тот же смысл, что и аргументы предыдущей функции, и должны совпадать с ними по значениям.
Функция
mcast_join_source_group
выполняет присоединение к группе источника. Адрес источника и адрес группы содержатся в структурах адреса сокета, на которые указывают аргументы
src
и
grp
. Длины структур задаются параметрами
srclen
и
grplen
. Интерфейс, присоединяемый к группе, может быть задан именем (ненулевой аргумент
ifname
) или индексом (
ifindex
). Если интерфейс не задан явно, ядро выбирает его самостоятельно.
Функция
mcast_leave_source_group
выполняет отсоединение от группы источника. Адреса источника и группы содержатся в структурах адреса сокета, на которые указывают аргументы
src
и
grp
. Длины структур задаются параметрами
srclen
и
grplen
. Подобно
mcast_leave
,
mcast_leave_source_group
не требует указания интерфейса: она всегда отсоединяет от группы первый интерфейс, удовлетворяющий условиям.
Функция
mcast_set_if
устанавливает индекс интерфейса по умолчанию для исходящих дейтаграмм многоадресной передачи. Если аргумент
ifname
непустой, он задает имя интерфейса. Иначе положительное значение аргумента
ifindex
будет задавать индекс интерфейса. В случае IPv6 имя сопоставляется индексу с использованием функции
if_nametoindex
. В случае IPv4 сопоставление имени или индекса IP-адресу направленной передачи интерфейса происходит так же, как для функции
mcast_join
.
Функция
mcast_set_loop
устанавливает параметр закольцовки либо в 0, либо в 1, а функция
mcast_set_ttl
TTL в случае IPv4 или предел количества транзитных узлов в случае IPv6. Функции
mcast_get_XXX
возвращают соответствующие значения.
Пример: функция mcast_join
В листинге 21.1[1] показана первая часть функции
mcast_join
. Эта часть демонстрирует простоту интерфейса программирования, не зависящего от протокола.
Листинг 21.1. Присоединение к группе: сокет IPv4
//lib/mcast_join.c
1 #include "unp.h"
2 #include <net/if.h>
3 int
4 mcast_join(int sockfd, const SA *grp, socklen_t grplen,
5 const char *ifname, u_int ifindex)
6 {
7 #ifdef MCAST_JOIN_GROUP
8 struct group_req req;
9 if (ifindex > 0) {
10 req.gr_interface = ifindex;
11 } else if (ifname != NULL) {
12 if ((req.gr_interface = if_nametoindex(ifname)) == 0) {
13 errno = ENXIO; /* интерфейс не найден */
14 return(-1);
15 }
16 } else
17 req.gr_interface = 0;
18 if (grplen > sizeof(req.gr_group)) {
19 errno = EINVAL;
20 return -1;
21 }
22 memcpy(&req.gr_group, grp, grplen);
23 return (setsockopt(sockfd, family_to_level(grp->sa_family),
24 MCAST_JOIN_GROUP, &req, sizeof(req)));
25 #else
Обработка индекса
9-17
Если при вызове был указан индекс интерфейса, функция использует его непосредственно. В противном случае (при указании имени интерфейса), имя преобразуется в индекс вызовом
if_nametoindex
. Если ни имя, ни индекс не заданы, интерфейс выбирается ядром.
Копирование адреса и вызов setsockopt
18-22
Адрес сокета копируется непосредственно в поле группы. Вспомните, что поле это имеет тип
sockaddr_storage
, а потому достаточно велико для хранения адреса любого типа, поддерживаемого системой. Для предотвращения переполнения буфера (при ошибках в программе) мы проверяем размер
sockaddr
и возвращаем
EINVAL
, если он слишком велик.
23-24
Присоединение к группе выполняется вызовом
setsockopt
. Аргумент
level
определяется на основании семейства группового адреса вызовом нашей собственной функции
family_to_level
. Некоторые системы допускают несоответствие аргумента level семейству адреса сокета, например использование
IPPROTO_IP
с
MCAST_JOIN_GROUP
, даже если сокет относится к семейству
AF_INET6
, но это верно не для всех систем, поэтому мы и должны выполнить преобразование семейства к нужному значению
level
. Листинг этой тривиальной функции в книге мы не приводим, но исходный код этой функции вы можете скачать вместе со всеми остальными программами.
