IONetworkController

Обсуждение

Этот метод будет всегда возвращать единственный mbuf, если размер, который требуют (плюс дополнение выравнивания), не будет больше, чем MCLBYTES. Буфер данных для mbuf (или mbuf цепочка) возвратился, выровненный согласно ограничениям, о которых сообщает getPacketBufferConstraints (). Поля длины в каждом mbuf возвратились, установлены этим методом, таким образом позволив mbuf быть переданным непосредственно объекту IOMbufMemoryCursor для преобразования mbuf в рассеяние физического адреса - собирают список.

Обсуждение

Этот метод выделяет объект IOKernelDebugger и присоединяет его как клиент. Наличие клиента отладчика подразумевает, что контроллер поддерживает отладку ядра, и поэтому должен реализовать два метода опрошенного режима, которые вызывает клиент отладчика. См. sendPacket () и receivePacket (). Только единственный клиент отладчика должен быть привязан к каждому контроллеру.

Обсуждение

Этот метод создает новый объект сетевого интерфейса и присоединяет его как клиент контроллера. createInterface() метод используется, чтобы выделить и инициализировать интерфейс, сопровождаемый вызовом к configureInterface() сконфигурировать интерфейс. Подклассы могут переопределить те два метода для настройки нового интерфейсного объекта. Перед этим методом возвраты, registerService() вызывается в интерфейсе, чтобы начать соответствовать, который в конечном счете присоединит интерфейс к сетевому стеку. Драйверы будут обычно вызывать этот метод от их start() метод после того, как они готовы обработать интерфейсные запросы. Это имеет желательный эффект предотвращения busyState в корне IOService от становления нулем, прежде чем интерфейсный объект завершил соответствие, тогда удерживающее пользовательский процесс, ожидающий Набора I/O для становления тихим прежде, чем присвоить имена BSD ко всем интерфейсам. Драйверы, которые неспособны инициировать интерфейс, соответствующий синхронно от их start() метод должен вместо этого вызвать adjustBusy вручную постепенно увеличиваться busyState, тогда сопровождаемый a busyState декремент после присоединения и регистрации интерфейса, или после разумного тайм-аута.

Обсуждение

Этот метод конфигурирует интерфейсный объект, создававшийся createInterface (). Подклассы могут переопределить этот метод, чтобы настроить и исследовать интерфейсный объект, который будет присоединен к контроллеру как к клиенту.

Обсуждение

Вызывающая сторона ответственна за выпуск возвращенного объекта словаря. Используйте getMediumDictionary () для получения ссылки на опубликованный средний словарь вместо того, чтобы создать копию.

Обсуждение

Пакет источника не изменяется этим методом.

Обсуждение

Этот метод вызывает attachInterface () для выполнения выделения и инициализации нового интерфейсного объекта. Подкласс IONetworkController должен реализовать этот метод и возвратить соответствующий интерфейсный объект. Например, когда createInterface () вызовут, реализация IOEthernetController возвратит объект IOEthernetInterface.

Обсуждение

Этот метод вызывает запуск () для создания объекта IOOutputQueue обработать организацию очередей исходящего пакета. Реализация по умолчанию будет всегда возвращаться 0, следовательно никакая очередь вывода не будет создаваться. Драйвер может переопределить этот метод и возвратить подкласс IOOutputQueue. Когда IONetworkController будет освобожден, IONetworkController сохранит ссылку на очередь создаваемой и выпустит этот объект. Также см. getOutputQueue ().

Обсуждение

Прежде чем IONetworkController вызывает getWorkLoop () в его запуске () метод, это вызовет createWorkLoop (), чтобы удостовериться, что подкласс, хотящий создать workloop, сделает так перед его первым использованием.

Обсуждение

Этот метод отсоединяет и завершает предоставленный объект клиента IOKernelDebugger. Выпущено синхронное завершение, и этот метод возвратится после того, как клиент отладчика был завершен. Клиент отладчика должен быть выпущен после этого вызова.

Обсуждение

Этот метод проверит, что предоставленный объект является действительно экземпляром IONetworkInterface, и затем вызовите его оконечное () метод. Обратите внимание на то, что интерфейсный объект закроется и отсоединится от его контроллера после того, как канальный уровень удалит все ссылки на все структуры данных, представленные интерфейсом. Интерфейсный объект должен быть выпущен после этого вызова.

Обсуждение

Драйверы, предоставляющие поддержку отладки, могут или переопределить этот метод для отключения поддержки опрошенного режима, отправляют и получают методы или переопределяют основу, включают () и отключают () методы, берущие параметр IOService.

Обсуждение

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

Обсуждение

Этот метод обрабатывает запрещать запрос от клиента. Клиент вызовет, отключают, если это ранее включило контроллер, и это больше не должно транспортировать пакеты или выполнять I/O с помощью контроллера. Объект клиента преобразован тип с помощью OSDynamicCast, и в зависимости от того, является ли клиентом IOKernelDebugger или IONetworkInterface, тогда перегруженное отключает метод, берущий более определенный тип аргумента, вызывается. Если клиент не соответствует никакой тип, то kIOReturnBadArgument возвращается. Драйвер имеет опцию переопределения этой основы, отключают метод или перегруженную форму. Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

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

Обсуждение

Не используйте этот метод, он может быть удален в будущем. Посмотрите отключают ().

Обсуждение

Не используйте этот метод, он может быть удален в будущем. Посмотрите включают ().

Обсуждение

Драйверы, предоставляющие поддержку отладки, могут или переопределить этот метод и установить аппаратные средства для поддержки опрошенного режима, отправляют и получают методы, receivePacket () и sendPacket (), или переопределяют основу, включают () и отключают () методы, берущие параметр IOService.

Обсуждение

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

Обсуждение

Этот метод обрабатывает разрешать запрос от клиента. Клиент вызовет, включают после того, как это открыло контроллер, и прежде чем это начнет использовать контроллер, чтобы отправить и получить пакеты по сети. Предоставленный объект клиента преобразован тип с помощью OSDynamicCast, и в зависимости от того, является ли клиентом IOKernelDebugger или IONetworkInterface, тогда перегруженное включает метод, берущий более определенный тип аргумента, вызывается. Если клиент не соответствует никакой тип, то kIOReturnBadArgument возвращается. Драйвер имеет опцию переопределения этой основы, включают метод или перегруженную форму. Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

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

Обсуждение

Этот метод звонит к функции C, которая будет синхронизироваться с потоком workloop и любыми другими потоками, которые вызывают с закрытым логическим элементом workloop.

Обсуждение

Освобождает объект IONetworkController путем высвобождения всех выделенных средств, сопровождаемых вызовом к супер:: свободный ().

Обсуждение

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

Обсуждение

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

Обсуждение

Методы обратились к workloop контексту с просьбой обслуживать клиентский запрос, может вызвать этот метод для получения объекта клиента, инициировавшего команду.

Обсуждение

Когда IONetworkController запускается, объект IOCommandGate инстанцируют и присоединяют к workloop, возвращенному getWorkLoop (). Этот объект IOCommandGate используется внутренне для синхронизации клиентских команд, обработанных через executeCommand (). Подклассы, которым нужен IOCommandGate, должны попытаться снова использовать объект, возвращенный этим методом, вместо того, чтобы создать новый экземпляр. См. документацию IOCommandGate.

Обсуждение

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

getDebuggerLinkStatus () метод в IONetworkController используется в качестве заполнителя и всегда сообщает, что произошла ссылка. Драйвер, присоединяющий клиент отладчика, должен переопределить этот метод. Драйвер должен сделать любую установку, требуемую удостоверяться, что ссылка доступна для использования. До отправки или получения данных, KDP будет неоднократно вызывать эту функцию, пока это не укажет, что ссылка и допустима и активна (kIONetworkLinkValid | kIONetworkLinkActive).

Обсуждение

Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

Возвращает средний словарь, опубликованный драйвером через publishMediumDictionary (). Используйте copyMediumDictionary (), чтобы создать и получить копию среднего словаря.

Обсуждение

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

Обсуждение

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

Обсуждение

Если драйвер ранее вызвал setSelectedMedium () для указания его текущего выбора носителей, то этот метод возвратит тот средний объект. Иначе, с водительской таблицей свойства консультируются, и исследовано среднее свойство по умолчанию, и соответствующая запись в среднем словаре возвращается.

Обсуждение

Этот метод обрабатывает завершение от одного из объектов клиента. IOService вызывает этот метод с арбитражной сохраненной блокировкой. Подклассы не должны переопределять этот метод.

Обсуждение

Этот метод всегда вызывает IOService с арбитражной сохраненной блокировкой. Подклассы не должны переопределять этот метод.

Обсуждение

Этот метод обрабатывает клиент, открытый на объекте контроллера. IOService вызывает этот метод с арбитражной сохраненной блокировкой. Подклассы не должны переопределять этот метод.

Обсуждение

Переменные экземпляра инициализируются, тогда супер:: init () вызывают.

Обсуждение

Дескрипторы kIOMessageDeviceSignaledWakeup сообщение от провайдера, идентифицирующего IONetworkController как источник пробуждения.

Обсуждение

Если IOOutputQueue создавался createOutputQueue (), то этот метод вызовет объект очереди вывода. Иначе, интерфейсный объект вызовет этот метод непосредственно, когда это получит исходящий пакет от канального уровня.

Нет никакого верхнего предела числа mbufs, следовательно число фрагментов памяти, в mbuf предоставленной цепочке. Когда количество mbuf могло бы превысить предел, поддерживаемый их механизмами DMA, и выполнить объединение для копирования различных фрагментов памяти в меньшее число фрагментов, драйверы должны быть в состоянии обработать случаи. Эта сложность может быть скрыта от драйвера, когда IOMbufMemoryCursor используется, который в состоянии преобразовать mbuf цепочку в рассеяние физического адреса - собирают список, который не превысит конкретное количество физически непрерывных сегментов памяти. Посмотрите IOMbufMemoryCursor.

Реализация в IONetworkController не выполняет полезного действия и отбросит все пакеты. Драйвер должен переопределить этот метод и обработать предоставленный исходящий пакет. Реализация в драйвере не должна блокировать, так как это может заставить сетевой стек быть повторно введенным от небезопасной точки.

Обсуждение

Этот метод вызывает attachInterface () или attachDebuggerClient () для подготовки контроллера, прежде чем будет присоединен новый объект клиента. Этот метод вызовет publishProperties () для публикации возможностей контроллера и свойств, которые могут использоваться объектами клиента. Однако publishProperties () вызовут только один раз, даже если подготовятся (), вызывается многократно. Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

Вызванный драйверами для публикации их среднего словаря. Каждая запись в словаре является объектом IONetworkMedium, представляющим единственный носитель, поддерживающийся контроллером. Этот метод заставит копию словаря если, затем добавить копию к водительской таблице свойства. Предоставленный словарь может быть выпущен вызывающей стороной после возврата из этого метода. Допустимо вызвать этот метод многократно, который может быть необходимым, если возможность носителей аппаратных средств изменяется динамично. Однако, если возможность будет статична, который часто имеет место, тогда то драйвер будет обычно вызывать этот метод только один раз от его запуска () метод.

Несколько методов зависят от присутствия среднего словаря. Их нужно вызвать после того, как средний словарь был опубликован. Те методы: setSelectedMedium () getSelectedMedium () getMediumDictionary () copyMediumDictionary ()

Обсуждение

Вызванный IONetworkController, чтобы обнаружить свойства контроллера и опубликовать их к таблице свойства в Реестре Набора I/O. Этот метод вызывают, как только подготавливаются ().

Обсуждение

Этот метод должен быть реализован драйвером, поддерживающим отладку ядра. После того, как клиент отладчика был присоединен через attachDebuggerClient (), этот метод вызовет клиент отладчика для опроса относительно входящего пакета, когда отладчик ядра будет активен. Этот метод можно вызвать от основного контекста прерывания, и реализация должна избежать любого выделения памяти и никогда не должна блокировать. receivePacket () метод в IONetworkController используется в качестве заполнителя, это не выполняет полезного действия и не должно быть вызвано. Драйвер, присоединяющий клиент отладчика, должен переопределить этот метод.

Обсуждение

Драйверы, которые в состоянии привести в действие, управляют, их аппаратные средства должны переопределить этот метод и зарегистрироваться во влиятельном политике, предоставленном путем вызова IOService:: registerPowerDriver (). IONetworkController вызовет этот метод, прежде чем начальная попытка будет предпринята для присоединения клиента.

Обсуждение

Этот метод не должен использоваться. Вместо этого вызовите разблокировать () метод, предоставленный IOKernelDebugger.

Обсуждение

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

Обсуждение

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

Обсуждение

Этот метод не должен использоваться. Вместо этого вызовите блокировку () метод, предоставленный IOKernelDebugger.

Обсуждение

Когда клиент дает команду для контроллера для изменения его текущего среднего выбора, этот метод вызывают. Реализация должна вызвать setSelectedMedium () после того, как произошло изменение. Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

Когда клиент дает команду для контроллера для изменения его текущего среднего выбора, этот метод вызывают. Эта реализация будет искать запись в среднем словаре, опубликованном драйвером, связанным с данным ключом. Если соответствие найдено, то selectMedium () вызывают для выполнения выбора, иначе ошибка сообщена клиенту. Подклассы должны переопределить selectMedium () и не этот метод. Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

Этот метод должен быть реализован драйвером, поддерживающим отладку ядра. После того, как клиент отладчика был присоединен через attachDebuggerClient (), этот метод вызовет отладчик для отправки исходящего пакета только, когда отладчик ядра будет активен. Этот метод можно вызвать от основного контекста прерывания, и реализация должна избежать любого выделения памяти и никогда не должна блокировать. sendPacket () метод в IONetworkController используется в качестве заполнителя, это не выполняет полезного действия и не должно быть вызвано. Драйвер, присоединяющий клиент отладчика, должен переопределить этот метод.

Обсуждение

Сетевой контроллер, который может проверить контрольную сумму (ы) для полученного пакета, должен вызвать этот метод для кодирования результата на пакете перед отказыванием от нее к стекам протоколов.

Обсуждение

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

setDebuggerMode () метод в IONetworkController используется в качестве заполнителя и ничего не делает. Если драйвер хочет выполнить определенные действия, основанные на том, активен ли отладчик или нет, это должно переопределить этот метод. Например, драйверы могут хотеть изменить настройки управлением электропитанием или выполнить другие реконфигурирования чипсета, основанные на активном состоянии отладчика.

Обсуждение

Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

Когда изменение ссылки обнаруживается, драйверы должны вызвать этот метод. IONetworkController обновит свойства состояния канала в реестре и генерирует событие для информирования верхних уровней об изменении.

Обсуждение

Этот вызов метода синхронизируется логическим элементом workloop.

Обсуждение

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

Обсуждение

После того, как драйвер контроллера успешно соответствовал к провайдеру, этот метод вызывают для запуска сетевого контроллера. IONetworkController выделит ресурсы и соберет свойства контроллера в его реализации. Никакой I/O не будет выполняться, пока подкласс не пытается присоединить объект клиента. Драйвер должен переопределить этот метод и вызвать супер:: запустите () в начале его собственной реализации. Тогда проверьте возвращаемое значение, чтобы удостовериться, что его суперкласс был запущен успешно перед продолжением. Задачи, обычно выполняющиеся водительским методом запуска: распределение ресурсов, инициализация аппаратного обеспечения, выделение IOEventSources и присоединение их к workloop, публикуя средний словарь, и наконец, присоединяя интерфейсный объект, когда это готово обработать клиентские запросы.

Обсуждение

Дубликат запуска (). Контроллер был проинструктирован, чтобы прекратить работать. Остановка () метод должна высвободить средства и действия отмены, выполняемые запуском () метод. Подклассы должны переопределить этот метод и вызвать супер:: остановитесь () в конце его реализации.

Обсуждение

Переопределения IOService::systemWillShutdown чтобы уведомить сетевых клиентов, что должен быть отключен управляемый питанием контроллер. В результате драйверы могут ожидать их disable метод, который вызовут перед завершением работы системы или перезапуском. Эта реализация синхронна и может блокировать перед вызовом IOService::systemWillShutdown и возвратитесь.