man ifplugd(8) - демон обнаружения канала для Ethernet-устройств

ИМЯ

ifplugd - демон обнаружения канала для Ethernet-устройств

ОБЗОР

ifplugd [опции]

ОПИСАНИЕ

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

Он использует родную программы ifup/ifdown вашего дистрибутива, но может быть настроен так, чтобы делать то, что вы хотите делать в случае смены состояния интерфейса. Он может игнорировать краткосрочные отключения (опция -d) или подключения (опция -u).

ifplugd может использоваться в режиме "совместимости" указанием опции -F в командной строке. Однако ifplugd не будет поправлять работу сетевых драйверов, которые не поддерживают запросы статуса соединения, считая их всегда активными.

ОПЦИИ

-a | --no-auto

Не включать интерфейс автоматически (по умолчанию выключено).

-n | --no-daemon

Не становиться демоном (для отладки) (по умолчанию выключено).

-s | --no-syslog

Использовать стандартный вывод вместо syslog (для отладки) (по умолчанию выключено).

-b | --no-beep

Не пищать (выключить), перекрывает --no-beep-up и --no-beep-down.

-U | --no-beep-up

Не пищать при включении интерфейса (выключено).

-D | --no-beep-down

Не пищать при выключении интерфейса (выключено).

-f | --ignore-fail

Игнорировать обнаруженные ошибки, пробуя повторить действие. Ошибки обрабатываются как "отсутствие канала" ("no link"). (По умолчанию выключено.)

-F | --ignore-fail-positive

Игнорировать обнаруженные ошибки, пробуя повторить действие. Ошибки обрабатываются как "канал обнаружен" ("link detected"). (По умолчанию выключено.)

-i | --iface=IFACE

Указать Ethernet-интерфейс (по умолчанию - eth0).

-r | --run=EXEC

Указать программу для запуска при смене состояния канала (по умолчанию - /etc/ifplugd/ifplugd.action).

-I | --ignore-retval

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

-t | --poll-time=SECS

Указать время опроса в секундах (по умолчанию - 1).

-u | --delay-up=SECS

Указать задержку перед настройкой интерфейса (по умолчанию - 0).

-d | --delay-down=SECS

Указать задержку перед сбросом настроек интерфейса (по умолчанию - 5).

-m | --api-mode=MODE

Принудительно использовать указанный интерфейс ioctl() для обнаружения состояния канала. Возможные значения: auto, iff, wlan, ethtool, mii, и priv для автоматического обнаружения, обнаружения по флагу интерфейса (IFF_RUNNING), по беcпроводному расширению, по SIOCETHTOOL, по SIOCGMIIREG, и по SIOCPRIV соответственно. Важен только первый символ аргумента, вне зависимости от регистра. (По умолчанию - auto.)

-p | --no-startup

Не вызывать сценария для запуска сети при запуске демона (по умолчанию - выключено).

-q | --no-shutdown

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

-w | --wait-on-fork

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

-W | --wait-on-kill

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

.

-x | --extra-arg=ARG

Указать дополнительный аргумент, который будет передан в исполняемый сценарий.

-M | --monitor

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

-h | --help

Показать справку.

-k | --kill

Завершить работу демона. (Укажите опцию -i, чтобы выбрать экземпляр демона, работу которого надо завершить.)

-c | --check-running

Проверить запущен ли демон для указанного сетевого интерфейса. Возвращает значение 0, если демон уже запущен, или 255, если нет.

-v | --version

Показать версию.

-S | --supend

Приостановить запущенного демона. Демон больше не будет проверять состояние канала, пока ему не прикажут обратное (опция -R). (Укажите -i для выбора экземпляра демона, которого нужно приостановить.)

-R | --resume

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

-z | --info

Запросить, чтобы запущенный демон записал информацию о своём состоянии в syslog. (Укажите -i для выбора экземпляра демона, которому отправляется запрос.)

ФАЙЛЫ

/etc/default/ifplugd: этот файл используется сценарием инициализации /etc/init.d/ifplugd и содержит интерфейсы, за которыми нужно наблюдать и опции, которые нужно использовать.

/etc/ifplugd/ifplugd.action: это сценарий, который будет вызван демоном при смене состояния интерфейса. Он так же приниает два дополнительных аргумента: первый - имя интерфейса (например eth0) и второй - "up" или "down".

/var/run/ifplugd.<iface>.pid: файл с идентификатором процеса ifplugd.

ОКРУЖЕНИЕ

Выполняемый скрипт может вызываться с двумя установленными переменными:

IFPLUGD_PREVIOUS

Предыдущее состояние канала. Может принимать значения "up", "down" "error" или "disabled". Бывшее значение должно быть очевидно, последнее установленое при запуске демона.

IFPLUGD_CURRENT

Текущее состояние канала. Список возможный значений смотри выше.

СИГНАЛЫ

SIGINT, SIGTERM

ifplugd может закончить работу, возможно исполнив скрипт выхода. Это достигается указанием опции -k ifplugd.

SIGQUIT

ifplugd завершит работу, не запуская сценарий завершения работы.

SIGHUP

ifplugd запишет информацию о своём состоянии в syslog. Эта же возможность доступна с помощью опции -z.

SIGUSR1

ifplugd перейдёт в режим приостановки. (-S)

SIGUSR2

ifplugd возобновит работу, выйдя из режима приостановки. (-R)

АВТОР

ifplugd написан Линнартом Паттерингом (Lennart Poettering) <mzvscyhtq (at) 0pointer (dot) de>. ifplugd доступен по адресу http://0pointer.de/lennart/projects/ifplugd/

СМОТРИ ТАКЖЕ

ifplugd.conf(5), ifup(8), interfaces(5), ifconfig(8), ifplugstatus(8)

ЗАМЕЧАНИЕ

Страница руководства написана с использованием xmltoman(1) Оливера Курта ( Oliver Kurth).