pysnmpget - Интернет в облаке

ПРОГРАММА:

ИМЯ

pysnmpcmd - параметры и поведение, общие для большинства инструментов командной строки PySNMP

СИНТАКСИС

pysnmpcmd [ОПЦИИ] АГЕНТ [ПАРАМЕТРЫ]

ОПИСАНИЕ

На этой странице руководства описаны общие параметры команд PySNMP: пешая прогулка,
pysnmpget, pysnmpset, pysnmptranslate, прогулка. Приложения командной строки используют
Протокол SNMP для связи с сетевым объектом, поддерживающим протокол SNMP, агентом. Индивидуальный
приложения обычно (но не обязательно) принимают дополнительные параметры, которые задаются
после спецификации агента. Эти параметры задокументированы на страницах руководства для
каждое приложение.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-a протокол авторизации
Установите протокол аутентификации (MD5 или SHA), используемый для аутентифицированного SNMPv3
сообщений.

-A пароль аутентификации
Установите парольную фразу аутентификации, используемую для аутентифицированных сообщений SNMPv3.

-c сообщество
Установите строку сообщества для транзакций SNMPv1 / v2c.

-d Дамп (в шестнадцатеричном формате) необработанных отправленных и полученных пакетов SNMP.

-D ТОКЕН [, ...]
Включите вывод отладки для заданного TOKEN / ТОКЕН(s). Пытаться ВСЕ для очень многословного
вывод.

-e EngineID
Установите авторитетный (безопасный) идентификатор механизма, используемый для сообщений ЗАПРОС SNMPv3. это
обычно не требуется указывать это, так как обычно это обнаруживается
автоматически.

-E EngineID
Установите идентификатор механизма контекста, используемый для сообщений SNMPv3 REQUEST scopedPdu. Если не
указано, по умолчанию будет использоваться авторитетный идентификатор двигателя.

-час, --Помогите
Отобразите краткое сообщение об использовании и выйдите.

-H Отобразите список директив файла конфигурации, понятных команде, а затем
Выход.

-I [Х]
Задает параметры синтаксического анализа ввода. Видеть ВХОД ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ внизу.

-l секуровень
Установите уровень безопасности, используемый для сообщений SNMPv3 (noAuthNoPriv | authNoPriv | authPriv).
Соответствующие парольные фразы должны быть предоставлены при использовании любого уровня выше, чем
нетАутсноприв.

-m МИБЛИСТЫ
Задает список модулей MIB (не файлов), разделенных двоеточиями, для загрузки для этого
Приложение.

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

-M ДИРЕЛИСТ
Задает список каталогов, разделенных двоеточиями, для поиска MIB. Обратите внимание, что MIB
указанный с помощью опции -m будет загружен из одного из каталогов, перечисленных
параметр -M (или его эквиваленты).

-n имя_контекста
Установите contextName, используемый для сообщений SNMPv3. Контекстное имя по умолчанию - пустое
нить "".

-O [abeEfnqQsStTuUvxX]
Задает параметры выходной печати. Видеть ВЫВОД ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ внизу.

-r повторные попытки
Задает количество повторных попыток, которые будут использоваться в запросах. По умолчанию - 5.

-t Тайм-аут
Задает тайм-аут в секундах между повторными попытками. По умолчанию 1.

-u имя сек.
Установите securityName, используемый для аутентифицированных сообщений SNMPv3.

-v 1 | 2c | 3
Задает версию протокола для использования: 1 (RFC 1155-1157), 2c (RFC 1901-1908) или
3 (RFC 2571-2574). По умолчанию обычно используется версия 3.

-В, --версия
Отобразите информацию о версии приложения и выйдите.

-x PrivProtocol
Установите протокол конфиденциальности (DES или AES), используемый для зашифрованных сообщений SNMPv3.

-X PrivPassword
Установите парольную фразу конфиденциальности, используемую для зашифрованных сообщений SNMPv3.

-Z сапоги, время
Установите engineBoots и engineTime, используемые для аутентифицированных сообщений SNMPv3. Этот
инициализирует локальное понятие загрузки / времени агентов с аутентифицированным
значение, сохраненное на ЖК-дисплее. Обычно нет необходимости указывать эту опцию, так как
эти значения обычно обнаруживаются автоматически.

АГЕНТ ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ

Строка АГЕНТ в СИНТАКСИС выше указывает удаленный объект SNMP, с которым
общаться. Эта спецификация имеет вид:

[ :]

В самом простом случае АГЕНТ спецификация может состоять из имени хоста или IPv4-адреса в
стандартное обозначение "пунктирной четверки". В этом случае попытка связи будет предпринята с использованием
UDP / IPv4 на порт 161 данного хоста. В противном случае часть
спецификация анализируется в соответствии со следующей таблицей:

формат

имя хоста udp [: порт] or IPv4-адрес [: порт]

Обратите внимание, что строки нечувствительны к регистру, поэтому, например, "tcp"
и «TCP» эквивалентны. Вот несколько примеров и их интерпретация:

имя хоста: 161 выполнить запрос с использованием дейтаграмм UDP / IPv4 для хоста в порту 161.
": 161" здесь избыточно, поскольку это порт SNMP по умолчанию.
в любом слючае.

udp: имя хоста идентично предыдущей спецификации. "Udp:" является избыточным.
здесь, поскольку UDP / IPv4 - транспорт по умолчанию.

ВЫВОД ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Форматом вывода команд SNMP можно управлять с помощью различных параметров
-O флаг. Эффект от этих подвариантов можно увидеть в сравнении с
следующий вывод по умолчанию (если не указано иное):
$ snmpget -c общедоступный -v 1 локальный хост sysUpTime.0
SNMPv2-MIB :: sysUpTime.0 = Timeticks: (14096763) 1 день, 15: 09: 27.63

-Оа Отображать строковые значения как строки ASCII (если не определен DISPLAY-HINT для
соответствующий объект MIB). По умолчанию библиотека пытается определить
независимо от того, является ли значение печатаемой или двоичной строкой, и отображает его соответственно.

Эта опция не влияет на объекты, которые do есть подсказка на дисплее.

-Обь Отображать индексы таблиц в числовом виде, а не пытаться интерпретировать экземпляр
субидентификаторы в виде строк или значений OID:
$ snmpgetnext -c public -v 1 локальный хост vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. "Wes" = xxx
$ snmpgetnext -c общедоступный -v 1 -Обь локальный хост VacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0.3.119.101.115 = xxx

-Ое Удаляет символические метки из значений перечисления:
$ snmpget -c общедоступный -v 1 локальный хост ipForwarding.0
IP-MIB :: ipForwarding.0 = ЦЕЛОЕ: пересылка(1)
$ snmpget -c общедоступный -v 1 -Ое локальный хост ipForwarding.0
IP-MIB :: ipForwarding.0 = ЦЕЛОЕ: 1

-ОЕ Изменяет строки индекса, чтобы избежать символов кавычек:
$ snmpgetnext -c public -v 1 локальный хост vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. "Wes" = xxx
$ snmpgetnext -c общедоступный -v 1 -ОЕ локальный хост VacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. \ "Wes \" = xxx

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

-Из Включите полный список объектов MIB при отображении OID:
.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0 =
Время: (14096763) 1 день, 15: 09: 27.63

-На Отображает OID в числовом виде:
.1.3.6.1.2.1.1.3.0 = метки времени: (14096763) 1 день, 15: 09: 27.63

-ОК Удаляет знак равенства и информацию о типе при отображении значений varbind:
SNMPv2-MIB::sysUpTime.0 1:15:09:27.63

-ОК Удаляет информацию о типе при отображении значений varbind:
SNMPv2-MIB::sysUpTime.0 = 1:15:09:27.63

-Операционные системы Отобразите имя объекта MIB (плюс любой экземпляр или другие субидентификаторы):
sysUpTime.0 = Timeticks: (14096763) 1 день, 15: 09: 27.63

-ОПЕРАЦИОННЫЕ СИСТЕМЫ Отобразите имя MIB, а также имя объекта:
SNMPv2-MIB :: sysUpTime.0 = Timeticks: (14096763) 1 день, 15: 09: 27.63

Это выходной формат OID по умолчанию.

-От Отображать значения TimeTicks как необработанные числа:
SNMPv2-MIB :: sysUpTime.0 = 14096763

-ОТ Если значения печатаются в виде шестнадцатеричных строк, также отобразите версию для печати.

-ОУ Отображение OID в традиционном стиле UCD (унаследованном от исходного CMU
код). Это означает удаление серии "стандартных" префиксов из OID и
отображение оставшегося списка имен объектов MIB (плюс любые другие подидентификаторы):
system.sysUpTime.0 = Timeticks: (14096763) 1 день, 15: 09: 27.63

-ОУ Не печатайте суффикс UNITS в конце значения.

-Ов Отображать только значение varbind, но не OID:
$ snmpget -c общедоступный -v 1 -Ое локальный хост ipForwarding.0
ЦЕЛОЕ ЧИСЛО: пересылка(1)

-Бык Отображать строковые значения в виде шестнадцатеричных строк (если не определен DISPLAY-HINT для
соответствующий объект MIB). По умолчанию библиотека пытается определить
независимо от того, является ли значение печатаемой или двоичной строкой, и отображает его соответственно.

Эта опция не влияет на объекты, которые do есть подсказка на дисплее.

-OX Отображение индексов таблиц в более "программном" выводе, имитирующем традиционный
формат индекса в стиле массива:
$ snmpgetnext -c общедоступный -v 1 локальный хост ipv6RouteTable
IPv6-MIB :: ipv6RouteIfIndex.63.254.1.0.255.0.0.0.0.0.0.0.0.0.0.0.64.1 = ЦЕЛОЕ: 2
$ snmpgetnext -c общедоступный -v 1 -ОЕ локальный хост ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

Большинство этих параметров также можно настроить с помощью токенов конфигурации. Увидеть
snmp.conf(5) страницу руководства для подробностей.

ВХОД ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Можно управлять интерпретацией имен входных объектов и присваиваемых значений.
используя различные параметры -I флаг. Поведение по умолчанию будет описано в
конец этого раздела.

-Иб указывает, что данное имя следует рассматривать как регулярное выражение, чтобы соответствовать
(без учета регистра) для имен объектов в дереве MIB. "Лучший" матч будет
быть использовано - рассчитывается как тот, который соответствует ближайшему к началу
имя узла и самый высокий в дереве. Например, объект MIB
vacmSecurityModel может соответствовать выражению vacmsecuritymodel (полное имя,
но другой случай), или модель vacm. * (шаблон регулярного выражения).

Обратите внимание, что '.' - специальный символ в шаблонах регулярных выражений, поэтому
выражение не может указывать субидентификаторы экземпляра или более одного имени объекта. А
Выражение «наилучшее совпадение» будет применяться только к отдельным именам объектов MIB. Для
Например, выражение sys * ontact.0 не соответствует экземпляру sysContact.0
(несмотря на то что sys * ontact будет соответствовать sysContact). Аналогично, указав модуль MIB
имя не удастся (так что SNMPv2-MIB :: sys. * Ontact тоже не совпадет).

-Эх отключает использование информации DISPLAY-HINT при присвоении значений. Это бы
затем требуется предоставить необработанное значение:
snmpset ... HOST-RESOURCES-MIB :: hrSystemData.0
x "07 D2 0C 0A 02 04 06 08"
вместо отформатированной версии:
snmpset ... HOST-RESOURCES-MIB :: hrSystemDate.0
= 2002-12-10,2:4:6.8

-Ир отключает проверку индексов таблиц и значения, которое будет присвоено соответствующему
Определения MIB. Это (будем надеяться) приведет к тому, что удаленный агент сообщит о
недействительный запрос, вместо того, чтобы проверять (и отклонять) его перед отправкой в
удаленный агент.

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

-ИК разрешает "произвольный доступ" поиск имен MIB. Вместо предоставления полного пути OID
к желаемому объекту MIB (или квалифицируя этот объект с помощью явного модуля MIB
name), в дереве MIB будет выполняться поиск соответствующего имени объекта. Таким образом
.iso.org.dod.internet.mib-2.system.sysDescr.0 (или SNMPv2-MIB :: sysDescr.0) может быть
указывается просто как sysDescr.0.

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

The MIB-МОДУЛЬ :: имя_объекта синтаксис имеет то преимущество, что однозначно идентифицирует
конкретный объект MIB, а также немного более эффективен (и автоматически
загрузка необходимого MIB-файла при необходимости).

-Является СУФФИКС
добавляет указанный суффикс к каждому текстовому OID, указанному в командной строке. Это может
использоваться для извлечения нескольких объектов из одной и той же строки таблицы, указав
значение общего индекса.

-ЯВЛЯЕТСЯ ПРЕФИКС
добавляет указанный префикс к каждому текстовому OID, указанному в командной строке. Это может
использоваться для указания явного имени модуля MIB для всех извлекаемых объектов (или
для неизлечимо ленивых машинисток).

-Ю позволяет использовать традиционный подход в стиле UCD к интерпретации входных OID. Этот
предполагает, что идентификаторы OID имеют корень в точке 'mib-2' в дереве (если они не начинаются
с явным "." или укажите имя модуля MIB). Итак, приведенный выше экземпляр sysDescr
будет называться system.sysDescr.0.

Имена объектов указываются в начале "." всегда интерпретируются как "полностью квалифицированные"
OID, перечисляющие последовательность объектов MIB из корня дерева MIB. Такие объекты и
те, которые определены явным именем модуля MIB, не подвержены влиянию -Иб, -ИК и -Ю
флаги.

В противном случае, если ни один из вышеперечисленных параметров ввода не указан, поведение по умолчанию для
"относительный" OID - это попытаться интерпретировать его как (неявно) полностью квалифицированный OID, затем
применить поиск «произвольный доступ» (-ИК), за которым следует сопоставление с образцом "наилучшее совпадение" (-Иб).

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

PREFIX Стандартный префикс для идентификаторов объектов (при использовании вывода в стиле UCD). По умолчанию
на .iso.org.dod.internet.mgmt.mib-2

MIBS Список MIB для загрузки. По умолчанию SNMPv2-TC: SNMPv2-MIB: IF-MIB: IP-MIB: TCP-
MIB: UDP-MIB: SNMP-VACM-MIB. Переопределено -m опцию.

МИБДИРС
Список каталогов для поиска MIB. По умолчанию DATADIR / snmp / mibs.
Переопределено -M опцию.

Используйте pysnmpget в Интернете с помощью сервисов onworks.net