Обратные вызовы сетевого интерфейса

Ваш сетевой интерфейс должен определить следующие обратные вызовы, которые вызывают протоколы и драйверы:

• ifnet_add_proto_func, который вызывают каждый раз, когда протокол присоединен к интерфейсу.

• ifnet_check_multi, когда групповой адрес добавляется к интерфейсу, который вызывают. Это позволяет интерфейсу отклонять недопустимые групповые адреса, прежде чем они будут добавлены к интерфейсу.

• ifnet_del_proto_func, когда протокол отсоединяется от интерфейса, который вызывают.

• ifnet_demux_func, который вызывают с необработанным пакетом от интерфейса и возвращает семейные ценности протокола протокола, который должен обработать пакет. Это может сделать это использование любого дескрипторы демультиплексора, зарегистрированные в ifnet_add_proto_func или трудно кодированная логика. Если пакет не соответствует протокола, функция должна возвратиться ENOENT.

• ifnet_detached_func, когда Ваш интерфейс отсоединяется, который вызывают.

• ifnet_event_func, когда событие имеет место в определенном интерфейсе, который вызывают.

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

• ifnet_ioctl_func, который вызывают каждый раз, когда ioctl получен для интерфейса. Сетевой интерфейс, как ожидают, передаст их на драйвер Набора I/O, если это будет необходимым и надлежащим сделать так. Все неопределенные ioctls резервируются для будущего использования Apple. Необходимо использовать kern_control если необходимо добавить дополнительные механизмы управления.

• ifnet_output_func, который вызывают с пакетом, который готов быть отосланным провод. Сетевой интерфейс, как ожидают, передаст пакет и освободит mbuf, связанный с ним. Для сетевых интерфейсов, поддержанных драйверами Набора I/O, этот обратный вызов обычно вызывает функцию в драйвере Набора I/O, обрабатывающем обе из этих задач.

• ifnet_set_bpf_tap, который вызывает штабель для установки функции касания BPF, установленной в интерфейсе. Этот обратный вызов является дополнительным, но рекомендуемый; если Вы не добавляете эту функцию, BPF не может использоваться с Вашим интерфейсом.

Хорошие примеры многих из этих функций могут быть найдены в bsd/net/ether_if_module.c в xnu (ядро) исходное дерево.

Установка и удаление сетевых интерфейсов

Следующие функции обычно вызываются (в следующем порядке) для поддержки динамической вставки и демонтажа сетевых интерфейсов:

1. ifnet_allocate, который выделяет интерфейсную структуру.

2. ifnet_attach, который присоединяет интерфейс к глобальному интерфейсному списку.

3. bpfattach, который включает поддержку BPF в (дополнительном) интерфейсе.

4. ifnet_detach, который удаляет интерфейс из глобального интерфейсного списка.

5. ifnet_release, который выпускает ссылку на интерфейсную структуру. Если подсчет ссылок достигнет нуля (0), то структура будет освобождена. Этот выпуск соответствует ifnet_allocate вызовите ранее, и должен быть вызван после вызова ifnet_detach.

Связанная функция ifnet_reference может использоваться (обычно другим KEXTs) для увеличения подсчета ссылок интерфейсной структуры. Эти вызовы должны быть сбалансированы равным количеством вызовов к ifnet_release.

Водопроводчики протокола

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

Водопроводчики протокола определяют следующие обратные вызовы, которые вызывают протоколы:

• proto_plumb_handler, который вызывают для присоединения протокола к интерфейсу. Это обычно состоит из вызова к интерфейсу ifnet_attach_protocol обратный вызов.

• proto_unplumb_handler, который вызывают для отсоединения протокола от интерфейса. Невертикальный обработчик должен вызвать ifnet_detach_protocol функция, но может сделать другую очистку, такую как освобождение любого хранения, выделенного в proto_plumb_handler обратный вызов.

При присоединении протокола к интерфейсу водопроводчик протокола обычно заполняет следующие поля в ifnet_attach_proto_param структура, многие из которых могут быть определены как часть самого протокола. Этот механизм предоставляет возможность для водопроводчика протокола, чтобы прервать эти вызовы и принять интерфейсно-специфичные меры при необходимости.

• proto_media_detached (дополнительный), который используется, чтобы уведомить протокол, что он отсоединяется.

• proto_media_event (дополнительный), который вызывают для уведомления протокола об интерфейсно-специфичных событиях.

• proto_media_input (требуемый), который используется для поставки входящего пакета протоколу для обработки.

• proto_media_ioctl (дополнительный), который обычно является ioctl протокола, обрабатывающим функцию.

• proto_media_preout (требуемый), который вызывают непосредственно перед тем, как пакет передается. Это позволяет протоколу указывать специфичный для носителей тип кадра и место назначения.

• proto_media_resolve_multi (дополнительный), который используется для получения адреса канального уровня для данного группового адреса протокольного уровня. Если Ваши интерфейсные поддержки многоадресно передают, это только необходимо.

• proto_media_send_arp (дополнительный), который используется для получения адреса канального уровня, соответствующего данному индивидуальному адресу протокольного уровня. Это необходимо для всех интерфейсов не«точка-точка».

Примеры этих функций могут быть найдены в bsd/net/ether_inet_pr_module.c в xnu (ядро) исходное дерево.

Отправка данных

Следующие шаги описывают процесс отправки пакета, с помощью Ethernet в качестве носителя в качестве примера:

1. ip_output подпрограмма в вызовах стека протоколов IP ifnet_output.

2. ifnet_output вызовы функции водопроводчик протокола proto_media_preout функция. В случае IP, это вызовы функции inet_arp_lookup.

3. Если кэш ARP не содержит запись для IP-адреса, inet_arp_lookup тогда вызывает водопроводчика протокола proto_media_send_arp обратный вызов для разрешения целевого IP-адреса в адрес управления доступом к среде (MAC).

4. Когда proto_media_preout возвраты обратного вызова, ifnet_output вызовы функции сетевой интерфейс ifnet_framer_func функция. Эта функция структурирования предварительно ожидает интерфейсно-специфичные данные кадра к пакету.

5. Если какие-либо интерфейсные фильтры присутствуют, их iff_output_func обратные вызовы вызывают последовательно.

6. ifnet_output вызовы функции сетевой интерфейс ifnet_output_func обратный вызов, передающий пакет и освобождающий mbuf.

Получение данных

Следующие шаги описывают процесс получения пакета:

1. Драйвер оборудования или его поддержка кодируют вызовы ifnet_input с указателями на ifnet структура (ifnet_t) и mbuf цепочка (mbuf_t).

2. Пакет ставится в очередь. Обработка резюме на различном потоке.

3. ifnet_input вызовы функции сетевой интерфейс ifnet_demux_func функция для интерфейса.

4. Функция демультиплексирования идентифицирует кадр и возвращает a protocol_family_t значение для указания, какой протокол должен обработать пакет.

5. ifnet_input вызовы функции присоединенные интерфейсные фильтры (если таковые имеются) последовательно.

6. Любые пакеты, не соответствующие присоединенный протокол, отбрасываются, как любые разнородные пакеты.

7. ifnet_input вызовы функции водопроводчик протокола proto_media_input функция. Водопроводчик является определенным для данной комбинации протокола/интерфейса.