INTERFACES

НАЗВАНИЕ

/etc/network/interfaces − конфигурация сетевого интерфейса для ifup и ifdown

ОПИСАНИЕ

/etc/network/interfaces содержит информацию по настройке сетевого интерфейса для команд ifup(8) и ifdown(8). Здесь вы указываете, каким образом ваша система подключена к сети.

Строки, которые начинаются с символа ’#’, игнорируются. Обратите внимание, что комментарии с явным указанием конца строки НЕ поддерживаются, комментарии должны занимать одну строку.

Строка может быть перенесена на новую строку для удобства чтения, для этого в конце строки необходим символ "\".

Файл состоит из нуля или более строф "iface", "mapping", "auto" и "allow−", "source" и "source−directory". Ниже приведён пример.

auto eth0 allow−hotplug eth1

source interfaces.d/machine−dependent

source−directory interfaces.d

mapping eth0
     script /usr/local/sbin/map−scheme
     map HOME eth0−home
     map WORK eth0−work

iface eth0−home inet static
     address 192.168.1.1
     netmask 255.255.255.0
     up flush−mail

iface eth0−work inet dhcp

iface eth1 inet dhcp

Строки, начинающиеся со слова "auto", используются для идентификации физических интерфейсов при их подъёме во время запуска ifup с опцией −a. (Эта опция используется сценариями загрузки системы.) Имена физических интерфейсов должны следовать за словом "auto" в той же строке. Может быть несколько строф "auto". ifup поднимет названные интерфейсы в порядке их перечисления.

Строки, начинающиеся с "allow−" используются для идентификации интерфейсов, которые должны быть подняты автоматически различными подсистемами. Это может быть сделано, например, с использованием команды "ifup −−allow=hotplug eth0 eth1", которая будет поднимать только eth0 или eth1, если они перечислены в строке "allow−hotplug". Учтите, что "allow−auto" и "auto" − синонимы.

Строки, начинающиеся с "source" используются для обозначения строф из других файлов, так что конфигурация может быть поделена на несколько файлов. После слова "source" следует путь к подключаемому файлу. Можно использовать символы шаблона оболочки. (За подробностями обращайтесь к wordexp(3).)

Ключевое слово "source−directory" используется для подключения нескольких файлов сразу, без их поимённого указания и без использования шаблонов оболочки. Дополнительно, при использовании "source−directory" имена файлов проверяются на соответствие регулярному выражению ^[a−zA−Z0−9_−]+$. Другими словами, имена могу состоять только из букв ASCII в верхнем и нижнем регистре, цифр ASCII, подчёркиваний и минусов−дефисов ASCII. В пути к каталогу можно указывать символы шаблонов оболочки.

Если подключаемый файл или каталог не начинается с косой черты, считается что путь задан относительно того каталога, в котором находится файл, содержащий ключевое слово. В примере выше, если файл располагается в /etc/network/interfaces, подразумевается что включаемые файлы располагаются внутри /etc/network.

В настоящее время "source−directory" не поддерживается программами network−manager и guessnet.

По умолчанию, на только что установленной системе Debian файл interfaces включает строки из файлов в каталоге /etc/network/interfaces.d.

Строфы, начинающиеся со слова "mapping", используются для определения, какой логический интерфейс соответствует физическому интерфейсу, который будет поднят. Первая строка строфы отображения (mapping) состоит из слова "mapping" с последующим шаблоном, соответствующим синтаксису глобальной оболочки. Каждая такая строфа отображения должна содержать определение сценария. Именованный сцеанрий запускается с именем физического интерфейса в качестве аргумента и с передачей на его стандартный вход всех следующих "map" строк (без ведущей "map") в строфе. Сценарий перед завершением должен вывести строку на стандартный вывод. Обратитесь к /usr/share/doc/ifupdown/examples за примерами того, что должен вывести сценарий.

Отображение имени состоит из поиска необходимого шаблона отображения и запуска сценария, соответствующего первому совпадению; сценарий выводит имя, в которое будет отображено исходное имя.

ifup, в качестве его первого обязательного аргумента, обычно передается имя физического интерфейса. ifup так же использует это имя как начальное логическое имя интерфейса, если оно не сопровождается суффиксом вида =LOGICAL, в этом же случае ifup выбирает LOGICAL в качестве начального логического имени интерфейса. Затем это название отображения, возможно более одного раза в соответствии с последующими спецификациями отображения, до тех пор пока больше не останется доступных отображений. Если окончательное имя − это имя некого определенного логического интерфейса, тогда ifup попытается поднять физический интерфейс в качестве этого логического интерфейса. В противном случае ifup закончит работу с ошибкой.

Строфы, определяющие логические интерфейсы, начинаются со строки, содержащей слово "iface", которая сопровождается именем логического интерфейса. В простых конфигурациях, без строф отображения, это имя просто должно быть именем физического интерфейса, к которому будут применены настройки. (Сценарий отображения по умолчанию действует подобно команде echo.) За именем интерфейса следует название семейства адресов, которое использует интерфейс. Это может быть "inet" для сетей TCP/IP, но имеется так же поддержка сетей IPX ("ipx"), и сетей IPv6 ("inet6"). За ним следует название метода, используемого для настройки интерфейса.

Дополнительные опции могут быть заданы в последующих строках строфы. Доступность опций зависит от семейства и метода, как описано ниже. Дополнительные опции могут предоставляться другими пакетами Debian. Например, пакет wireless−tools предоставляет несколько опций, начинающихся с "wireless−", которые можно использовать для настройки интерфейса с помощью iwconfig(8). (Обратитесь к wireless(7) за подробностями.)

Опции обычно содержат отступ для ясности (как в примере выше) но это не обязательно.

ИНТЕРФЕЙСЫ VLAN И МОСТЫ

Для лёгкости настройки интерфейсов VLAN, интерфейсы, содержащие . в имени, настраиваются как тегированные интерфейсы 802.1q. Например, интерфейс eth0.1 − это виртуальный интерфейс с идентификатором VLAN 1 на физическом интерфейсе eth0.

В целях совместимости с пакетом bridge−utils настройка интерфейса VLAN не производится, если указана опция bridge_ports.

ОПЦИИ IFACE

Следующие "командные" опции доступны для любого семейства и метода. Каждая из этих опций может быть задана несколько раз в одной строфе, в этом случае команды исполняются в том порядке, в котором они появляются в строфе. (Чтобы результат выполнения команды всегда был успешным, можно добавить к команде "|| true". )
pre−up команда

Запустить команду до поднятия интерфейса. Если команда завершается с ошибкой, тогда ifup не отмечает интерфейс как настроенный, выводит сообщение об ошибке и завершается со статусом 0. В будущем это поведение может измениться.

up команда
post−up команда

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

down команда
pre−down команда

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

post−down команда

Запустить команду после отключения интерфейса. Если команда завершается с ошибкой, ifdown помечает интерфейс как не настроенный и завершается со статусом 0. В будущем это поведение может измениться.

Для каждой из вышеперечисленных опций существует каталог /etc/network/if−<опция>.d/, сценарии в котором запускаются (без аргументов) с помощью run−parts(8) после обработки самих опций. Отметим, что post−up и pre−down − псевдонимы, поэтому файлы из соответствующих каталогов не обрабатываются. Вместо них используйте каталоги if−up.d и if−down.d.

Все эти команды имеют доступ к следующим переменным окружения.

LOGICAL

Логическое имя обрабатываемого интерфейса.

ADDRFAM

Семейство адресов интерфейса.

VERBOSITY

Указывает, что используется опция −−verbose; установлена в 1 если это так, или 0 − если нет.

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

При вызове ifupdown с опцией −−all перед обработкой интерфейсов вызываются все скрипты−обработчики (pre−up или down) с IFACE равным "−−all", LOGICAL равным значению параметра −−allow (или "auto", если не указан), ADDRFAM="meta" и METHOD="none". После того, как все обработанные интерфейсы активированы или деактивированы, выполняются соответствующие скрипты (up или post−down).

СЕМЕЙСТВО АДРЕСОВ INET

Этот раздел описывает методы, доступные для семейства адресов inet.

Метод loopback
Этот метод может использоваться для описания интерфейса обратной петли IPv4.

Опции

(Нет опций)

Метод static
Этот метод может использоваться для описания Ethernet−интерфейсов со статически выделенными IPv4 адресами.

Опции

address адрес

Адрес (четыре числа, разделённых точками с косой чертой и маской). Требуется.

netmask маска_сети

Маска сети (четыре числа, разделённых точками или CIDR). Требуется.

broadcast широковещательный_адрес

Широковещательный адрес (четыре числа, разделённых точками, + или −). Значение по умолчанию: "+".

metric метрика

Метрика маршрутизации для шлюза по умолчанию (целое число).

gateway адрес

Шлюз по умолчанию (четыре числа, разделённых точками).

pointopoint адрес

Адрес удалённой точки (четыре числа, разделённых точками). Обратите внимание на написание "point−to".

hwaddress адрес

Адрес link local.

mtu размер

Размер MTU.

Метод manual
Этот метод может использоваться для описания интерфейсов, для которых нет настроек применяемых по умолчанию. Такие интерфейсы могут настраиваться вручную, подразумеваемыми командами up и down, или сценариями из каталогов /etc/network/if−*.d.

Опции

(Нет опций)

Метод dhcp
Этот метод может использоваться для получения адреса через DHCP любым из перечисленных инструментов: dhclient, pump, udhcpc, dhcpcd. (Они были перечислены в порядке их приоритета.) Если у вас сложная конфигурация DHCP, вам следует знать, что некоторые из клиентов используют собственные настроечные файлы и не получают настроечную информацию посредством ifup.

Опции

hostname имя_узла

Запрашиваемое имя узла (pump, dhcpcd, udhcpc).

metric метрика

Метрика для добавляемых маршрутов (dhclient)

leasehours часы_аренды

Предпочитаемое время аренды в часах (pump).

leasetime время_аренды

Предпочитаемое время аренды в секундах (dhcpcd).

vendor производитель

Идентификатор класса производителя (dhcpcd).

client клиент

Идентификатор клиента (dhcpcd).

hwaddress адрес

Аппаратный адрес.

Метод bootp
Метод может использоваться для получения адреса через bootp.

Опции

bootfile файл

Сообщает серверу какой файл использовать в качестве загрузочного.

server адрес

Использовать указанный IP−адрес адрес для связи с сервером.

hwaddr адрес

Использовать указанный аппаратный адрес вместо реального.

Метод tunnel
Этот метод используется для создания туннелей GRE или IPIP. Нужен выполняемый файл ip из пакета iproute. Для туннелей GRE может понадобиться загрузить модуль ip_gre, а для туннелей IPIP − модуль ipip.

Опции

address адрес

Локальный адрес (четыре числа, разделённых точками). Требуется.

mode тип

Тип туннеля (GRE или IPIP). Требуется.

endpoint адрес

Адрес удалённой точки туннеля. Требуется.

dstaddr адрес

Удалённый адрес (удалённый адрес внутри туннеля).

local адрес

Адрес локальной конца туннеля.

gateway адрес

Шлюз по умолчанию.

ttl время

Настройка TTL.

mtu размер

Размер MTU.

Метод ppp
Этот метод использует pon/poff для настройки интерфейса PPP. Обратитесь к этим командам за подробностями.

Опции

provider имя

Использовать имя в качестве провайдера (из /etc/ppp/peers).

unit число

Использовать число как номер интерфейса ppp.

options строка

Передать pon дополнительные опции из строки.

Метод wvdial
Этот метод использует wvdial для настройки интерфейса PPP. Обратитесь к этой команде за подробностями.

Опции

provider имя

Использовать имя в качестве провайдера (из /etc/wvdial.conf).

Метод ipv4ll
В этом методе для настройки интерфейса используется avahi−autoipd, который назначает адрес IPv4 Link−Layer (семейство 169.254.0.0/16). Этот метод также называют APIPA и IPAC, а разговорной речи называется "адрес Zeroconf".

Опции

(Нет опций)

СЕМЕЙСТВО АДРЕСОВ IPX

Этот раздел описывает методы, доступные для семейства адресов ipx.

Метод static
Этот метод может использоваться для настройки интерфейса IPX. Он требует команду ipx_interface.

Опции

frame тип

Тип используемых кадров Ethernet (например, 802.2).

netnum идентификатор

Номер сети.

Метод dynamic
Этот метод может использоваться для динамической настройки интерфейса IPX.

Опции

frame тип

Тип используемых кадров Ethernet (например, 802.2).

СЕМЕЙСТВО АДРЕСОВ INET6

Этот раздел описывает методы, доступные для семейства адресов inet6.

Метод auto
Этот метод используется для автоматического назначения интерфейсам адресов IPv6. При самостоятельном использовании этой опции опции RDNSS применяться не будут. Чтобы воспользоваться этими опциями, нужно установить, настроить и запустить демона rdnssd. Если включена поддержка DHCPv6 без учёта состояния, от DHCP сервера будут получены дополнительные настройки сети, такие как серверы DNS и NTP. Отметим, что ifdown не освобождает арендованный адрес (это известная недоработка).

Опции

privext целое_число

Расширения для секретности (RFC4941) (0=выключено, 1=назначено, 2=предпочитается)

accept_ra целое_число

Принимать анонсы маршрутизатора (0=отключено, 1=включено, 2=включено+маршрутизация). Значение по умолчанию − "2"

dhcp целое_число

Использовать DHCPv6 без учёта состояния (0=отключено, 1=включено)

Метод loopback
Этот метод может использоваться для описания интерфейса обратной петли IPv6.

Опции

(Нет опций)

Метод static
Этот метод может использоваться для определения интерфейсов со статически назначенными IPv6 адресами. По умолчанию для этого интерфейса отключена автонастройка без учёта состояния.

Опции

address адрес

Адрес (разделенный двоеточиями с маской после косой черты). Требуется.

netmask маска_сети

Маска сети (количество бит, например 64).

gateway адрес

Шлюз по умолчанию (разделенный двоеточиями).

media тип

Тип носителя, зависящий от драйвера.

hwaddress адрес

Аппаратный адрес.

mtu размер

Размер MTU.

accept_ra целое_число

Принимать анонсы маршрутизатора (0=отключено, 1=включено, 2=включено+маршрутизация)

autoconf целое_число

Предпочитать автонастройку без учёта состояния (0=отключено, 1=включено). Значение по умолчанию − "0"

privext целое_число

Расширения для секретности (RFC3041) (0=выключено, 1=назначено, 2=предпочитается)

preferred−lifetime целое_число

Время, в течение которого адрес остаётся предпочитаемым.

dad−attempts

Количество попыток устранить конфликт адресов (0 − отключено). Значение по умолчанию − "60".

dad−interval

Интервал в секундах между попытками устранить конфликт адресов. Значение по умолчанию − "0.1"

Метод manual
Этот метод может использоваться для описания интерфейсов, для которых нет настроек применяемых по умолчанию. Такие интерфейсы могут настраиваться вручную, подразумеваемыми командами up и down, или сценариями из каталогов /etc/network/if−*.d.

Опции

(Нет опций)

Метод dhcp
Метод может использоваться для получения настроек сетевого интерфейса через DHCPv6 без учёта состояний при помощи программы dhclient. В DHCPv6 с учётом состояний за назначение адресов клиентам отвечает DHCP−сервер.

Опции

hwaddress адрес

Аппаратный адрес.

accept_ra целое_число

Принимать анонсы маршрутизатора (0=отключено, 1=включено, 2=включено+маршрутизация). Значение по умолчанию − "1"

autoconf целое_число

Предпочитать автонастройку без учёта состояния (0=отключено, 1=включено).

Метод v4tunnel
Этот метод может использоваться для настройки туннеля IPv6−over−IPv4. Для него необходима команда ip из пакета iproute.

Опции

address адрес

Необходимый адрес (разделенный двоеточиями).

netmask маска_сети

Маска сети (количество бит, например 64).

endpoint адрес

Необходимый адрес удалённой точки туннеля (IPv4 − четвёрка чисел, разделённых точками).

local адрес

Адрес локальной точки (IPv4 − четвёрка чисел, разделённых точками).

gateway адрес

Шлюз по умолчанию (разделенный двоеточиями).

ttl время

Настройка TTL.

mtu размер

Размер MTU.

preferred−lifetime целое_число

Время, в течение которого адрес остаётся предпочитаемым.

Метод 6to4
Этот метод может использоваться для настройки туннеля 6to4. Для него необходима команда ip из пакета iproute.

Опции

local адрес

Адрес локального конца туннеля (IPv4 − четвёрка чисел, разделённых точками). Требуется.

ttl время

Настройка TTL.

mtu размер

Размер MTU.

preferred−lifetime целое_число

Время, в течение которого адрес остаётся предпочитаемым.

СЕМЕЙСТВО АДРЕСОВ CAN

Этот раздел описывает методы, доступные для семейства адресов can.

Метод static
Этот метод может использоваться для настройки интерфейса CAN (Controller Area Network − сеть контроллеров). Для него необходима команда ip из пакета iproute.

Опции

bitrate битовая_скорость

Битовая скорость (1..1000000 бит/с). Требуется.

samplepoint точка_образец

Точка−образец (0.000..0.999).

loopback петлевой_интерфейс

Принимать отправленные сообщения CAN (on − включить|off − выключить)

listenonly только_приём

Режим только приёма (on − включить|off − выключить)

triple триплет

Режим тройного сэмплирования (on − включить|off − выключить)

oneshot однократный_режим

Однократный режим (on − включить|off − выключить)

berr berr

Включить отчёт berr (on − включить|off − выключить)

ИЗВЕСТНЫЕ НЕИСПРАВНОСТИ/ОГРАНИЧЕНИЯ

ifup и ifdown работают с так называемыми "физическими" именами интерфейсов. Эти имена обозначены оборудованию ядром. К несчастью может случиться так, что ядро каждый раз будет назначать разные имена физических интерфейсов одному и тому же оборудованию; например, тот что называется "eth0" после перезагрузки может называться "eth1" или наоборот. Это создаёт проблему, если вы хотите настроить интерфейсы соответствующим образом. Для избежания подобного следует использовать сцеанрии отображения, которые выбирают логические имена интерфейсов в соответствии со свойствами аппаратного интерфейса. Смотри сценарий get−mac−address.sh из каталога примеров, который является примером такого сценария отображения. Смотри также Debian bug #101728.

АВТОР

Комплекс программ ifupdown был написан Энтони Таунсом (Anthony Towns) <aj@azure.humbug.org.au>. Это руководство предоставлено Джо Хессом (Joey Hess) <joey@kitenet.net>.

АВТОР ПЕРЕВОДА

Перевод на русский язык выполнил Владимир Ступин <vladimir@stupin.su>.

СМОТРИ ТАКЖЕ

ifup(8), ip(8), ifconfig(8), run−parts(8), resolvconf(8).

Для получения консультаций по настройке этого пакета читайте главу Настройка сети из Справочного руководства Debian, которое доступно по адресу http://www.debian.org/doc/manuals/debian−reference/ch05.en.html или в пакете debian−reference−en.

Примеры настройки интерфейсов можно найти в /usr/share/doc/ifupdown/examples/network−interfaces.gz.