Словарь наборов

Словарь Наборов содержит подсловарь для каждого набора, определенного в системе. Обычно наборы представляют расположения, создаваемые пользователем в Сетевых предпочтениях, несмотря на то, что приложения конфигурации сети могут также создать их. Например, ISP мог бы обеспечить приложение, определяющее новое расположение, упрощающее для пользователя соединяться с ISP. Для предложения этого нового расположения приложение создает новый словарь набора и некоторое число новых служб. Новый словарь набора содержит конфигурационную информацию для расположения, включая свойство, содержащее имя ISP’s и ссылки на новые службы.

Каждый отдельный словарь набора в словаре Наборов верхнего уровня содержит следующие свойства:

• UserDefinedName

• Сеть

Свойство UserDefinedName является строкой, содержащей имя расположения, которое пользователь вводит в Сетевых предпочтениях. Приложение, определяющее новое расположение, использовало бы этот ключ для обеспечения подходящего имени расположения, например, имени ISP. Имя ISP’s тогда выведено на экран в меню Location Сетевых предпочтений и в Меню Apple.

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

• Глобальная переменная

• Интерфейс

• Служба

Поскольку его имя подразумевает, Глобальный словарь предоставляет информацию, которая не является определенной ни для какой определенной службы. В настоящее время Глобальный словарь содержит два задействованных словаря: IPv4 и NetInfo, оба из которых требуются.

Словарь IPv4 должен содержать ключ ServiceOrder. Значение этого ключа является массивом, позволяющим пользователю налагать упорядочивание на свои сетевые службы в Сетевых предпочтениях. Когда многократные службы активны одновременно, система использует массив ServiceOrder для определения, какую службу нужно считать основной. Основная служба определяет маршрут по умолчанию и конфигурации прокси-сервера и DNS.

Словарь IPv4 может также содержать ключ PPPOverridePrimary. Это - устаревший ключ, позволяющий любой активной основанной на PPP службе быть обработанной, как будто это было первым в массиве ServiceOrder. Эта функциональность была заменена, позволив любой отдельной службе включать ключ OverridePrimary в его собственном (на службу) словарь IPv4.

Словарь NetInfo содержит NetInfo обязательные предпочтения. Поскольку использование Служб каталогов становится более широко распространенным, однако, словарь NetInfo меньше станет распространен.

Интерфейсный словарь содержит настройки на интерфейс. Каждый элемент Интерфейсного словаря является подсловарем, идентифицированным именем BSD интерфейса, такой как en0. Каждый подсловарь содержит словарь, названный Ethernet, содержащим результаты ручной конфигурации интерфейса. Скорость, дуплекс и максимальный размер пакета (максимальный блок передачи или MTU) значения сохранены здесь. Эта информация хранится на интерфейсном уровне, чтобы препятствовать тому, чтобы отдельные службы пытались сконфигурировать тот же интерфейс по-разному.

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

Словарь Службы содержит ссылки на службы, определенные для этого набора. Каждый элемент словаря Службы является самостоятельно словарем, содержащим единственный элемент — внутренняя служба ID, относящаяся к службе, перечисленной в словаре NetworkServices верхнего уровня. Сетевые предпочтения используют информацию в словаре Службы для отображения служб и включают ли им. Предпочтительный монитор также использует эту информацию, поскольку это загружает текущие предпочтения конфигурации в динамическую память (для получения дополнительной информации об этом процессе, посмотрите Предпочтительный Монитор).

Словарь NetworkServices

Словарь NetworkServices верхнего уровня содержит все сетевые службы, определенные для системы. Каждая сетевая служба представлена словарем (идентифицированный уникальным ключом), который содержит свойства конфигурации для объектов, связанных с той службой. Комбинация объектов определяется типом службы. Например, основанной на модеме службе нужны Интерфейс, PPP, Модем, и объекты IPv4, но не объект AppleTalk, потому что OS X не поддерживает AppleTalk по PPP.

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

Словарь сетевой службы может включать следующие свойства:

• Интерфейсный словарь, описывающий сетевой интерфейс, лежащий в основе службы

• Переменное число словарей объекта протоколов, каждый из которых описывает конфигурацию объекта протоколов (такого как PPP или AppleTalk) это определяется для службы. (Обратите внимание на то, что некоторые словари объекта протоколов могут присутствовать в словаре сетевой службы, но быть пустыми или отмечены как неактивные.)

• Один аппаратный словарь объекта, в зависимости от типа службы (тип службы указан в интерфейсном словаре объекта),

• Словарь прокси, идентифицирующий, какие прокси включены для службы

• Видимое пользователем имя для службы

Предпочтительный монитор

Предпочтительный монитор читает в настоящее время активный набор конфигурации, указанный предпочтением CurrentSet пользователя, и загружает связанные предпочтения в динамическую память. Загрузка предпочтений включает процесс отображения, сглаживающий на единственный уровень иерархию вложенных словарей, составляющих в настоящее время активный набор. Отображающиеся замены каждый вложенный словарь с новой парой ключ/значение. Новый ключ является путем от корня словаря набора к вложенному словарю, и значение является значением вложенного словаря минус любые дополнительные вложенные словари. Таким образом произвольно глубокая иерархия вложенных словарей может быть представлена как ряд словарей верхнего уровня, ни один из которых не содержит вложенные словари.

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

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

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

  Подмножество перечисления 3-1 словаря службы (ServiceID 100)

<key>100</key>

<dict>

    <key>IPv4</key>

    <dict>

        <key>ConfigMethod</key>

        <string>BootP</string>

    </dict>

    <key>DNS</key>

    </dict>

    <key>Interface</key>

    <dict>

        <key>DeviceName</key>

        <string>en0</string>

        <key>Hardware</key>

        <string>Ethernet</string>

        <key>Type</key>

        <string>Ethernet</string>

        <key>UserDefinedName</key>

        <string>Built-in Ethernet</string>

    </dict>

    <key>UserDefinedName</key>

    <string>Built-in Ethernet</string>

</dict>

Перечисление 3-2 показывает то, на что похож этот словарь после того, как предпочтительный монитор отображает его.

  Подмножество перечисления 3-2 словаря службы, после отображения в динамическую память

/Network/Service/100

/Network/Service/100/IPv4

<dictionary>

    <key>ConfigMethod</key>

    <string>BootP</string>

</dictionary>

/Network/Service/100/Interface

<dictionary>

    <key>DeviceName</key>

    <string>en0</string>

    <key>Hardware</key>

    <string>Ethernet</string>

    <key>Type</key>

    <string>Ethernet</string>

    <key>UserDefinedName</key>

    <string>Built-in Ethernet</string>

</dictionary>

<dictionary>

    <key>UserDefinedName</key>

    <string>Built-in Ethernet</string>

</dictionary>

Как Вы видите в Перечислении 3-2, IPv4 и Интерфейсные подсловари теперь на том же уровне как их родитель (словарь службы) и имеют ключи, описывающие их позицию в родительском словаре. Кроме того, пустой подсловарь DNS в Перечислении 3-1 не представлен в отображении.

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

Event Monitor ядра

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

В отличие от большинства других агентов, монитор события ядра не получает конфигурационную информацию от Setup: ключи в динамической памяти. Вместо этого это получает свой ввод непосредственно от ядра и публикует его наблюдения в части из State: ключи, как показано в Таблице 3-8.

Агент конфигурации IPv4

Агент конфигурации IPv4 конфигурирует устройства типа Ethernet для сетей IP. Когда предпочтительный монитор загружает обновленное отображение из персистентного хранилища в динамическую память, агент конфигурации IPv4 получает уведомление для каждой сконфигурированной службы. Это получает конфигурационную информацию от соответствующего Setup: ключи и применяют ту конфигурацию к обозначенному интерфейсу. Это тогда обновляет динамическую память для отражения присвоенных фактических IP-адресов. Для некоторых конфигураций, таких как DHCP и BootP, агент конфигурации IPv4 также обновляет динамическую память с любыми параметрами конфигурации, которые это получило от сервера.

Когда пользователь переключает расположения или вносит изменение в предпочтения конфигурации IP в Сетевых предпочтениях, предпочтительный монитор загружает новые настройки в динамическую память. Агент конфигурации IPv4 получает уведомление об изменениях и обновляет конфигурацию сети согласно новым настройкам. Это тогда публикует новую информацию о состоянии сети в надлежащем State: ключи.

Агент конфигурации IPv4 также наблюдает изменения в состоянии канала. Это делает это путем регистрации интереса в State: вводит монитор события ядра публикует (показанный в Таблице 3-8). Когда компьютер включается в сеть, это поддерживает автоматическую конфигурацию сетевых интерфейсов. Таблица 3-9 показывает ключам использование агента конфигурации IPv4.

Агент конфигурации IPv4 также публикует значения в динамической памяти. Таблица 3-10 показывает ключи, которые агент конфигурации IPv4 публикует и обстоятельства, при которых это делает так.

Агент конфигурации IPv6

Как агент конфигурации IPv4, агент конфигурации IPv6 также конфигурирует устройства типа Ethernet для сетей IP. Кроме того, агент конфигурации IPv6 конфигурирует устройства FireWire и новое 6to4 интерфейс. Когда предпочтительный монитор загружает обновленное отображение из персистентного хранилища в динамическую память, агент конфигурации IPv6 получает уведомление для каждой сконфигурированной службы. Это получает конфигурационную информацию от соответствующего Setup: ключи и применяют ту конфигурацию к обозначенному интерфейсу. Это тогда обновляет динамическую память для отражения присвоенных фактических IP-адресов.

Агент конфигурации IPv6 также наблюдает изменения в состоянии канала. Это делает это путем регистрации интереса в State: вводит монитор события ядра публикует (показанный в Таблице 3-8). Когда компьютер включается в сеть, это поддерживает автоматическую конфигурацию сетевых интерфейсов. Таблица 3-11 показывает ключам использование агента конфигурации IPv6.

Агент конфигурации IPv6 также публикует значения в динамической памяти. Таблица 3-12 показывает ключи, которые агент конфигурации IPv6 публикует и для некоторых ключей, обстоятельств, при которых это делает так.

Монитор IP

Основное задание агента монитора IP должно выбрать основную сетевую службу. Это обычно - служба, связанная с маршрутом по умолчанию и DNS по умолчанию для системы. Для создания его определения агент монитора IP исследует и предпочтительный приоритет пользователя служб и текущий статус тех служб. Это тогда выбирает в настоящее время доступную службу, которая является самой высокой в списке приоритетов пользователя и отмечает ту службу как основную в динамической памяти.

Агент монитора IP управляется информацией, которую другие агенты публикуют в динамической памяти. Это контролирует предпочтения пользователя, отображенные в предпочтительным монитором и состоянием конфигурации служб, опубликованных IPv4 и агентами конфигурации IPv6 и контроллером PPP. Таблица 3-13 показывает ключам использование агента монитора IP.

Монитор IP также публикует значения в динамической памяти. Таблица 3-14 показывает ключи, которые монитор IP публикует и обстоятельства, при которых это делает так.

Контроллер PPP

Контроллер PPP конфигурирует интерфейсы PPP для сетей IP. Это управляет соединениями через модемы коммутируемого доступа и через PPP по Ethernet (PPPoE) и VPN (виртуальная частная сеть) соединения с помощью PPTP (протокол туннелирования точка-точка) и L2TP (протокол туннелирования уровня 2). Контроллер PPP взаимодействует с приложениями номеронабирателя и инстанцирует интерфейсов PPP по мере необходимости.

Контроллер PPP получает свою конфигурационную информацию от Setup: ключи, предоставленные предпочтениями, контролируют, и получает уведомление, когда изменяются эти ключи. После того, как интерфейс сконфигурирован, контроллер PPP публикует IP, место назначения, и адреса маршрутизатора и информацию DNS, предоставленную сервером PPP. Таблица 3-15 показывает ключам использование контроллера PPP.

Контроллер PPP публикует много ключей в динамической памяти. Таблица 3-16 показывает некоторым из них.

Программно устанавливающие предпочтения

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

Чтобы помочь удовлетворить потребности разработчиков, Техническая поддержка Разработчика Apple предоставляет крупной библиотеке примера кода, обертывающего часть низкоуровневой Конфигурации системы API в высокоуровневых функциях. Мало того, что эта библиотека изолирует Вас от большой части низкоуровневого манипулирования парами ключ/значение, это также обеспечивает оптимизированный шаблон, который можно использовать для определения базовой услуги. Когда Вы получаете эту работу базовой услуги, можно тогда настроить настройки, с помощью информации inLayout Персистентного Хранилища как руководство.

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

Получение подробной информации состояния соединения PPP

Платформа Конфигурации системы обеспечивает API, позволяющий Вам получать подробную информацию о текущем соединении PPP. Доступный в версии 10.3 OS X и позже, этот API предоставляет Вам доступ к информации, собранной контроллером PPP. Для использования этого API необходимо быть знакомы с расположением словаря сетевой службы и словаря объекта протоколов PPP, как определено схемой. Это вызвано тем, что информация, которую API возвращает Вам, следует за той же структурой.

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

В частности для получения текущего состояния PPP намного лучше использовать SCNetworkConnectionCopyExtendedStatus функция в SCNetworkConnection API (определенный в SCNetworkConnection.h файл в платформе Конфигурации системы). Используя эту функцию, можно получить очень подробную информацию состояния соединения от контроллера PPP, включая некоторую информацию, никогда не копирующуюся в часть состояния динамической памяти.

Например, когда пользователь принимает решение сделать соединение PPP через модем, существует несколько шагов, которые предпринимает модем, прежде чем соединение наконец установлено. Если Вы регистрируетесь для уведомления на Состоянии PPP, вводят динамическую память (State:/Network/Service/serviceID/PPP/Status), Вы получите уведомление, когда будет обновлено значение этого ключа. При необходимости в информации о состоянии соединения раньше Вы могли бы принять решение получить значение ключа PPP Status сразу после того, как инициируется соединение. Когда Вы сделаете это, однако, Вы получите значение, Разъединенное, пока не завершается соединение. Это вызвано тем, что контроллер PPP не обновляет динамическую память ключ PPP Status, пока соединение не будет завершено. Если, вместо этого, Вы используете SCNetworkConnectionCopyExtendedStatus функционируйте для запроса немедленного оповещения, Вы будете в состоянии наблюдать промежуточные состояния, те, которые Инициализируют, Подключение, Согласовывают, Аутентифицируют, и Связанный. Таким образом, чем если бы Вы просто следили за динамическим магазином, можно стать намного более подробными (и более точный) информация.

Важно помнить, что SCNetworkConnection API, как большая часть другой Конфигурации системы APIs, зависит от определенного с помощью схемы расположения словарей сетевой службы и динамической памяти. Когда Вы используете SCNetworkConnectionCopyExtendedStatus функция для получения информации состояния соединения PPP Вы получаете словарь, содержащий подсловарь для каждого из субкомпонентов службы, таких как PPP, IPv4 и Модем. Для успешной интерпретации информации в этих словарях необходимо знать, как схема определяет расположение пар ключ/значение. Для получения дополнительной информации о структуре этих словарей посмотрите надлежащие разделы в Словаре NetworkServices.

Получение уведомлений

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

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

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

С другой стороны, наблюдая ключи конфигурации ( Setup: ключи в динамической памяти), обычно плохая идея, если Вы не разрабатываете агент конфигурации. Это вызвано тем, что Ваше приложение не имеет никакого способа знать, если, или что еще более важно когда, изменения конфигурации отражаются в рабочей конфигурации системы.