pysnmpbulkwalk - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

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

ОПИС

На цій сторінці посібника описано загальні параметри для команд PySNMP: pysnmpbulkwalk,
pysnmpget, pysnmpset, pysnmptranslate, pysnmpwalk. Програми командного рядка використовують
Протокол SNMP для зв'язку з мережевим об'єктом, що підтримує SNMP, агентом. Індивідуальний
програми зазвичай (але не обов'язково) приймають додаткові параметри, які надаються
після специфікації агента. Ці параметри задокументовані на сторінках посібника для
кожен додаток.

ВАРІАНТИ

-a authProtocol
Встановіть протокол аутентифікації (MD5 або SHA), який використовується для аутентифікованого SNMPv3
повідомлення

-A authPassword
Встановіть парольну фразу аутентифікації, яка використовується для аутентифікованих повідомлень SNMPv3.

-c співтовариство
Встановіть рядок спільноти для транзакцій SNMPv1/v2c.

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

-D ТОКЕН[,...]
Увімкніть вихід налагодження для даного ТОКЕН(s). Спробуйте всі за надзвичайно багатослівний
вихід.

-e ідентифікатор двигуна
Встановіть авторитетний ідентифікатор механізму (безпеки), який використовується для повідомлень SNMPv3 REQUEST. це є
зазвичай не потрібно вказувати це, оскільки зазвичай це буде виявлено
автоматично.

-E ідентифікатор двигуна
Встановіть контекстний ідентифікатор двигуна, який використовується для повідомлень SNMPv3 REQUEST scopedPdu. Якщо ні
зазначено, за замовчуванням буде використовуватися авторитетний engineID.

-h, --допомога
Відобразіть коротке повідомлення про використання, а потім вийдіть.

-H Відобразити список директив файлу конфігурації, зрозумілих команді, а потім
ВХІД.

-I [ху]
Визначає параметри аналізу введення. Побачити ВХІД ВАРІАНТИ нижче.

-l secLevel
Встановіть рівень безпеки, який використовується для повідомлень SNMPv3 (noAuthNoPriv|authNoPriv|authPriv).
Під час використання будь-якого рівня вище ніж
noAuthNoPriv.

-m МІБЛІСТ
Визначає розділений двокрапкою список модулів MIB (не файлів), які потрібно завантажити для цього
Додаток.

Спеціальне ключове слово ALL використовується для завантаження всіх модулів MIB у пошуку каталогу MIB
список. Кожен файл, ім'я якого не починається з "." буде розібрано так, ніби це a
MIB файл.

-M DIRLIST
Вказує список каталогів, розділених двокрапкою, для пошуку MIB. Зверніть увагу, що MIB
зазначений за допомогою параметра -m буде завантажено з одного з каталогів, зазначених у
параметр -M (або еквівалент).

-n contextName
Встановіть контекстну назву, яка використовується для повідомлень SNMPv3. За замовчуванням контекстне ім'я є порожнім
рядок "".

-O [abeEfnqQsStTuUvxX]
Визначає параметри вихідного друку. Побачити ВИХІД ВАРІАНТИ нижче.

-r повторити спроби
Вказує кількість повторних спроб, які будуть використані в запитах. За замовчуванням – 5.

-t Тайм-аут
Визначає час очікування в секундах між повторними спробами. За замовчуванням 1.

-u secName
Встановіть securityName, що використовується для автентифікованих повідомлень SNMPv3.

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

-V, -- версія
Відобразіть інформацію про версію програми, а потім вийдіть.

-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 public -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 -Об localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.3.119.101.115 = xxx

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

-OE Змінює рядки індексу, щоб уникнути символів лапок:
$ snmpgetnext -c public -v 1 локальний хост vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c публічний -v 1 -OE localhost 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

-OQ Видаляє інформацію про тип під час відображення значень 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

-OT Якщо значення друкуються як шістнадцяткові рядки, також відобразіть версію для друку.

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

-OU Не друкуйте суфікс UNITS в кінці значення.

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

-Віл Відображати значення рядка як шістнадцяткові рядки (якщо не визначено DISPLAY-HINT для
відповідний об'єкт MIB). За замовчуванням бібліотека намагається визначити
чи є значення друкованим чи двійковим рядком, і відображає його відповідно.

Цей параметр не впливає на об’єкти, які do мати підказку для відображення.

-ОХ Відображати індекси таблиць у більш «програмному» виводі, імітуючи традиційний
Формат індексу в стилі масиву:
$ snmpgetnext -c public -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 -OE локальний хост ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

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

ВХІД ВАРІАНТИ

Можна керувати інтерпретацією імен вхідних об’єктів та значень, які потрібно призначити
використовуючи різні параметри -I прапор. Поведінка за замовчуванням буде описана на сторінці
кінець цього розділу.

-Ib вказує, що дане ім'я слід розглядати як регулярний вираз, щоб відповідати
(нечутливо до регістру) проти імен об'єктів у дереві MIB. «Кращий» матч буде
be used - обчислюється як той, який найбільше відповідає початку
ім'я вузла та найвищий у дереві. Наприклад, об'єкт MIB
vacmSecurityModel може відповідати виразу vacmsecuritymodel (повна назва,
але інший регістр), або vacm.*model (шаблон регулярних виразів).

Зверніть увагу, що '.' є спеціальним символом у шаблонах регулярних виразів, тому
вираз не може вказувати субідентифікатори екземпляра або більше одного імені об’єкта. А
Вираз "найкраща відповідність" буде застосовано лише до окремих імен об'єктів MIB. Для
наприклад, вираз sys*onact.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. Це (сподіваємося) призведе до того, що віддалений агент повідомить про an
недійсний запит, а не перевіряє (і відхиляє) його перед його відправкою
віддалений агент.

Місцеві перевірки є більш ефективними (та й надана діагностика, як правило, більш ефективна
точний), але вимкнення цієї поведінки особливо корисно під час тестування
віддалений агент.

-ІЧ дозволяє шукати "довільний доступ" імен MIB. Замість надання повного шляху OID
на потрібний об’єкт MIB (або кваліфікуючи цей об’єкт за допомогою явного модуля MIB
name), у дереві MIB буде здійснюватися пошук відповідного імені об’єкта. Таким чином
.iso.org.dod.internet.mib-2.system.sysDescr.0 (або SNMPv2-MIB::sysDescr.0) можна
вказано просто як sysDescr.0.

Увага!
Оскільки імена об’єктів MIB не є глобально унікальними, цей підхід може повертати a
різні об’єкти MIB залежно від того, які файли MIB було завантажено.

Команда MIB-MODULE::objectName Синтаксис має перевагу унікальної ідентифікації a
конкретний об’єкт MIB, а також трохи більш ефективний (і автоматично
завантаження необхідного MIB-файлу, якщо необхідно).

-Є СУФІКС
додає вказаний суфікс до кожного текстового OID, заданого в командному рядку. Це може
використовуватися для отримання кількох об’єктів з одного рядка таблиці, вказавши a
загальне значення індексу.

-Є ПРЕФІКС
додає вказаний префікс до кожного текстового OID, заданого в командному рядку. Це може
використовуватися для вказівки явного імені модуля MIB для всіх об’єктів, що витягуються (або
для невиліковно ледачих друкарок).

-Ю забезпечує традиційний підхід у стилі UCD до інтерпретації вхідних OID. Це
передбачає, що OID вкорінені в точці 'mib-2' в дереві (якщо вони не запускаються
з явним '.' або включити назву модуля MIB). Отже, екземпляр sysDescr вище
буде посилатися як system.sysDescr.0.

Назви об'єктів, зазначені з провідним '.' завжди інтерпретуються як "повністю кваліфіковані"
OID, перераховуючи послідовність об’єктів MIB з кореня дерева MIB. Такі об'єкти і
ті, які кваліфікуються явним ім'ям модуля MIB, не впливають -Ib, -ІЧ та -Ю
прапори.

В іншому випадку, якщо жоден з наведених вище параметрів введення не вказано, поведінка за замовчуванням для a
"відносний" OID - це спробувати інтерпретувати його як (неявно) повністю кваліфікований OID, тоді
застосувати пошук із довільним доступом (-ІЧ), а потім відповідність шаблону "найкраща відповідність" (-Ib).

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

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 варіант.

MIBDIRS
Список каталогів для пошуку MIB. За замовчуванням DATADIR/snmp/mibs.
Перевизначено -M варіант.

Використовуйте pysnmpbulkwalk онлайн за допомогою сервісів onworks.net