title: pg3(8)

summary: отправить поток UDP пакетов

text:
# pg3(8)

## ИМЯ
pg3, ipg, pgset - отправить поток UDP пакетов

## ОБЗОР
source ipg

pg

pgset КОМАНДА

## ОПИСАНИЕ
ipg - не программа, это скрипт, который должен быть использован с командой source оболочки bash. При использовании с командой source скрипт загружает модуль pg3 и экспортирует несколько функций, доступных из родительской оболочки. Этими макросами являются: pg (начать отправку пакетов и получить результаты запуска) и pgset (настройка генератора пакетов).

pgset может отправлять следующие команды модулю pg3:

## КОМАНДЫ
odev УСТРОЙСТВА

Имя УСТРОЙСТВА Ethernet для тестирования. Обратите внимание на предупреждение ниже.

pkt_size БАЙТЫ

Размер генерируемых пакетов. Размер включает все заголовки: UDP, IP, MAC, но не принимает во внимание дополнительные расходы для носителя, т.е. FCS и различные "набивки" (padding).

frags КОЛИЧЕСТВО

Каждый пакет будет содержать указанное КОЛИЧЕСТВО фрагментов. Максимально возможное значение для linux-2.4 равно 6. Далеко не все устройства поддерживают фрагментированные буфера.

count КОЛИЧЕСТВО

Отправить поток из указанного КОЛИЧЕСТВА пакетов и остановиться после этого.

ipg ЗАДЕРЖКА

Ввести искусственную ЗАДЕРЖКУ (в микросекундах) между пакетами.

dst IP_АДРЕС

Указать IP-адрес назначения, куда поток будет отправлен. Внимание! Никогда не устанавливайте этот адрес в случайное значение. pg3 - не игрушка, он создает действительно сильный поток. По умолчанию используется 0.0.0.0.

dst MAC_АДРЕС

Выбрать по MAC-адресу точку назначения, на которую будет отправлен поток. По умолчанию используется 00:00:00:00:00:00 (в надежде, что поток не будет принят любым узлом на LAN).

stop

Остановить вставку пакетов.

## ПРЕДУПРЕЖДЕНИЕ
Когда в качестве устройства вывода используется какое-то случайное устройство, отличное от аппаратного Ethernet-устройства, pg3 вызовет фатальный сбой работы ядра.

Не используйте на VLAN, ethertap, VTUN и прочих устройствах, который эмулируют Ethernet, при этом не являясь реальными Ethernet устройствами.

## АВТОР
pg3 была создана Робертом Олсоном (Robert Olsson) <robert.olsson@its.uu.se>.

## БЕЗОПАСНОСТЬ
Может быть использовано только администратором.

Утилита создает поток пакетов, который вряд ли будет обработан даже высококлассными машинами. Для примера, поток подавляет гигабитное соединение 60-байтными пакетами, когда используется с Intel e1000. Столкнувшись с подобным подобным потоком, коммутаторы, маршрутизатор и конечные хосты могут зависнуть, аварийно завершить работу или выйти из строя. Используйте только в тестовой лабораторной среде.

## ДОСТУПНОСТЬ
pg3 входит в пакет iputils и последняя версия доступна в виде исходного кода на анонимном ftp ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Перевод с английского Виктор Ерёмин <ErV2005@rambler.ru> 2007


ping

package: man-pages-ru-extra

title: ping(8)

text:
# ping(8)

## ИМЯ
ping, ping6 - посылает пакеты ICMP ECHO_REQUEST хостам сети

## ОБЗОР
ping [ -LRUbdfnqrvVaAB] [ -c количество] [ -i интервал] [ -l преднагрузка] [ -p шаблон] [ -s размер-пакета] [ -t ttl] [ -w ограничение-на-время-работы] [ -F идентификатор-потока] [ -I адрес] [ -M указание] [ -Q тип-обслуживания] [ -S буфер-отправки] [ -T параметр-временной-метки] [ -W время-ожидания-ответа] [ переход ...] назначение

## ОПИСАНИЕ
ping использует обязательные датаграммы ECHO_REQUEST протокола ICMP для получения по этому протоколу ответов ECHO_RESPONSE от хоста или шлюза.

Датаграммы ECHO_REQUEST состоят из заголовков IP и ICMP, структуры данных struct timeval и произвольного числа несмысловых байтов для заполнения пакета.

## ОПЦИИ
-a

Сопровождать работу программы звуком.

-A

Адаптировать интервал между отправками пакетов к длительности их доставки и возврата. Таким образом, если только не выполняется преднагрузка, в любой момент времени может быть не больше одного пакета, на который не получен ответ. Минимальный интервал для не администратора - 200 мс. В сетях с низким rtt данный режим эквивалентен лавинообразному.

-b

Разрешить использование широковещательного адреса в качестве целевого.

-B

Запретить изменение исходного адреса для пакетов во время работы программы. Исходный адрес определяется в начале работы ping.

-c количество

Остановить работу после передачи заданного количества пакетов ECHO_REQUEST. Если задано ограничение-на-время-работы, программа будет ждать указанное количество ответных пакетов ECHO_REPLY в указанный период.

-d

Устанавливает параметр SO_DEBUG на используемый сокет. Примечание: этот параметр не используется ядром Linux.

-F идентификатор-потока

Устанавливать идентификатор-потока в отправляемых пакетах (только для ping6). Если указан нуль, идентификатор-потока будет генерироваться случайно ядром.

-f

Лавинообразный режим. Для каждого пакета ECHO_REQUEST выводится точка (`.'), для каждого ответного пакета ECHO_REPLY - забой (удаление последней точки). Это позволяет наглядно представлять число потерянных пакетов. Если интервал между отправками не задан, последние производятся с наибольшей скоростью (по мере получения ответов) или со скоростью 100 раз в секунду, в зависимости от того, в каком случае получается большая скорость. Задавать нулевой интервал между отправками может только суперпользователь.

-i интервал

Интервал в секундах между отправкой пакетов. По умолчанию между отправкой пакетов делается пауза в 1 секунду, либо, в случае лавинообразного режима, отправка производится без пауз. Задавать значения меньше 0.2 может только суперпользователь.

-I адрес

Установить адрес источника в указанный. В качестве аргумента может выступать числовой IP-адрес или имя устройства. Этот параметр обязателен при отправке запросов на локально соединённый адрес IPv6.

-l преднагрузка

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

-L

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

-n

Только цифровой вывод. Не расшифровывать имена (символьный вид) адресов.

-p шаблон

Можно указать до 16 несмысловых байтов для заполнения пакетов. Это полезно при диагностике проблем в сети. Например, -p ff заполнит все пакеты единицами символами.

-Q тип-обслуживания

Разряды байта QoS (Quality of Service - качество обслуживания) для датаграмм ICMP. Тип-обслуживания может быть либо десятичным либо шестнадцатеричным числом. Обычно (согласно RFC 1349) это значение интерпретируется так: младший (нулевой) разряд зарезервирован (сейчас используется для управления событиями при переполнении), разряды 1-4 используются для указания собственно типа обслуживания, и разряды 5-7 для приоритета (IP-предпочтения). Возможные типы обслуживания: минимизация стоимости - 0x02, максимизация надёжности - 0x04, максимизация пропускной способности - 0x08 минимизация задержек - 0x10. Одновременно можно указывать только один из четырёх перечисленных разрядов. Возможный диапазон значения приоритета - от приоритетного (0x20) до управляемого сетью (0xe0). Для указания высокого приоритета необходимы права суперпользователем (точнее, должно быть доступна возможность CAP_NET_ADMIN). Разряд 0x01 можно устанавливать только если в ядре включен ECN. В RFC 2474 этот байт переопределён как DS (Differentiated Services - дифференцированные службы): разряды 0-1 отведены для отдельных данных (тут будет использоваться ECN) разряды 2-7 для DSCP (Differentiated Services Codepoint - точка кода дифференцированных служб)

-q

Выводить только начальные и итоговые данные (не выводить информацию об отдельных запросах).

-R

Записывать маршрут. Для пакетов ECHO_REQUEST будет включен параметр RECORD_ROUTE и на экран будет выведен буфер маршрута для возвращённых пакетов. Заметим, что в заголовок IP помещается не больше 9 таких маршрутов. Многие узлы игнорируют или не отбрасывают этот параметр.

-r

Не использовать обычные таблицы маршрутизации и передавать данные прямо на компьютер, подключенный к интерфейсу. Если компьютер не находится в сети с прямым подключением, то возвращается сообщение об ошибке. Этот параметр может использоваться вместе с -I для проверки локальной системы через интерфейс, по которому не идет маршрутизация (например после того, как интерфейс был сброшен routed(8)).

-s размер-пакета

Размер пакетов для пересылки. По умолчанию - 56, что соответствует размеру 64 байта после добавления 8 байтов заголовка ICMP.

-S буфер-отправки

Размер буфера отправки соединения. По умолчанию буферизируется не больше одного пакета.

-t ttl

Время актуальности пакета IP (ttl - Time to Live).

-T параметр-временной-метки

Параметры временной метки IP. Возможные значения параметра-временной-метки: tsonly (только временная метка), tsandaddr (временная метка и адреса) и tsprespec хост1 [хост2 [хост3 [хост4]]] (отмечать переходы).

-M указание

Стратегия обнаружения маршрута MTU. Возможные значения: do (запретить фрагментацию, даже локальную), want (выполнять обнаружение PMTU, фрагментировать локально если размер пакета слишком большой) и dont (не устанавливать флаг DF).

-U

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

-v

Выводить подробную информацию.

-V

Вывести информацию о версии и закончить работу.

-w ограничение-на-время-работы

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

-W время-ожидания-ответа

Время ожидания (в секундах) ответного пакета. Принимается во внимание только если не было принято ни одного ответа. В противном случае программа ожидает получения двух ответов.

При использовании команды ping для локализации неполадки сначала запустите её с адресом локального хоста для проверки работоспособности локального сетевого интерфейса. Затем проверяйте связь посредством ping со всё более удалёнными компьютерами и шлюзами. Время прохождения сигналов в обе стороны и потери пакетов подсчитываются и анализируются позднее. Если принимаются дублированные пакеты, то они не включаются в статистику утерянных пакетов, хотя время прохода таких пакетов включается в статистику минимального/среднего/максимального времени. После отправки и получения указанного количества пакетов или при прерывании работы программы сигналом выводится краткий итог работы. Более краткую статистику можно получить без прерывания процесса с помощью сигнала SIGQUIT.

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

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

## ОПИСАНИЕ ПАКЕТОВ ICMP
Заголовок IP без параметров имеет размер 20 байтов. Пакет ICMP ECHO_REQUEST содержит дополнительные 8 байтов, предназначенные для заголовка ICMP, и произвольное количество заполняющих байтов (для обеспечения требуемого размера пакета), определяемое аргументом размер-пакета данных (по умолчанию 56). Поэтому количество полученных данных из пакета IP типа ICMP ECHO_REPLY всегда будет на 8 байтов (заголовок ICMP) больше, чем задаваемое.

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

## ПОВТОРЯЮЩИЕСЯ И ПОВРЕЖДЁННЫЕ ПАКЕТЫ
Программа выводит сообщения о дублированных и повреждённых пакетах. Дублированные пакеты свидетельствуют о ненадёжной связи на уровне канала. Они могут появляться в разных ситуациях и если это происходит с небольшой частотой, то на это можно не обращать внимания.

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

## ТЕСТИРОВАНИЕ НА РАЗЛИЧНЫХ ДАННЫХ
(Меж)сетевая часть механизма передачи данных не должна обрабатывать пакеты по-разному, в зависимости от содержащихся в них данных. К сожалению такие проблемы часто встречаются в сетях и остаются невыявленными достаточно долго. Во многих случаях оказывается, что некорректно обрабатывается некоторый вырожденный шаблон, например, состоящий из одних нулей или единиц, либо близкий к нему. Простой проверки по вырожденным шаблонам данных недостаточно, т.к речь идёт о данных на уровне канала данных, которые могут соотноситься с указываемыми вами данными самым сложным образом.

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

## ВРЕМЯ АКТУАЛЬНОСТИ (TTL)
Значение TTL для пакетов IP задаёт максимальное количество IP-маршрутизаторов, через которое пакет ещё будет доставляться, а не считаться утерянным. Сейчас каждый маршрутизатор в Интернете уменьшает поле TTL при обработке пакета на единицу.

Согласно спецификации TCP/IP значение поля TTL для пакетов TCP должно быть равно 60, но многие системы используют меньшие значения (4.3 BSD использует 30, 4.2 использует 15).

Максимальное значение данного поля равно 255, и многие Unix-системы устанавливают поле TTL для пакетов ICMP ECHO_REQUEST в 255. Поэтому иногда получается, что вы можете проверить связь командой `ping' до некоторых компьютеров, но не можете связаться с ними программами telnet(1) или ftp(1).

В обычном режиме ping выводит значения времени актуальности принятых (возвращённых) пакетов. При приёме пакета удалённой системой она может выполнить одно из трёх возможных действий с полем TTL в ответ:

•

Не изменять его; это делали системы Berkeley Unix до выпуска BSD 4.3 Tahoe. TTL в принятом пакете будет 255 минус количество пройденных маршрутизаторов на пути в обе стороны.

•

Установить его в 255: это то, что системы Berkeley Unix делают сейчас. В этом случае значение TTL в принятом пакете будет 255 минус количество пройденных маршрутизаторов от удалённой системы до исходной.

•

Установить его в какое-либо другое значение. Некоторые машины устанавливают его равным используемому для TCP пакетов, например, либо 30 либо 60. Другие системы могут использовать вообще непредсказуемые значения.

## ИЗВЕСТНЫЕ ОШИБКИ
•

Многие узлы и шлюзы игнорируют параметр RECORD_ROUTE.

•

Максимальная длина заголовка IP слишком мала для полноценной работы таких параметров, как RECORD_ROUTE.

•

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

## СМ. ТАКЖЕ
netstat(1), ifconfig(8).

## ИСТОРИЯ
Команда ping впервые появилась в 4.3BSD.

Настоящим документом описывается адаптированная для Linux версия программы.

## БЕЗОПАСНОСТЬ
Для ping требуется функция CAP_NET_RAWIO. На программу может быть установлен бит set-uid root.

## РАСПРОСТРАНЕНИЕ
ping является частью пакета iputils, который доступен по адресу ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Николай Шафоростов <shafff@ukr.net> 2007

branch: sisyphus


pppdump

title: pppdump(8)

text:
# pppdump(8)

## НАЗВАНИЕ
pppdump - преобразует в читабельный формат файл записей PPP

## СИНТАКСИС
pppdump [ -h | -p [ -d ]] [ -r ] [ -m mru ] [ file ... ]

## ОПИСАНИЕ
Утилита pppdump преобразует файлы, записанные с помощью опции pppd record, в формат, понятный для человека. Если указаны одно или более имён файлов, pppdump будет считывать их по очереди, в противном случае чтение производится со стандартного ввода. В любом случае результат записывается в стандартный вывод.

Имеются следующие опции:

-h

Выводит в шестнадцатеричном виде переданные и полученные байты. При отсутствии этой опции или опции -p, байты выводятся в виде символов, а непечатные и не-ASCII символы выводятся как управляющие последовательности.

-p

Собирает переданные и полученные байты в PPP-пакеты, интерпретируя async кадры HDLC и управляющие последовательности, и проверяя FCS (frame check sequence, контрольная последовательность кадра) каждого пакета. Пакеты выводятся в виде шестнадцатеричных значений и символов (непечатные символы выводятся как `.').

-d

Эта опция вместе с опцией -p заставляет pppdump декомпрессировать пакеты, сжатые с помощью методов BSD-Compress или Deflate.

-r

Изменяет индикаторы направления, т.е. значение `send' (`переданные') указываются для полученных байтов и пакетов, а значение `rcvd' (`полученные') - для переданных байтов и пакетов.

-m mru

Использовать mru в качестве MRU (maximum receive unit, максимальная получаемая единица) для обоих направлений соединения при проверке на превышение длины PPP-пакетов (с опцией -p).

## СМОТРИ ТАКЖЕ
pppd(8)

## ПЕРЕВОД
Александр Саввин (savvin@mail.ru) Дек 01, 2002


pppstats

title: pppstats(8)

summary: выводит статистику PPP

text:
# pppstats(8)

## НАЗВАНИЕ
pppstats - выводит статистику PPP

## СИНТАКСИС
pppstats [ -a ] [ -v ] [ -r ] [ -z ] [ -c <count> ] [ -w <secs> ] [ interface ]

## ОПИСАНИЕ
Утилита pppstats создаёт с регулярным интервалом статистический отчёт для указанного интерфейса PPP. Если интерфейс не задан, по умолчанию используется ppp0. Дисплей разбивается на две горизонтальные секции ввода и вывода, в которых формируются колонки статистики, описывающие свойства и значения принимаемых и передаваемых через интерфейс пакетов.

Существуют следующие опции:

-a

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

-c count

Повторить вывод count раз. Если опция не задана, то отчет по умолчанию выводится 1 раз, если только не указана опция -w- в этом случае отчет выводится бесконечное количество раз.

-r

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

-v

Выводить дополнительную статистику по эффективности алгоритма сжатия TCP-заголовков Van Jacobson'а.

-w wait

Пауза между каждым выводом в wait секунд. Если эта опция не задана, интервал по умолчанию - 5 секунд.

-z

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

На стороне ввода при отсутствии опции -z выводятся следующие поля:

IN

Общее количество байтов, полученных этим интерфейсом.

PACK

Общее количество пакетов, полученных этим интерфейсом.

VJCOMP

Количество TCP-пакетов со сжатыми заголовками, полученных этим интерфейсом.

VJUNC

Количество TCP-пакетов с несжатыми заголовками, полученных этим интерфейсом. Не выводится, если указана опция -r.

VJERR

Количество поврежденных или поддельных TCP-пакетов со сжатыми заголовками, полученных этим интерфейсом. Не выводится, если указана опция -r.

VJTOSS

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

NON-VJ

Общее количество не TCP-пакетов, полученных этим интерфейсом. Выводится только при задании опции -v.

RATIO

Достигнутый коэффициент сжатия принимаемых пакетов используемым методом сжатия, определяется как размер несжатого пакета, делённый на размер сжатого пакета. Выводится только при задании опции -r.

UBYTE

Общее количество принятых байтов после декомпрессии сжатых пакетов. Выводится только при задании опции -r.

На стороне вывода отображаются следующие поля:

OUT

Общее количество байтов, переданных этим интерфейсом.

PACK

Общее количество пакетов, переданных этим интерфейсом.

VJCOMP

Количество TCP-пакетов со сжатыми методом VJ заголовками, переданных этим интерфейсом.

VJUNC

Количество TCP-пакетов с декомпрессированными методом VJ заголовками, переданных этим интерфейсом. Не выводится, если задана опция -r.

NON-VJ

Общее количество не TCP-пакетов, переданных этим интерфейсом. Не выводится, если задана опция -r.

VJSRCH

Количество поисков кешированной записи заголовка для TCP-пакета, сжатого методом VJ. Выводится только при задании опции -v.

VJMISS

Количество безрезультатных поисков кешированной записи заголовка для TCP-пакета, сжатого методом VJ. Выводится только при задании опции -v.

RATIO

Достигнутый коэффициент сжатия передаваемых пакетов используемым методом сжатия, определяется как размер пакета до сжатия, деленный на размер сжатого пакета. Выводится только при задании опции -r.

UBYTE

Общее количество байтов для передачи до применения сжатия пакета. Выводится только при задании опции -r.

Если указана опция -z, pppstats выводит поля, относящиеся к используемому в данный момент алгоритму сжатия пакетов. Если сжатие пакетов не используется, все эти поля будут содержать нули. На стороне приёма выводятся следующие поля:

COMPRESSED BYTE

Количество байт в полученных сжатых пакетах.

COMPRESSED PACK

Количество полученных сжатых пакетов.

INCOMPRESSIBLE BYTE

Количество байт в полученных несжимаемых пакетах (т.е. которые передаются в несжатом виде).

INCOMPRESSIBLE PACK

Количество полученных несжимаемых пакетов.

COMP RATIO

Последний коэффициент сжатия входящих пакетов, определяется как размер несжатого пакета, деленный на размер сжатого пакета (включая как сжимаемые, так и несжимаемые пакеты).

Поля, отображаемые на стороне передачи:

COMPRESSED BYTE

Количество байт в переданных сжатых пакетах.

COMPRESSED PACK

Количество переданных сжатых пакетов.

INCOMPRESSIBLE BYTE

Количество байт в переданных несжимаемых пакетах (т.е. которые передаются в несжатом виде).

INCOMPRESSIBLE PACK

Количество полученных несжимаемых пакетов.

COMP RATIO

Последний коэффициент сжатия передаваемых пакетов.

## СМОТРИ ТАКЖЕ
pppd(8)

## ПЕРЕВОД
Александр Саввин (savvin@mail.ru). Дек 01, 2002


rarpd

title: rarpd(8)

summary: отвечает на запросы RARP

text:
# rarpd(8)

## ИМЯ
rarpd - отвечает на запросы RARP

## СИНТАКСИС
arping [ -aAvde] [ -b bootdir] [ interface]

## ОПИСАНИЕ
Ожидание RARP запросов от клиентов. Если указанный MAC-адрес клиента найден в базе данных /etc/ethers и полученное имя хоста соответствует IP-адресу для данной сети, rarpd отправляет сообщение клиенту сообщение RARPD с IP-адресом.

Для разрешения множества загрузочных серверов в сети rarpd опционально проверяет на наличие Sun-подобных загрузочных образов в каталоге TFTP. Оно должно иметь форму Hexadecimal_IP.ARCH, т.е загружать sparc 193.233.7.98 C1E90762.SUN4M ссылающегося на соответствующий образ для SUM4M в каталоге /etc/tftpboot.

## ВНИМАНИЕ
Это давно устаревшая опция BOOTP и более поздних DHCP протоколов. Однако, многие клиенты всё ещё требуют её для загрузки.

## ОПЦИИ
-a

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

-A

Прослушивает не только RARP, но также и ARP сообщения, многие устаревшие клиенты используют ARP по неизвестным причинам.

-v

Выводить более подробные сведения.

-d

Режим отладки. Не проводите в фоновом режиме.

-e

Не проверять на наличие загрузочного образа, сообщать если MAC-адрес разрешает правильным IP-адресам использование базы /etc/ethers и DNS.

-b bootdir

Каталог загрузочных образов TFTP. По умолчанию /etc/tftpboot

## СМ. ТАКЖЕ
arping(8), tftpd(8).

## АВТОР
rarpd был написан Алексеем Кузнецовым <kuznet@ms2.inr.ac.ru>.

## БЕЗОПАСНОСТЬ
rarpd требует привилегии CAP_NET_RAWIO для прослушивания и отправки пакетов RARP и ARP. Он также требует привилегии CAP_NET_ADMIN, чтобы дать указание ядру для разрешения ARP; это не требуется строго, но многие клиенты (если точнее, большинство) настолько плохо работают с этим, что не способны ответить ARP прежде, чем они окончательно загрузятся. Неважно, что клиенты используют RARPD 2002-ого года со всеми не поддерживаемыми архаизмами 90-ых и более ранних.

## ДОСТУПНОСТЬ
rarpd является частью пакета iputils и последние версии доступны в виде исходного кода на FTP-сервере с анонимным доступом по адресу: ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Перевод с английского russians <pawel5@mail.ru> 2007


rdisc

title: rdisc(8)

summary: демон поиска сетевого шлюза

text:
# rdisc(8)

## ИМЯ
rdisc - демон поиска сетевого шлюза

## СИНТАКСИС
rdisc [ -abdfstvV] [ send_address] [ receive_address]

## ОПИСАНИЕ
rdisc выступает клиентом протокола поиска шлюза по ICMP. rdisc вызывается при загрузке для получения таблиц маршрутизации сети с шлюзами по умолчанию.

rdisc прослушивает широковещательный адрес ALL_HOSTS (224.0.0.1) (или receive_address если он указан в параметрах), ожидая сообщения шлюзов типа ROUTER_ADVERTISE. Сообщения шлюзов, не входящих в текущую сеть, игнорируются. Среди оставшихся адресов шлюзы с самым высоким приоритетом используются как шлюза по умолчанию и каждый из них добавляется в таблицу маршрутизации ядра.

Опционально, rdisc может пропускать режим ожидания объявления шлюзов, отсылая несколько сообщений ROUTER_SOLICITATION на адрес ALL_ROUTERS (224.0.0.2) (или send_address он указан в параметрах).

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

Сторона сервера протокола нахождения шлюзов поддерживается Cisco IOS и другими более или менее полными демонами маршрутизации UNIX, например, gated.

## ОПЦИИ
-a

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

-b

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

-d

Записывать сообщения отладки в syslog.

-f

Запускает rdisc на всё время, даже если шлюзы не найдены. Обычно rdisc ждет три пакета с анонсом и, в случае, если шлюзы не найдены, выходит с ненулевым значением. Если опция -f не указана, то должна быть указана опция -s.

-s

Посылает сначала три запроса, чтобы быстро определить шлюзы при загрузке системы. Если не найдены шлюзы, -s обеспечивает выход из rdisc с ненулевым значением. Может быть отменено опцией -f.

-t

Режим проверки. Не проводите в фоновом режиме.

-v

Выводить более подробные сведения в syslog.

-V

Вывести версию и выйти.

## ИСТОРИЯ
Эта программа разработана Sun Microsystems (смотрите уведомление об авторских правах в файле с исходным кодом). Она была портирована на Linux Алексеем Кузнецовым <kuznet@ms2.inr.ac.ru>.

## СМ. ТАКЖЕ
icmp(7), inet(7), ping(8).

## ЛИТЕРАТУРА
Deering, S.E.,ed "ICMP Router Discovery Messages", RFC1256, Network Information Center, SRI International, Menlo Park, Calif., Сентябрь 1991.

## БЕЗОПАСНОСТЬ
rdisc требует привилегий CAP_NET_RAWIO для прослушивания и отправки пакетов ICMP и CAP_NET_ADMIN для обновления таблиц маршрутизации.

## ДОСТУПНОСТЬ
rdisc часть пакета iputils и последние версии доступны в виде исходного кода на FTP-сервере с анонимным доступом по адресу: ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Перевод с английского russians <pawel5@mail.ru> 2007


rpm

title: rpm(8)

summary: Менеджер пакетов RPM

text:
# rpm(8)

## НАЗВАНИЕ
rpm - Менеджер пакетов RPM

## ИСПОЛЬЗОВАНИЕ

### ЗАПРОС И ПРОВЕРКА ПАКЕТОВ:
rpm {-q|--query} [опции-отбора] [опции-запроса]

rpm {-V|--verify} [опции-отбора] [--nodeps] [--nofiles] [--nomd5] [--noscripts]

rpm {-K|--checksig} [--nogpg] [--nopgp] [--nomd5] файл_пакета ...

### УСТАНОВКА, ОБНОВЛЕНИЕ И УДАЛЕНИЕ ПАКЕТОВ:
rpm {-i|--install} [опции-установки] файл_пакета ...

rpm {-U|--upgrade} [опции-установки] файл_пакета ...

rpm {-F|--freshen} [опции-установки] файл_пакета ...

rpm {-e|--erase} [--allmatches] [--nodeps] [--noscripts] [--notriggers] [--repackage] [--test] файл_пакета ...

### СБОРКА ПАКЕТОВ:
rpm {-ba|-bb|-bp|-bc|-bi|-bl|-bs} [опции-сборки] spec-файл ...

rpm {-ta|-tb|-tp|-tc|-ti|-tl|-ts} [опции-сборки] tarball ...

rpm {--rebuild|--recompile} srpm-файл ...

### РАЗНОЕ
rpm {--initdb|--rebuilddb}

rpm {--addsign|--resign} имя_пакета ...

rpm {--querytags|--showrc}

rpm {--setperms|--setugids} имя_пакета ...

### ОПЦИИ ОТБОРА
[имя_пакета] [-a,--all] [-f,--file файл] [-g,--group группа] [-p,--package файл_пакета] [--querybynumber номер] [--triggeredby имя_пакета] [--whatprovides сервис] [--whatrequires сервис]

### ОПЦИИ ЗАПРОСА
[--changelog] [-c,--configfiles] [-d,--docfiles] [--dump] [--filesbypkg] [-i,--info] [--last] [-l,--list] [--provides] [--qf,--queryformat формат_запроса] [-R,--requires] [--scripts] [-s,--state] [--triggers,--triggerscripts]

### ОПЦИИ УСТАНОВКИ
[--allfiles] [--badreloc] [--excludepath путь] [--excludedocs] [--force] [-h,--hash] [--ignoresize] [--ignorearch] [--ignoreos] [--includedocs] [--justdb] [--nodeps] [--noorder] [--noscripts] [--notriggers] [--oldpackage] [--percent] [--prefix путь] [--relocate старый_путь=новый_путь] [--repackage] [--replacefiles] [--replacepkgs] [--test]

### ОПЦИИ СБОРКИ
[--buildroot каталог] [--clean] [--nobuild] [--rmsource] [--rmspec] [--short-circuit] [--sign] [--target платформа]

## ОПИСАНИЕ
RPM - это мощный консольный менеджер пакетов, используемый для сборки, установки, инспекции, проверки, обновления и удаления отдельных программных пакетов. Каждый такой пакет состоит из набора файлов и информации о пакете, включающей название, версию, описание пакета, и т.д.

Может быть выбран один из следующих основных режимов: Инициализация базы данных, Перестроение базы данных, Сборка пакетов, Перекомпиляция пакетов, Сборка пакетов из tar-архивов, Запрос, Показ полей запроса, Установка, Обновление, Удаление, Проверка установки, Проверка подписи, Повторная подпись, Добавление подписи, Установка владельцев и групп и Показ конфигурации.

## ОБЩИЕ ОПЦИИ
Эти опции могут быть использованы во всех режимах работы.

-vv

Выводить много отладочной информации.

--quiet

Выводить как можно меньше сообщений - как правило, выводятся только сообщения об ошибках.

--help

Вывести более детальную, чем обычно, справку об использовании rpm.

--version

Вывести одну строку, содержащую номер версии используемого rpm.

--rcfile <список-файлов>

Каждый файл из разделенного двоеточиями <списка-файлов> последовательно читается rpm на предмет конфигурационной информации. По умолчанию <список-файлов> выглядит как /usr/lib/rpm/rpmrc:/etc/rpmrc:~/.rpmrc. В этом списке обязан существовать только первый файл; все тильды будут заменены значением переменной среды $HOME.

--root <каталог>

Использовать для всех операций файловую систему с корнем в <каталоге>. Обратите внимание, что это значит, что база данных также будет читаться и модифицироваться в <каталоге>, а все pre и post скрипты будут исполняться после chroot() в <каталог>.

--dbpath <каталог>

Использовать базу данных RPM, расположенную в <каталоге>.

--nowait-lock

Не ждать освобождения блокировки базы данных пакетов.

--ftpproxy <хост>

Использовать <хост> как FTP-прокси. См. ОПЦИИ FTP/HTTP.

--ftpport <порт>

Использовать <порт> как FTP порт прокси-сервера. См. ОПЦИИ FTP/HTTP.

--httpproxy <хост>

Использовать <хост> как HTTP-прокси. См. ОПЦИИ FTP/HTTP.

--httpport <порт>

Использовать <порт> как FTP или HTTP порт прокси-сервера. См. ОПЦИИ FTP/HTTP.

--pipe <cmd>

Перенаправить вывод rpm на вход команды <cmd>.

## ОПЦИИ УСТАНОВКИ И ОБНОВЛЕНИЯ
Общая форма команды установки пакетов выглядит так:

rpm {-i|--install} [опции-установки] файл_пакета ...

Такая команда устанавливает новые пакеты. Общая форма команды обновления пакетов выглядит так:

rpm {-U|--upgrade} [опции-установки] файл_пакета ...

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

rpm {-F|--freshen} [опции-установки] файл_пакета ...

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

Допускается задание <файл_пакета> в виде адресов ftp или http. В этом случае перед установкой файл будет получен с сервера, указанного в URL. См. ОПЦИИ FTP/HTTP на предмет информации о встроенной поддержке FTP/HTTP.

--allfiles

Устанавливать или обновлять все файлы, определенные как "missingok", даже если они уже существуют.

--badreloc

Для использования вместе с --relocate; производит перемещение, даже если пакет не является переместимым.

--excludepath

Не устанавливать файлы, чьи имена начинаются с <пути>.

--excludedocs

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

--force

То же, что и комбинация --replacepkgs, --replacefiles и --oldpackage.

-h, --hash

Выводить знаки "#" по мере распаковки архива с пакетом. Количество печатаемых знаков рассчитывается при запуске rpm исходя из характеристик выходного потока с тем, чтобы совместно с именем пакета выводимая информация про каждый пакет занимала ровно одну строку. Используется совместно с -v|--verbose для улучшения восприятия.

--ignoresize

Не проверять файловую систему на наличие достаточного свободного места перед установкой этого пакета.

--ignorearch

Произвести установку или обновление, даже если архитектуры бинарного RPM и машины не совпадают.

--ignoreos

Произвести установку или обновление, даже если операционные системы бинарного RPM и машины не совпадают.

--includedocs

Устанавливать файлы документации. Это поведение по умолчанию.

--justdb

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

--nodeps

Не проверять зависимости перед установкой или обновлением пакета.

--noorder

Не переупорядочивать список устанавливаемых пакетов. Обычно список переупорядочивается для удовлетворения зависимостей.

--noscripts

--nopre

--nopost

--nopreun

--nopostun

Не исполнять пре- и пост-установочных скриптов, с соответствующими именами. Опция --noscripts эквивалентна набору опций --nopre --nopost --nopreun --nopostun

и запрещает исполнение соответствующих %pre, %post, %preun и %postun скриптов.

--notriggers

--notriggerin

--notriggerun

--notriggerpostun

Не исполнять триггер-скриптов, с соответсвующими типами. Опция --notriggers эквивалентна набору опций --notriggerin --notriggerun --notriggerpostun

и запрещает исполнение соответствующих %triggerin, %triggerun и %triggerpostun скриптов.

--oldpackage

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

--percent

Выводить процент готовности по мере распаковки архива с пакетом. Задумано для облегчения использования rpm из других утилит.

--prefix <путь>

Для переместимых пакетов: установить префикс установки в <путь>.

--relocate <старый_путь>=<новый_путь>

Для переместимых пакетов: преобразовывает файлы, которые должны были бы быть установлены в <старый_путь>, в <новый_путь>.

--repackage

Перепаковывает файлы перед удалением. Прежде установленный пакет будет назван в соответствии с макросом %_repackage_name_fmt и создан в каталоге, имя которого определенно макросом %_repackage_dir (значение по-умолчанию /var/tmp).

--replacefiles

Устанавливать пакеты, даже если они перепишут файлы из других, уже установленных пакетов.

--replacepkgs

Устанавливать пакеты, даже если некоторые из них уже установлены в системе.

--nobuild

Не устанавливать пакет, просто проверить возможность установки и сообщить о возможных проблемах.

## ОПЦИИ ЗАПРОСА
Общая форма команды запроса (инспекции) выглядит так:

rpm -q [опции-запроса]

Можно задать формат, в котором будет выводиться информация о пакете. Для этого используется опция --queryformat с последующей строкой формата.

Форматы запроса представляют собой модифицированную версию стандартного форматирования printf(3). Формат состоит из статических строк (которые могут включать стандартные escape-последовательности C для переводов строки, табуляций и других специальных символов) и форматов по типу используемых в printf(3). Так как rpm уже знает типы данных, подлежащих выводу, спецификаторы типов должны быть опущены и заменены именами тэгов(ключей) заголовков, подлежащих выводу, заключенными в {}. Часть имени тэга RPMTAG_ может быть опущена.

Альтернативные форматы вывода могут быть заданы путем добавления к имени тэга :typetag. В настоящее время поддерживаются следующие типы: octal, date, shescape, perms, fflags и depflags.

Например, для вывода только названий запрашиваемых пакетов, можно использовать в качестве строки формата %{NAME}. Для вывода названий пакетов и информации о дистрибутиве в две колонки можно использовать %-30{NAME}%{DISTRIBUTION}.

Будучи запущенным с аргументом --querytags, rpm выведет список всех тэгов, которые можно использовать в строке формата.

Есть два набора опций для запроса - выбор пакетов и выбор информации.

Опции выбора пакетов:

<название_пакета>

Запросить установленный в системе пакет с именем <название_пакета>.

-a, --all

Запросить все установленные в системе пакеты.

--whatrequires <сервис>

Запросить все пакеты, требующие <сервис> для правильного функционирования.

--whatprovides <сервис>

Запросить все пакеты, предоставляющие <сервис>.

-f <файл>, --file <файл>

Запросить пакеты, которым принадлежит <файл>.

-g <группа>, --group <группа>

Запросить пакеты, входящие в<группу>.

-p <файл_пакета>

Запросить (не инсталлированый) <файл_пакета>. Файл <файл_пакета> может быть задан как адрес ftp или http; в этом случае заголовок пакета будет получен с указанного сервера. См. ОПЦИИ FTP/HTTP на предмет встроенной поддержки FTP/HTTP.

--specfile <spec-файл>

Разобрать и запросить <spec-файл> так, как если бы это был пакет. Хотя не вся информация (например, списки файлов) доступна, этот тип запроса позволяет использовать rpm для извлечения информации из spec-файлов без необходимости написания парсера spec-файлов.

--querybynumber <номер>

Запросить непосредственно запись базы данных под указанным <номером>. Может быть полезно для отладочных целей.

--triggeredby <пакет>

Запросить все пакеты, содержащие триггер-скрипты, активируемые <пакетом>.

Опции выбора информации:

-i

Вывести информацию о пакете, включая название, версию и описание. Использует --queryformat, если таковой задан.

-R, --requires

Вывести список пакетов, от которых зависит данный пакет.

--provides

Вывести список сервисов, предоставляемых данным пакетом.

--changelog

Вывести протокол изменений данного пакета.

-l, --list

Вывести список файлов, входящих в данный пакет.

-s, --state

Вывести состояние файлов в пакете (подразумевает -l). Каждый файл может находиться в одном из следующих состояний: нормальный, не установлен или заменен.

-d, --docfiles

Вывести список только файлов документации (подразумевает -l).

-c, --configfiles

Вывести список только конфигурационных файлов (подразумевает -l).

--scripts

Вывести специфические для данного пакета скрипты, используемые как часть процессов инсталляции/деинсталляции, если таковые есть.

--triggers, --triggerscripts

Показать все триггер-скрипты, если таковые имеются, содержащиеся в пакете.

--dump

Вывести информацию о файлах следующим образом: path size mtime md5sum mode owner group isconfig isdoc rdev symlink. Эта опция должна использоваться в сочетании с по меньшей мере одной из опций -l, -c, -d.

--last

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

--filesbypkg

Показать все файлы в каждом пакете.

--triggerscripts

Показать все триггер-скрипты для выбранных пакетов.

## ОПЦИИ ПРОВЕРКИ
Общая форма команды проверки выглядит так:

rpm -V|-y|--verify [опции-проверки]

В процессе проверки пакета информация об инсталлированных файлах пакета сравнивается с информацией из оригинального пакета из базы данных RPM. В числе прочих, проверяется размер, контрольная сумма MD5, права доступа, тип, владелец и группа каждого файла. Все несоответствия докладываются. Опции выбора пакетов такие же, как и для запроса (инспекции) пакетов.

Файлы, которые не устанавливались из пакета (например, файлы документации, которые были исключены из процесса инсталляции при помощи опции "--excludedocs"), молча игнорируются.

Опции, которые могут быть использованы в процессе проверки:

--nofiles

Игнорировать отсутствующие файлы.

--nomd5

Игнорировать ошибки проверки контрольной суммы MD5.

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

5

Контрольная сумма MD5

S

Размер файла

L

Символическая ссылка

T

Время модификации

D

Устройство

U

Владелец

G

Группа

M

Права доступа (включает права доступа и тип файла)

## ПРОВЕРКА ПОДПИСИ
Общая форма команды проверки подписи выглядит так:

rpm --checksig <файл-пакета>+

Эта команда проверяет PGP-подпись, встроенную в <файл-пакета>, для подтверждения целостности и источника происхождения пакета. Информация о конфигурации PGP читается из конфигурационных файлов. Более детально см. секцию ПОДПИСИ GPG/PGP.

## ОПЦИИ УДАЛЕНИЯ (ДЕИНСТАЛЛЯЦИИ)
Общая форма команды удаления (деинсталляции) выглядит так:

rpm -e <название_пакета>+

--allmatches

Удалить все версии пакета, отвечающие <названию_пакета>. Обычно, если <название_пакета> отвечает нескольким пакетам, выдается сообщение об ошибке и удаление не производится.

--noscripts

Не исполнять пре- и пост-установочные скрипты.

--notriggers

Не исполнять триггер-скриптов, активируемых при удалении данного пакета.

--nodeps

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

--test

Не производить удаления, только сделать вид. Полезна в сочетании с опцией -vv.

## ОПЦИИ СБОРКИ (ПОСТРОЕНИЯ) ПАКЕТОВ
Общая форма команды сборки rpm-пакета выглядит так:

rpm -[b|t]O [опции-сборки] <spec-файл>+

Аргумент -b применяется в том случае, когда для сборки пакета используется spec-файл. Если же rpm должен предварительно извлечь этот файл из архива, используется аргумент -t. Следующий за первым аргумент O определяет, какие этапы сборки и упаковки должны быть выполнены; он может принимать одно из нижеперечисленных значений:

-bp

Исполнить стадию "%prep" spec-файла. Как правило, это действие включает в себя распаковку исходников и применение к ним патчей.

-bl

Произвести "list check". В секции "%files" spec-файла производится расширение макросов и проверка перечисленных файлов на существование.

-bc

Исполнить стадию "%build" spec-файла (предварительно исполнив стадию %prep). Как правило, это действие сводится к исполнению некого эквивалента "make".

-bi

Исполнить стадию "%install" spec-файла (предварительно исполнив стадии %prep и %build). Как правило, это действие сводится к исполнению некого эквивалента "make install".

-bb

Собрать бинарный пакет (предварительно исполнив стадии %prep, %build и %install).

-bs

Собрать только исходный пакет (не исполняя более никаких стадий).

-ba

Собрать бинарный (RPM) и исходный (SRPM) пакеты (предварительно исполнив стадии %prep, %build и %install).

-bE

Обработать spec-файл; при этом расширяются макросы, и результат печатается в стандартный вывод.

Кроме того, в дополнении к вышеназванным, могут быть использованы следующие опции:

--short-circuit

Исполнить непосредственно указанную стадию, пропустив предшествующие.

--timecheck

Установить возраст для "timecheck" (0 - запретить). Это значение также может быть установлено путем определения макроса "_timecheck". Значение timecheck определяет максимальный возраст (в секундах) пакуемых в пакет файлов. Для всех файлов, которые старше этого возраста, будет выводиться предупреждение.

--clean

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

--rmsource

Удалить исходники и spec-файл после сборки (может быть использовано отдельно, например "rpm --rmsource foo.spec").

--test

Не исполнять никаких стадий сборки. Полезно для тестирования spec-файлов.

--sign

Встроить в пакет PGP-подпись. Эта подпись может быть использована для проверки целостности и источника происхождения пакета. См. секцию ПОДПИСИ GPG/PGP на предмет опций PGP.

--builroot <каталог>

Использовать каталог <каталог> как корневой для сборки пакетов, переопределив значение макроса %_buildroot и тэга BuildRoot.

--target <платформа>

При сборке пакета интерпретировать <платформу> как arch-vendor-os и соответствующим образом установить макросы _target, _target_arch и _target_os.

--buildarch <архитектура>

Собрать пакет для <архитектуры>, не обращая внимания на архитектуру системы, на которой производится сборка. Эта опция устарела, в RPM 3.0 вместо нее следует использовать опцию --target.

--buildos <операционная система>

Собрать пакет для <операционной системы>, не обращая внимания на архитектуру системы, на которой производится сборка. Эта опция устарела, в RPM 3.0 вместо нее следует использовать опцию --target.

## ОПЦИИ ПЕРЕСБОРКИ И ПЕРЕКОМПИЛЯЦИИ
Существуют еще два способа запуска процесса сборки:

rpm --recompile <файл_исходного_srpm_пакета>+

rpm --rebuild <файл_исходного_srpm_пакета>+

Будучи вызванным таким способом, rpm устанавливает указанный исходный srpm-пакет, после чего исполняет стадии %prep, %build и %install. Кроме того, --rebuild собирает новый бинарный пакет. После того, как сборка удачно закончена, удаляется дерево, использованное для сборки (как с опцией --clean), сами исходники и spec-файл (как с опцией --rmsource).

## ПОДПИСЬ СУЩЕСТВУЮЩЕГО ПАКЕТА
rpm --resign <файл_пакета>+

Эта опция генерирует и вставляет новые подписи в указанные пакеты. Все существующие подписи из пакетов при этом удаляются.

rpm --addsign <файл_пакета>+

Эта опция генерирует и добавляет новые подписи в указанные пакеты. Все существующие подписи пакетов при этом сохраняются.

## ПОДПИСИ GPG/PGP
Для того, чтобы использовать возможность подписи, rpm должен быть настроен для запуска GPG (или PGP) а также должен быть способен найти связку публичных ключей, содержащую ключ, используемый RPM. По умолчанию rpm для поиска связки ключей использует умолчания программы, используемой для работы с подписями. Если ваши связки ключей расположены не там, где их ожидает найти GPG (PGP), вы должны настроить соответствующий макрос

_gpg_path

на каталог, содержащий ваши связки GPG-ключей.

_pgp_path

на каталог, содержащий ваши связки PGP-ключей.

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

_signature

Тип подписи. В настоящее время поддерживается gpg и pgp.

_gpg_name

Имя "пользователя", чьи ключи вы хотите использовать для подписи ваших пакетов с помощью программы gpg.

_pgp_name

Имя "пользователя", чьи ключи вы хотите использовать для подписи ваших пакетов с помощью программы pgp.

При сборке пакетов вы добавляете к командной строке опцию --sign. У вас спросят пароль, и ваш пакет после успешной сборки будет подписан.

Например, для того чтобы использовать GPG для подписи пакетов от имени пользователя "John Doe <jdoe@foo.com>" из связки ключей, находящихся в /etc/rpm/.gpg, вы должны включить

%_signature

gpg

%_gpg_name

/etc/rpm/.gpg

%_gpg_name

John Doe <jdoe@foo.com>"

в файл конфигурации макросов. Используйте /etc/rpm/macros для общесистемной и ~/.rpmmacros для пользовательской конфигурации.

## ОПЦИИ ПЕРЕСТРОЕНИЯ БАЗЫ ДАННЫХ
Общая форма команды перестроения базы данных RPM выглядит так:

rpm --rebuilddb

Для построения новой базы данных:

rpm --initdb

Этот режим поддерживает только две опции, --dbpath и --root.

## ПОКАЗ КОНФИГУРАЦИИ
Запуск

rpm --showrc

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

## ОПЦИИ FTP/HTTP
rpm содержит простые клиенты FTP и HTTP для упрощения установки и изучения пакетов, доступных через интернет. Файлы пакетов для установки, обновления и запроса могут быть указаны как адреса ftp или http:

ftp://<логин>:<пароль>@<сервер>:<порт>/путь/к/файлу.rpm

Если <пароль> не указан, то он будет запрошен (по одному разу для каждой пары логин/сервер). Если ни <логин>, ни <пароль> не указаны, будет использован анонимный ftp. Во всех случаях используется пассивная (PASV) пересылка по FTP.

rpm позволяет использовать с ftp-адресацией следующие опции:

--ftpproxy <прокси-сервер>

<прокси-сервер> будет использован как прокси-сервер для всех пересылок, что позволяет производить FTP-соединения через firewall, использующий <прокси-сервер> для выхода во внешний мир. Эта опция может быть задана также настройкой макроса _ftpproxy.

--ftpport <порт>

Задает номер TCP-порта, используемого для FTP-соединений вместо порта по умолчанию. Эта опция может быть также задана настройкой макроса _ftpport.

rpm позволяет использовать с http-адресацией следующие опции:

--httpproxy <прокси-сервер>

<прокси-сервер> будет использована как прокси-сервер для всех пересылок, что позволяет производить HTTP-соединения через firewall, использующий <прокси-сервер> для выхода во внешний мир. Эта опция может быть задана также настройкой макроса _httpproxy.

--httpport <порт>

Задает номер TCP-порта, используемого для HTTP-соединений вместо порта по умолчанию. Эта опция может быть также задана настройкой макроса _httpport.

## ФАЙЛЫ

```
/usr/lib/rpm/<архитектура>-linux/rpmrc
/usr/lib/rpm/rpmrc
/etc/rpmrc
~/.rpmrc
```

## СМ. ТАКЖЕ
rpm2cpio(8), http://www.rpm.org/

## АВТОРЫ

```
Marc Ewing <marc@redhat.com>
Jeff Johnson <jbj@redhat.com>
Erik Troan <ewt@redhat.com>
Sergey Kubushin <ksi@ksi-linux.com> - перевод и адаптация

                                          для KSI Linux.
Dmitry V. Levin <ldv@fandra.org> - перевод и адаптация

                                    для Linux-Mandrake RE.
```


title: rpm2cpio(8)

summary: конвертирует пакет RPM в архив cpio

text:
# rpm2cpio(8)

## НАЗВАНИЕ
rpm2cpio - конвертирует пакет RPM в архив cpio

## ИСПОЛЬЗОВАНИЕ
rpm2cpio [filename]

## ОПИСАНИЕ
rpm2cpio конвертирует файл .rpm, заданный как его единственный аргумент, в архив cpio на стандартном выводе.

Пример:

rpm2cpio rpm-3.0.6-ipl21mdk.src.rpm

## СМ. ТАКЖЕ
rpm(8)

## АВТОР

```
Erik Troan <ewt@redhat.com>
```


rtmon

title: rtmon(8)

summary: прослушивает и мониторит RTnetlink

text:
# rtmon(8)

## ИМЯ
rtmon - прослушивает и мониторит RTnetlink

## СИНТАКСИС
rtmon [ опции ] file ФАЙЛ [ all | список_объектов ]

## ОПИСАНИЕ
Этот документ коротко описывает команду rtmon .

rtmon прослушивает сокет netlink и мониторит изменения таблицы маршрутизации.

rtmon может быть запущена перед выполнением первой команды настройки сети. Например, вы можете вставить:

rtmon file /var/log/rtmon.log

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

## ОПЦИИ
rtmon поддерживает следующие опции:

-Version

Вывести информацию о версии и выйти.

help

Вывести список доступных опций.

file ФАЙЛ [ all | список_объектов ]

Сохранять вывод в ФАЙЛЕ. Список_объектов - список типов объектов, которые должны наблюдаться. Это может быть комбинация 'link', 'address', 'route' и 'all'. 'link' обозначает сетевое устройство, 'address' - адрес протокола (IP или IPv6) устройства, 'route' - запись таблицы маршрутизации, а 'all' обозначает все типы.

-family [ inet | inet6 | link | help ]

Семейство протоколов. 'inet' - IPv4, 'inet6' - IPv6, 'link' обозначает что сетевой протокол не указан, а 'help' выводит информацию об использовании.

-4

Использовать IPv4. Аналогично -family inet.

-6

Использовать IPv6. Аналогично -family inet6.

-0

Сетевой протокол не указан. Аналогично -family link.

## ПРИМЕРЫ
\# rtmon file /var/log/rtmon.log

Сохранять изменения в файл /var/log/rtmon.log, затем запустите:

\# ip monitor file /var/log/rtmon.log

для показа сохраненной информации.

## СМ. ТАКЖЕ
ip(8)

## АВТОРЫ
rtmon написана Алексеем Кузнецовым <kuznet@ms2.inr.ac.ru>.

Страница руководства написана Майклом Прокопом (Michael Prokop) <mika@grml.org> для проекта Debian.

## ПЕРЕВОД
Андрей Черепанов <cas@altlinux.ru> 2007


sconfig

title: sconfig(8)

text:
# sconfig(8)

## ИМЯ
sconfig - утилита управления для адаптеров Кроникс (версия 6.0)

## ОБЗОР
sconfig [-raimsxeftucqv] [имя объекта [параметры...]]

Эта утилита предназначена для конфигурирования и управления адаптерами производства "КБ Кроникс". За более детальной информацией обращайтесь к файлам readme.txt.

## ОПИСАНИЕ
Комплект драйверов состоит из исходных текстов модулей ядра ОС Linux и утилиты управления sconfig. Всё взаимодействие пользователя (системного администратора) с комплектом драйверов производится с помощью утилиты sconfig. Дополнительно для удобства использования в наиболее распространённых конфигурациях предусмотрен единый конфигурационный файл /etc/cronyx.conf и обрабатывающий его sh-сценарий, который может быть установлен в /etc/rc.d или /etc/init.d подсистему.

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

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

Протокольные модули с сетевой поддержкой создают в системе стандартные сетевые интерфейсы, настройка и взаимодействие с которыми, происходит стандартным способом (с помошью ifconfig(8) и других системных утилит). В асинхронном режиме все параметры должны быть установлены при помощи системной утилиты stty(1), sconfig позволит вам управлять лишь некоторыми из них.

Некоторые установки могут быть сделаны только на свободных каналах, кода соответствующие сетевые интерфейсы отключены (находятся в состоянии down), терминальные устройства /dev/tty* или файловые дескрипторы devnode закрыты. Другие установки могут быть сделаны `на ходу'. Как правило, большинство параметров настраивается во время загрузки операционной системы. Например, посредством вызовов sconfig из файла /etc/rc.

ЗАМЕЧАНИЕ: Не все параметры могут быть использованы в конкретном случае, попытка установить некоторые из них может привести к разрыву связи по отдельному каналу или адаптеру в целом.

## ОПЦИИ
Вы можете указать только одну из перечисленных ниже опций. Если задана какая-нибудь опция, отвечающая за вывод информации, sconfig отобразит соответствующую информацию и проигнорирует остальные, за исключением <имени объекта>, т.е. имени канала, интерфейса или адаптера. Смотрите также описание параметра <имя объекта>.

Если <имени объекта> не задано, то соответствующее действие выполняется для всех существующих объектов.

<пусто>

Просмотр текущих установок для объекта.

-r

Отображение карты существующих объектов.

-a

Вывод полной информации о конфигурации объекта.

-i

вывод статистики сетевого интерфейса, аналогично команде ifconfig(1).

-m

Вывод информации о состоянии модемных сигналов. Описание всех модемных сигналов может быть найдено в любой документации по такому оборудованию. Только сигнал LE (происходит от признака `Link Enabled' в BSD-системах) должен быть описан отдельно. Если этот сигнал активен (On), значит канал используется. Если он выключен (Off), значит канал свободен.

-s

Вывод краткой статистики логического канала. Эта информация может быть полезна, если что-то не работает. Например, если непоступают прерывания от ISA-адаптера, то (возможно) выбранное IRQ не зарезервировано в BIOS за шиной ISA.

-x

Вывод подробной статистики логического канала. Эта опция позволяет просмотреть большее количество различных счетчиков, но в более сжатом формате чем по опции -s.

-e

Вывод краткой статистики интерфейса E1/G.703. Будет отображена информация собранная за последний неполный 15-минутный интервал. Описание формата смотрите ниже.

-f

Вывод полной статистики интерфейса E1/G.703. Будет отображена вся информация, выдаваемая по опции -e, и вся статистика за последние 24 часа (если доступно). Описание формата смотрите ниже.

-t

Вывод краткой статистики интерфейса E3/T3/STS-1. Будет отображена информация собранная за последний 15-минутный интервал. Описание формата смотрите ниже.

-u

Вывод полной статистики интерфейса E3/T3/STS-1. Будет отображена вся информация, выдаваемая по опции -t, и вся статистика за последние 24 часа (если доступно). Описание формата смотрите ниже.

-c

Очистка статистики.

-q

Не выводить никакой информации.

-v

Вывод информации о версии.

## ИМЯ ОБЪЕКТА
Важное историческое замечание:

До версии комплекта 6.0 использовалась старая "плоская" система именования, при которой имена назначались только каналам приёма-передачи данных. Такая схема была удобной и достаточной, пока каждый логический канал однозначно соответствовал аппаратному линейному интерфейсу. С появлением нового поколения адаптеров (Tau-PCI/2E1, Tau-PCI/4E1 и Tau-PCI/32) стала возникать путаница, так как логические каналы больше не соответствовали линейным интерфейсам, а при конфигурировании линейных интерфейсов возникала нелогичность и неоднозначность в их выборе.

Поэтому начиная с версии 6.0 была введена новая "иерархическая" система именования. Новая схема именует и различает объекты нескольких типов: `адаптер', `интерфейс', `канал'. При этом, каждый из объектов имеет свой набор конфигурационных параметров. Соответственно для задания полной конфигурации необходимо отдельно определить набор параметров для каждого из объектов. При этом необходимо произвести большее количество действий, но зато всегда есть полная ясность и однозначность.

Адаптерам присваиваются имена вида <тип-адаптера_#>, например: `tau32_0', `taupci_0', `tauisa_2' и т.д.

Линейным интерфейсам (E1, V.35, RS-530 и т.д.) присваиваются имена вида <имя-адаптера.тип-интерфейса_#>. Где `имя-адаптера' соответствует адаптеру, на котором расположен линейный интерфейс. А `тип-интерфейса_#' определяет тип и порядковый номер интерфейса на адаптере. Например: `tau32_0.e1_0', `taupci_0.e1_3', `tauisa_0.s_1' и т.д.

Тип линейного интерфейса именуется так:

`s'

синхронный последовательный интерфейс;

`e1'

интерфейс E1/ИКМ-30 (ITU-T G.703) c поддержкой структурированного режима ITU-T G.704;

`g703'

интерфейс ITU-T G.703 с поддержкой только неструктурированного режима;

`e3'

интерфейс E3;

`rs232'

синхронный последовательный RS-232;

`rs449'

синхронный последовательный RS-449;

`rs530'

синхронный последовательный RS-530;

`v35'

синхронный последовательный V.35;

`x21'

синхронный последовательный X.21;

`a'

асинхронный последовательный интерфейс RS-232;

`u'

универсальный синхронный/асинхронный интерфейс;

Логические каналы приёма/передачи данных получают имена вида <имя-адаптера.#>, где указывается имя адаптера, на котором расположен логический канал, и номер канала на адаптере. Например: `tau32_0.0', `tau32_0.31', `taupci_1.3' и т.д.

Кроме этого, для удобства логическим каналам присваиваются псевдонимы (aliases), которые совпадают с их именами в старой схеме именования. Это позволяет использовать более короткие имена (в том числе получаемых сетевых интерфейсов) и одновременно сохранить максимум совместимости с прикладным ПО рассчитанным на старую схему именования. Псевдонимы логических каналов имеют вид ce#, cp#, ct# и cx# для адаптеров Tau-PCI/32, Tau-PCI, Tau-ISA и Sigma-ISA соответственно.

Посмотреть актуальный список доступных объектов можно по команде sconfig -r. Псевдонимы логических каналов отображаются через `/' (слеш) после имени.

Для просмотра текущей конфигурации необходимо вызвать утилиту sconfig с именем интересующего объекта. При вызове без параметров sconfig отобразит основные параметры конфигурации для всех доступных объектов.

Для изменения конфигурации утилите sconfig кроме имени объекта необходимо указать имена изменяемых параметров конфигурации и их значения в форме <параметр=значение>.

Для адаптеров, интерфейсов и каналов доступны разные наборы параметров. В каждом конкретном случае множество доступных параметров зависит от модели адаптера, типа интерфейса, режима работы и выбранного протокола. Например, параметр `line=' (кодирование в линии) недоступен для асинхронных интерфейсов, а параметр `dpll=' (включение DPLL/ФАПЧ) недоступен для интерфейсов E1. Для просмотра всех параметров применимых к объекту вызовите sconfig c опцией -a и указанием имени объекта.

## КОНФИГУРИРОВАНИЕ АДАПТЕРОВ
adapter=..

Задаёт режим работы для адаптеров Tau-ISA и Tau-PCI с интерфейсами E1. Возможные значения:

separate

режим независимых каналов. Каждому линейному интерфейсу соответствует один логический канал;

mux

режим мультиплексирования канальных интервалов между линейными интерфейсами и логическими каналами;

split

распределение канальных интервалов интерфейса E1 между логическими каналами приёма-передачи;

b-mode

режим "B" адаптера Tau-ISA/E1;

led=..

Задаёт режим индикации светодиодом адаптера различных ситуаций и событий. Допустимы комбинации следующих опций, которые перечисляются без пробелов через запятую:

smart

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

on

индикатор постоянно горит;

off

индикатор погашен;

\#(number)

32-битное значение позволяет задать произвольный режим каденции;

irq

если указано, индикатор кратковременно вспыхивает (либо гаснет в комбинации с on) при каждом аппаратном прерывании со стороны адаптера;

rx

если указано, индикатор кратковременно вспыхивает (либо гаснет в комбинации с on) при приёме пакета (порции) данных;

tx

если указано, индикатор кратковременно вспыхивает (либо гаснет в комбинации с on) при передаче пакета (порции) данных;

err

если указано, индикатор кратковременно вспыхивает (либо гаснет в комбинации с on) при ошибках приёма-передачи;

subchan=..

задаёт множество канальных интервалов для режима "B" адаптера Tau-ISA/E1. Например: subchan=16,29-31.

reset

Сброс/перезапуск адаптера, по-возможности с полным сбросом аппаратной части.

## КОНФИГУРИРОВАНИЕ ЛОГИЧЕСКИХ КАНАЛОВ
debug=#

Задаёт уровень (0..2) выдачи отладочной информации, "0" - отладка выключена, "2" - максимум отладочной информации (для разработчиков);

extclock

Включает режим внешней синхронизации для последовательных синхронных интерфейсов (V.35, RS-530 и т.д.). Режим внешней синхронизации является основным при подключении к модемному оборудованию (устройству DCE). В этом режиме внешний сигнал синхронизации поступает на контакт разъёма TXCIN и используется как тактирующий синхросигнал для передачи данных (контакт разъёма TXD);

\#(number)

Для серийных синхронных интерфейсов (V.35, RS-530 и т.д.), задаёт скорость в битах в секунду и включает синхронизацию от внутреннего генератора адаптера. Нулевое значение будет эквивалентно указанию опции extclock. В случае ненулевого значения скорость обмена будет установлена равной заданному значению в бит/с. При этом, в качестве источника синхросигнала будет использоваться внутренний генератора адаптера. Передаваемые данные будут синхронизированы с сигналом внутреннего генератора адаптера, сгенерированный синхросигнал будет подаваться на контакт TXCOUT, а сигнал с контакта разъёма TXCIN будет игнорирован. Этот режим используется для непосредственного соединения адаптера с терминальным оборудованием (устройством DTE). Также режим внутренней синхронизации необходим для тестирования с использованием внешнего замыкателя;

mtu=#

Задаёт ограничение размера MTU (Maximum Transfer Unit);

qlen=#

Задаёт длину очередей приёма-передачи. Необходимо правильно задавать размер очередей, находя компромисс между вынужденной задержкой данных и вероятностью ситуаций underrun/overrun вследствие латентности системы при обработке аппаратных прерываний;

timeslots=.. или ts=..

Задаёт список канальных интервалов для интерфейсов E1/ИКМ-30. Например: "ts=1-7,15,27-29";

iface=#

Привязывает логический канал приёма-передачи к линейному интерфейсу по его порядковому номеру на адаптере (0, 1, 2, 3...);

mode=..

Задаёт режим работы логического канала. Возможные значения:

async

асинхронный режим (только для Sigma-ISA);

hdlc

синхронный режим, приём-передача пакетов в формате HDLC Layer 2;

phony

для адаптеров Tau-PCI/32 и Tau-PCI cинтерфейсами E1/ИКМ-30, непосредственный обмен данными ("телефонный" режим);

dlci=#

При использовании протокольного модуля Frame Relay добавляет PVC (Permanent Virtual Circuit) с указанным номером DLCI;

qlen-limit=#

При использовании zaptel-протокола задает предел для автоматического увеличения длины очередей приёма/передачи в результате обнаружения ситуаций переполнения/опустошения;

ec-delay=#

При использовании zaptel-протокола задает задержку в миллисекундах (с точностью до 0.125 мс) в подаче переданного в линию E1/ИКМ-30 сигнала на вход обратной связи эхоподавителя. Допускается указание ec-delay=auto, в результате будет установлено адекватное значение исходя из текущего значения параметра qlen. Например: "ec-delay=3.125" или "ec-delay=auto";

## КОНФИГУРИРОВАНИЕ ЛИНЕЙНЫХ ИНТЕРФЕЙСОВ
loop=..

включает/выключает шлейф (заворот данных). Возможные значения:

off

нормальный режим, все шлейфы выключены;

internal

внутренний шлейф - данные, передаваемые в линию, принимаются обратно;

mirror

внешний шлейф - данные, принимаемые из линии, передаются (отражаются) обратно в линию;

remote

выдача запроса на удалённую сторону на включение заворота данных, принимаемых с нашей стороны;

dpll=on/off

Включение ФАПЧ (DPLL) на последовательных синхронных интерфейсах для восстановления тактирующего синхросигнала по поступающим данным;

line=..

Выбор линейного кода. Возможные варианты зависят от вида линейного интерфейса:

nrz

код NRZ, для последовательных синхронных интерфейсов;

nrzi

код NRZI, для последовательных синхронных интерфейсов;

hdb3

код HDB3, для интерфейсов E1/ИКМ-30 и G.703;

ami

код AMI, для интерфейсов E1/ИКМ-30 и G.703;

invclk=..

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

normal/off

нормальный режим (по умолчанию);

rx-only

инверсия только синхроимпульсов приёма (RXC/ERC). Поддерживается только адаптерами серии Tau-PCI;

tx-only

инверсия только синхроимпульсов передачи (TXC/ETC). Поддерживается только адаптерами серии Tau-PCI;

both/on

инверсия синхроимпульсов как приёма, так и передачи;

higain=on/off

Для интерфейсов E1/ИКМ-30, включение режима повышенной чувствительности приёмника. Это позволяет увеличить дальность по линии E1 до 2.5 км (по витой паре сечением 0.6 мм2);

monitor=on/off

Для интерфейсов E1/ИКМ-30, включение режима мониторинга (подслушивания) линии через внешние высокоомные резисторы;

unframed=on/off

Для интерфейсов E1/ИКМ-30, включение неструктурированного (нефреймированного) режима E1/ИКМ-30 (без структуры канальных интервалов);

scrambler=on/off

Для интерфейсов E1/ИКМ-30, включение скремблера в неструктурированном режиме E1/ИКМ-30;

cas=..

Для интерфейсов E1/ИКМ-30, задаёт режим обработки CAS (Channel Associated Signaling). Возможные значения:

off

нет сигнализации CAS-типа, 16-ый канальный интервал доступен для передачи данных или сигнализации CCS-типа;

set

CAS контролируется по приёму, но замещается при передаче (нет необходимости подготавиливать CAS-данные для передачи);

pass

CAS контролируется по приёму и передается "как есть"из соответствующего логического канала;

cross

кросс-коммутация CAS средствами аппаратного кросс-коннектора параллельно с коммутацией канальных интервалов;

crc4=on/off

Для интерфейсов E1/ИКМ-30, включение сверхциклов (мультифрейминга) и проверки CRC4;

clock=..

Для интерфейсов E1/ИКМ-30, задаёт режим синхронизации передатчика, а при работе в режиме мультиплексора всего тракта приёма-передачи. Возможные значения:

internal

синхронизация от внутреннего генератора;

receive

синхронизация от приёмного тракта (по восстановленной из линии частоте);

rcv0

синхронизация от приёмного тракта физического интерфейса #0;

rcv1

синхронизация от приёмного тракта физического интерфейса #1;

rcv2

синхронизация от приёмного тракта физического интерфейса #2;

rcv3

синхронизация от приёмного тракта физического интерфейса #3;

## ВЫБОР ПРОТОКОЛА
idle

Нет протокола (отключение протокольного модуля);

async

Асинхронный протокол без сетевой поддержки, только для адаптеров серии Sigma-ISA. При выборе протокола в /dev/* автоматически создаются входы для доступа к каналу;

sync

Поддержка интерфейса синхронного tty без непосредственной сетевой поддержки. Позволяет использовать стандартные системные средства (pppd) для организации сетевого взаимодействия. При выборе протокола в /dev/* автоматически создаются входы для доступа к каналу;

cisco

Протокол Cisco HDLC, создаёт point-to-point сетевой интерфейс;

rbrg

протокол удалённого моста Ethernet. С противоположной стороны канала передачи данных должен работать аналогичный модуль, либо совместимое устройство (Ethernet-мосты серий Cronyx BRDG-ETV, BRDG-ETH, конверторы серий Cronyx PCM2L, PCM2D, E1-L, мультиплексоры Cronyx E1-XL). Совместно с корреспондентом образуется полноценный мост Ethernet и создаётся Ethernet-совместимый сетевой интерфейс;

fr

Поддержка проколола Frame Relay (ANSI T1.167 Annex D). Для получения сетевых point-to-point интерфейсов, с помощью параметра dlci=#, необходимо добавить PVC с требуемыми номерами DLCI;

raw

Поддержка непосредственного обмена данными для программ пользователя. Возможен обмен как HDLC-пакетами, так и "сырыми данными" в прозрачном (телефонном) режиме. При выборе протокола в /dev/cronyx/* автоматически создаются входы для доступа к каналу;

packet

Организует для программ пользователя режим приёма-передачи с агрегированием мелких порций данных в пакеты HDLC, что позволяет уменьшить накладные расходы. При выборе протокола в /dev/cronyx/* автоматически создаются входы для доступа к каналу;

zaptel

Обеспечивает Zaptel-совместимый интерфейс для открытой IP-АТС Asterisk. Для сборки и загрузки протокольного модуля необходимо наличие установленного Zaptel-стека;

Перед выбором протокола соответствующий протокольный модуль должен быть загружен. При подключении протокольного модуля к логическому каналу может быть автоматически произведена установка отдельных параметров. Так, например, почти все протокольные модули устанавливают режим работы канала (async/hdlc/phony).

После подключения какого-либо протокола к логическому каналу часть параметров может стать недоступной для изменения. Например, модуль czaptel.ko запрещает изменение списка канальных интервалов, многие протокольные модули не допускают изменение mtu и режима работы канала (async/hdlc/phony). Поэтому, при конфигурировании с помощью утилиты sconfig рекомендуется назначать канальный протокол последним параметром. После указания протокола необходимо указывать только DLCI-номера (параметр dlci=#) при использовании протокола Frame Relay.

## ФАЙЛЫ
/etc/cronyx.conf

/sbin/cronyx.start (символьная ссылка)

/sbin/cronyx.stop (символьная ссылка)

/sbin/cronyx.restart (символьная ссылка)

Для удобства работы предусмотрен файл конфигурации /etc/cronyx.conf и обрабатывающий его sh-сценарий.

После задания требуемой конфигурации можно загрузить драйверы и применить установки командой cronyx.start. Остановить каналы и выгрузить драйверы можно командой cronyx.stop.

В процессе установки sh-сценарий cronyx.sh (из комплекта драйверов) будет установлен как одна из команд инициализации системы. Также этот сценарий будет выполняться при вызове cronyx.start и cronyx.stop.

В зависимости от режима запуска cronyx.sh выполняет разбор параметров конфигурации, заданных в /etc/cronyx.conf и транслирует их в соответствующие вызовы утилит sconfig, ifconfig и т.д. Также cronyx.sh производит загрузку (или выгрузку) модулей ядра из комплекта драйверов.

Файл /etc/cronyx.conf и обрабатывающий его sh-сценарий cronyx.sh предназначены для наиболее распространённых, простейших конфигураций. В случае, если заложенных возможностей недостаточно необходимо использовать утилиту sconfig.

Конфигурация в файле /etc/cronyx.conf задаётся в виде пар <имя-объекта>=<значение>, в синтаксисе sh(1). Где <имя-объекта> должно соответствовать имени адаптера, линейного интерфейса на адаптере или канала. А <значение> задаёт конфигурацию в виде списка параметров в синтаксисе утилиты sconfig. В конфигурации каналов для некоторых протоколов необходимо также задать локальный и/или удалённый IP-адреса, либо локальный MAC-адрес. Номера DLCI для Frame Relay (параметр dlci=#) следует указывать после выбора протокола, а соответствующие локальный и удалённый IP-адреса после каждого DLCI.

ВНИМАНИЕ!!!

Так как имена интерфейсов и каналов могут содержать символ `.' (точка) и из-за ограничения синтаксиса языка sh(1), в файле /etc/cronyx.conf в соответствующих именах `.' (точка) должна быть заменена на `_' (подчерк).

Отредактируйте файл /etc/cronyx.conf под свои нужды, в комментариях даны примеры типовых конфигураций. Список возможных параметров и их значений приведены в описании утилиты sconfig (см. выше и файлы readme.txt).

## ПРИМЕРЫ
sconfig tau32_0 led=on clock=rcv1

Управляем адаптером Tau-PCI/32 #0, включаем светодиод и устанавливаем синхронизацию от приёмника E1-интерфеcа #1.

sconfig tau32_0.e1_1 unframed=off crc4=on cas=off

Управляем E1-интерфейсом #1 на адаптере Tau-PCI/32 #0, устанавливаем структурированный режим, сверхциклы CRC4 и отключаем CAS.

sconfig tau32_0.10 ts=4-8 iface=1 rbrg

Управляем каналом #10 на адаптере Tau-PCI/32 #0, назначаем канальные интервалы на E1-интерфейсе #1, подключаем протокольный модуль моста Ethernet.

sconfig cp1 ts=1-31 mode=phony qlen=2 zaptel

Управляем каналом #1 на адаптере Tau-PCI/xE1, выбираем множество канальных интервалов и подключаем zaptel-протокол, длину очереди передачи устанавливаем равной 2.

sconfig cx1 sync extclock

Настраиваем канал #1 на Sigma-ISA для соединения по протоколу PPP через DCE-устройство (HDSL или другой синхронный модем). Не забудьте запустить службу pppd и сконфигурировать сетевой интерфейс.

sconfig ct0 cisco ts=1-10

Настраиваем канал #0 на Tau-ISA/E1, протокол Cisco/HDLC, канальные интервалы 1-10. Не забудьте сконфигурировать сетевой интерфейс `ct0'.

sconfig ct0 cisco 256000

Настраиваем канал #0 на Tau-ISA для синхронного нуль-модемного соединения с DTE-устройством (другой компьютер или маршрутизатор), 256 кбит/с, протокол Cisco/HDLC. Не забудьте сконфигурировать сетевой интерфейс `ct0'.

sconfig cx1 sync 128000 line=nrzi dpll=on

Настраиваем канал #1 на Sigma-ISA для соединения по протоколу PPP через нуль-модемный кабель без проводника синхросигнала или через модем подобный Zelax M115 (без генерации синхросигнала передачи). Синхронный режим с ФАПЧ (DPLL), 128 кбит/c, кодирование в линии NRZI. Не забудьте сконфигурировать сетевой интерфейс `cx1'.

## ДИАГНОСТИКА
В этом разделе приведена расшифровка аббревиатур используемых утилитой sconfig при отображении различной статистической информации. Описание опций для получения статистики смотрите выше.

СТАТИСТИКА ЛОГИЧЕСКИХ КАНАЛОВ

Во время работы драйверы накапливают статистическую информацию о каждом логическом канале. Эта статистика пожжем быть получена с помощью утилиты sconfig или вызова ioctl(2)

Rintr

Количество прерываний (активаций IRQ) по приёму.

Tintr

Количество прерываний (активаций IRQ) по передаче.

Mintr

Количество прерываний (активаций IRQ) по статусу модема.

Ibytes

Количество принятых байтов.

Ipkts

Количество принятых пакетов/порций данных (недоступно для асинхронного режима).

Ierrs

Количество ошибок приёма.

Obytes

Количество переданных байтов.

Opkts

Количество переданных пакетов/порций данных (недоступно для асинхронного режима).

Oerrs

Количество ошибок передачи.

СТАТИСТИКА ИНТЕРФЕЙСОВ E1/G.703

Для интерфейсов E1/ИКМ-30 (с поддержкой структурированного режима) и для интерфейсов G.703 (без поддержки структурированного режима) собирается SNMP-совместимый набор данных (смотрите RFC1406).

Unav (uas)

Недоступные секунды (unavailable seconds) - количество секунд в течении которых принимался код AIS (все единицы) или было состояние LOS (los of signal).

Degr (dm)

Деградирующие минуты (degraded minutes) - количество минут в течении которых уровень ошибок был выше 10e-6, не считая `недоступных' (unavailable) и `существенно ошибочных' (severely errored) секунд.

Bpv (bpv)

Количество зафиксированных нарушений кодирования HDB3 (code violations), не доступно при выборе кода AMI.

Fsyn (fse)

Количество ошибок цикловой синхронизации (frame sync errors), только для структурированного режима.

CRC (crce)

Количество ошибок CRC4 по приёму (CRC4 errors), только для структурированного режима с включенным контролем CRC4.

RCRC (rcrce)

Количество ошибок CRC4 зафиксированных удалённой стороной и индицированных в E-бите кадров E1/ИКМ-30 (E-bit counter), только для структурированного режима с включенным контролем CRC4.

Err (es)

Ошибочные секунды (errored seconds) - количество секунд, в течение которых были зафиксированы ошибки цикловой синхронизации, потеря цикловой синхронизации, или проскальзывания (slip events). Только для структурированного режима.

Lerr (les)

Секунды с ошибками в линии (line errored seconds) - количество секунд, в течение которых фиксировалось нарушение кодирования HDB3.

Sev (ses)

Существенно ошибочные секунды (severely errored seconds) - количество секунд, в течение которых было зафиксировано более 832 ошибок цикловой синхронизации или более 2048 случаев нарушения кодирования HDB3.

Bur (bes)

Секунды с множественными ошибками (bursty errored seconds) - количество секунд, в течение которых было зафиксировано более 1 ошибки цикловой синхронизации, не считая существенно ошибочных секунд (severely errored). Только для структурированного режима.

Oof (oofs)

Секунды без цикловой синхронизации (out of frame sync seconds) - количество секунд, в течение которых наблюдалась потеря цикловой синхронизации. Только для структурированного режима.

Slp (css)

Секунды контролируемых проскальзываний (controlled slip seconds) - количество секунд, в течение которых фиксировались проскальзывания (повтор или удаление кадров E1 вследствие несовпадения частот выбранного локально источника синхронизации и передатчика на удалённой стороне).

СТАТУС ИНТЕРФЕЙСОВ E1/G.703

Утилита sconfig также отображает статус интерфейсов E1/G.703, который может иметь следующие значения (могут комбинироваться):

OK

Интерфейс в нормальном состоянии, есть сигнал и цикловая синхронизация.

LOS

Нет сигнала. Приёмник не распознаёт несущую HDB3, либо принимает последовательно более 2048 нулей в коде AMI. В соответствии с ITU-T G.775 и ITU-T G.962.

AIS

Принимается код AIS (все единицы). Только для структурированного режима, в соответствии с ITU-T O.162 раздел 1.6.1.2.

LOF

Потеряна цикловая синхронизация. Только для структурированного режима, в соответствии с ITU-T G.706 разделы 4.1.1, 4.1.2 и 4.3.2.

LOMF

Потеряна сверхцикловая синхронизация CAS. Только для структурированного режима с CAS, в соответствии с ITU-T G.732 раздел 5.2.

CRC4E

Потеряна сверхцикловая синхронизация CRC4 или очень много ошибок CRC4. Только для структурированного режима с CRC4, в соответствии с ITU-T G.706 раздел 4.2.

FARLOF

Принимается сигнал удалённой аварии. Удалённая сторона сообщает об аварии по приёму с нашей стороны (потеря сигнала или цикловой синхронизации). Только для структурированного режима, в соответствии ITU-T O.162 раздел 2.1.4.

AIS16

В 16-ом канальном интервале принимаются все единицы. Только для структурированного режима с CAS, в соответствии ITU-T G.732 раздел 4.2.

FARLOMF

Принимается сигнал удалённой аварии сверхцикловой синхронизации. Удалённая сторона сообщает об аварии по приёму с нашей стороны (потеря сверхцикловой синхронизации CAS). Только для структурированного режима с CAS, в соответствии с ITU-T O.162 раздел 2.1.5.

## ИСТОРИЯ
Эта утилита замещает устаревшие cxconfig и ctconfig, которые использовались в прошлом в комплекте драйверов Кроникс для FreeBSD. Эти две утилиты не совместимы с sconfig, поэтому использующие их сценарии должны быть переписаны. Кроме этого, версии для Linux и FreeBSD не полностью совместимы между собой.

Также, версия 6.0 сильно отличается от всех более ранних. Данное руководство может быть использовано только с версией 6.0, все предыдущие версии КБ Кроникс в настоящее время не поддерживает.

## ОШИБКИ
Всё программное обеспечение, разрабатываемое в "КБ Кроникс", проходит тщательное тестирование. Но так как оно создано людьми, последний `жучок' всегда может быть неожиданно обнаружен. Если Вы заметили какую-нибудь проблему, то попытайтесь определить условия её возникновения и отправьте на эту информацию нам по почте. Мы обязательно приложим усилия, чтобы воспроизвести ситуацию и устранить ошибку.

## СМОТРИТЕ ТАКЖЕ
stty(1), ioctl(2), pppd(8), ifconfig(8), route(8)

## АВТОР
Леонид Юрьев <ly@cronyx.ru>

## КОНТАКТЫ
E-mail: info@cronyx.ru

http://www.cronyx.ru

+7 (495) 946-99-90