pysnmpbulkwalk - クラウドでオンライン

プログラム：

NAME

pysnmpcmd - ほとんどの PySNMP コマンドライン ツールに共通のオプションと動作

SYNOPSIS

pysnmpcmd [オプション] エージェント [パラメータ]

DESCRIPTION

このマニュアル ページでは、PySNMP コマンドの一般的なオプションについて説明します。 pysnmpバルクウォーク,
pysnmpget, pysnmpset, pysnmp翻訳, pysnmpwalk. コマンド ライン アプリケーションは、
SNMP 対応のネットワーク エンティティであるエージェントと通信するための SNMP プロトコル。 個人
通常、アプリケーションは (必須ではありませんが) 指定された追加のパラメーターを受け取ります。
エージェント指定後。 これらのパラメーターは、のマニュアル ページに記載されています。
それぞれのアプリケーション。

OPTIONS

-a 認証プロトコル
認証済み SNMPv5 に使用する認証プロトコル (MD3 または SHA) を設定します
メッセージ。

-A 認証パスワード
認証された SNMPv3 メッセージに使用される認証パス フレーズを設定します。

-c コミュニティ
SNMPv1/v2c トランザクションのコミュニティ ストリングを設定します。

-d 送受信された生の SNMP パケットを (XNUMX 進数で) ダンプします。

-D トークン[、...]
指定されたデバッグ出力をオンにします トークン（NS）。 試す を 非常に冗長な場合
出力。

-e エンジンID
SNMPv3 REQUEST メッセージに使用される権限のある (セキュリティ) engineID を設定します。 それは
通常は検出されるため、これを指定する必要はありません。
自動的に。

-E エンジンID
SNMPv3 REQUEST メッセージ scopedPdu に使用されるコンテキスト engineID を設定します。 そうでない場合
指定すると、これはデフォルトで権限のある engineID になります。

-NS、 - 助けて
簡単な使用法メッセージを表示して終了します。

-H コマンドが理解できる設定ファイル ディレクティブのリストを表示してから、
出口。

-I [ふ]
入力解析オプションを指定します。 見る 入力 OPTIONS を参照してください。

-l 秒レベル
SNMPv3 メッセージに使用される securityLevel を設定します (noAuthNoPriv|authNoPriv|authPriv)。
より高いレベルを使用する場合は、適切なパス フレーズを指定する必要があります。
noAuthNoPriv。

-m ミブリスト
このためにロードする MIB モジュール (ファイルではない) のコロンで区切られたリストを指定します。
アプリケーション。

特別なキーワード 全て MIBディレクトリ検索ですべてのMIBモジュールをロードするために使用されます
リスト。 名前が「.」で始まらないすべてのファイルであるかのように解析されます
MIB ファイル。

-M ディレクトリリスト
MIB を検索するディレクトリのリストをコロンで区切って指定します。 MIB に注意してください。
-m オプションを使用して指定されたファイルは、リストされたディレクトリの XNUMX つからロードされます。
-M オプション (または同等のもの)。

-n コンテキスト名
SNMPv3 メッセージに使用される contextName を設定します。 デフォルトの contextName は空です
ストリング ""。

-O [abeEfnqQsStTuUvxX]
出力印刷オプションを指定します。 見る 出力 OPTIONS を参照してください。

-r 再試行
要求で使用される再試行回数を指定します。 デフォルトは 5 です。

-t タイムアウト
再試行間のタイムアウトを秒単位で指定します。 デフォルトは 1 です。

-u 秒名
認証された SNMPv3 メッセージに使用される securityName を設定します。

-v 1 | 2c | 3
使用するプロトコル バージョンを指定します: 1 (RFC 1155-1157)、2c (RFC 1901-1908)、または
3 (RFC 2571-2574)。 通常、デフォルトはバージョン 3 です。

-V、 - バージョン
アプリケーションのバージョン情報を表示して終了します。

-x privプロトコル
暗号化された SNMPv3 メッセージに使用されるプライバシー プロトコル (DES または AES) を設定します。

-X 特権パスワード
暗号化された SNMPv3 メッセージに使用されるプライバシー パス フレーズを設定します。

-Z ブーツ、時間
認証された SNMPv3 メッセージに使用される engineBoots と engineTime を設定します。 この
エージェントのブート/時間のローカル概念を認証済みで初期化します
LCDに保存された値。 通常、このオプションを指定する必要はありません。
これらの値は通常、自動的に検出されます。

エージェント 仕様

文字列 エージェント セクションに SYNOPSIS 上記は、リモート SNMP エンティティを指定します。
伝える。 この仕様は次の形式を取ります。

[ :]

最も単純には、 エージェント 仕様は、ホスト名または IPv4 アドレスで構成されます。
標準の「点線クワッド」表記。 この場合、
特定のホストのポート 4 への UDP/IPv161。 そうでなければ、 の一部
仕様は、次の表に従って解析されます。

形式でアーカイブしたプロジェクトを保存します．

udp ホスト名[:ポート] or IPv4アドレス[:ポート]

ご了承ください文字列は大文字と小文字を区別しないため、たとえば「tcp」
と「TCP」は同等です。 以下にいくつかの例とその解釈を示します。

ホスト名:161 UDP/IPv4 データグラムを使用してクエリを実行し、 hostname ポート上 161.
「:161」はデフォルトの SNMP ポートであるため、ここでは冗長です。
とにかく。

udp:ホスト名 以前の仕様と同じです。 「udp:」は冗長です
ここでは、UDP/IPv4 がデフォルトのトランスポートであるためです。

出力 OPTIONS

SNMP コマンドからの出力の形式は、さまざまなパラメーターを使用して制御できます。
　 -O 国旗。 これらのサブオプションの効果は、
次のデフォルト出力 (特に指定がない限り):
$ snmpget -c public -v 1 localhost sysUpTime.0
SNMPv2-MIB::sysUpTime.0 = Timeticks: (14096763) 1 日、15:09:27.63

-おあ 文字列値を ASCII 文字列として表示します (DISPLAY-HINT が定義されていない場合)。
対応する MIB オブジェクト)。 デフォルトでは、ライブラリは特定しようとします。
値が印刷可能文字列かバイナリ文字列かを判断し、それに応じて表示します。

このオプションは、オブジェクトには影響しません。 do 表示ヒントがあります。

-オブ インスタンスを解釈しようとするのではなく、テーブル インデックスを数値で表示する
文字列または OID 値としてのサブ識別子:
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -オブ localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.3.119.101.115 = xxx

-大江 列挙値から記号ラベルを削除します。
$ snmpget -c public -v 1 localhost ipForwarding.0
IP-MIB::ipForwarding.0 = 整数: 転送(1)
$ snmpget -c public -v 1 -大江 ローカルホスト ipForwarding.0
IP-MIB::ipForwarding.0 = 整数: 1

-OE 引用符文字をエスケープするようにインデックス文字列を変更します。
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -OE localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.\"wes\" = xxx

これにより、出力をシェル コマンドで再利用できます。

-の OID を表示するときに、MIB オブジェクトの完全なリストを含めます。
.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

-Oq 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 値が XNUMX 進文字列として出力される場合は、出力可能なバージョンも表示します。

-おう 従来の UCD スタイル (元の CMU から継承) で OID を表示します。
コード）。 これは、OID から一連の「標準」プレフィックスを削除することを意味します。
MIB オブジェクト名 (およびその他のサブ識別子) の残りのリストを表示します。
system.sysUpTime.0 = Timeticks: (14096763) 1 日、15:09:27.63

-OU 値の末尾に UNITS サフィックスを出力しないでください。

-Ov OID ではなく、varbind 値のみを表示します。
$ snmpget -c public -v 1 -大江 ローカルホスト ipForwarding.0
整数： 転送(1)

-牛 文字列値を XNUMX 進文字列として表示します (DISPLAY-HINT が定義されている場合を除く)。
対応する MIB オブジェクト)。 デフォルトでは、ライブラリは特定しようとします。
値が印刷可能文字列かバイナリ文字列かを判断し、それに応じて表示します。

このオプションは、オブジェクトには影響しません。 do 表示ヒントがあります。

-牛 従来の方法を模倣して、より「プログラムに似た」出力でテーブル インデックスを表示します。
配列スタイルのインデックス形式:
$ snmpgetnext -c public -v 1 localhost 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 public -v 1 -OE ローカルホスト ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

これらのオプションのほとんどは、構成トークンを介して構成することもできます。 を参照してください
snmp.conf(5) 詳細についてはマニュアルページを参照してください。

入力 OPTIONS

入力オブジェクト名の解釈と割り当てられる値を制御できます
のさまざまなパラメータを使用して -I 国旗。 デフォルトの動作については、
このセクションの終わり。

-Ib 一致するために、与えられた名前を正規表現と見なす必要があることを指定します
(大文字と小文字を区別しない) MIB ツリー内のオブジェクト名に対して。 「ベスト」マッチは
使用される - の先頭に最も近いものとして計算されます
ノード名とツリーの最上位。 たとえば、MIB オブジェクト
vacmSecurityModel は、式 vacmsecuritymodel (フルネーム、
ただし、大文字と小文字は異なります)、または vacm.*model (正規表現パターン)。

ご了承ください '。' は正規表現パターンの特殊文字であるため、
式では、インスタンスのサブ識別子または複数のオブジェクト名を指定できません。 あ
「ベスト マッチ」表現は、単一の MIB オブジェクト名に対してのみ適用されます。 為に
例、式 sys*ontact.0 インスタンス sysContact.0 と一致しません
（ただし sys*contact sysContact と一致します)。 同様に、MIB モジュールを指定します。
name は成功しません (だから SNMPv2-MIB::sys.*接触 どちらにも一致しません）。

-ええ 値を割り当てるときに DISPLAY-HINT 情報の使用を無効にします。 これは
次に、生の値を提供する必要があります。
snmpset ... HOST-RESOURCES-MIB::hrSystemData.0
×「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 オブジェクト。

　 MIB-MODULE::オブジェクト名 構文には、一意に識別するという利点があります。
特定の MIB オブジェクトを作成するだけでなく、わずかに効率的です (そして自動的に
必要に応じて、必要な MIB ファイルをロードします)。

-は サフィックス
コマンドラインで指定された各テキスト OID に、指定されたサフィックスを追加します。 これは
を指定して、テーブルの同じ行から複数​​のオブジェクトを取得するために使用します。
共通の指標値。

-は プレフィックス
コマンドラインで指定された各テキスト OID に、指定されたプレフィックスを追加します。 これは
検索されるすべてのオブジェクトの明示的な MIB モジュール名を指定するために使用されます (または
不治の怠惰なタイピストのために）。

-イウ 入力 OID を解釈するための従来の UCD スタイルのアプローチを有効にします。 この
OID がツリーの「mib-2」ポイントに根ざしていると仮定します (開始しない限り)
明示的な「。」 または MIB モジュール名を含めます)。 したがって、上記の sysDescr インスタンス
system.sysDescr.0 として参照されます。

先頭の「.」で指定されたオブジェクト名常に「完全修飾」と解釈されます
MIB ツリーのルートから MIB オブジェクトのシーケンスをリストする OID。 このようなオブジェクトと
明示的な MIB モジュール名によって修飾されたものは、 -Ib, -トーゴ および -イウ
フラグ。

それ以外の場合、上記の入力オプションのいずれも指定されていない場合、
「相対」OID は、それを (暗黙的に) 完全に修飾された OID として解釈しようとすることです。
「ランダム アクセス」ルックアップを適用します (-トーゴ) に続いて、「ベスト マッチ」パターン マッチング (-Ib).

ENVIRONMENT 変数

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 オプションを選択します。

MIBDIR
MIB を検索するディレクトリのリスト。 デフォルトは DATADIR/snmp/mibs です。
によってオーバーライドされます -M オプションを選択します。

onworks.net サービスを使用してオンラインで pysnmpbulkwalk を使用する