snmpinfo コマンド

目的

Simple Network Management Protocol (SNMP) のエージェントが管理する管理情報ベース (MIB) の変数の値を要求または変更します。

構文

get または next オプション

snmpinfo [ -m get | next ] [  -v ] [  -c Community ] [  -d Level ] [  -h HostName ] [  -o ObjectsFile ] ... -t Tries ] Variable. Instance ...

set オプション

snmpinfo -m set-v ] [  -c Community ] [  -d Level ] [  -h HostName ] [  -o ObjectsFile ] ... [  -t Tries ] Variable . Instance= Value ...

dump オプション

snmpinfo -m dump-v ] [  -c Community ] [  -d Level ] [  -h HostName ] [  -o ObjectsFile ] ... [  -t Tries ] [  Variable. Instance ] ...

説明

snmpinfo コマンドは、SNMP エージェントに対して 1 つ以上の MIB 変数の値を要求または修正します。

get オプションを指定すると、snmpinfo コマンドは SNMP エージェントに 1 つ以上の MIB 変数に関する情報を要求します。

next オプションを指定すると、snmpinfo は SNMP エージェントから指定されたインスタンスの後に続くインスタンスに関する情報を要求します。 next オプションを指定すると、インスタンス修飾子について知らなくても MIB 値を取得できます。

set オプションを指定すると、snmpinfo コマンドは SNMP エージェントに対して 1 つ以上の MIB 変数の値を修正します。少数の MIB 変数だけが読み取り/書き込みを指定されています。 MIB データベースを管理するエージェントは、MIB 変数を修正する副次作用として、さまざまなアクションが実行されることがあります。たとえば、ifAdminStatus MIB 変数を 2 に設定すると、通常はネットワーク・インターフェースがシャットダウンされます。実行されるアクションは、データベースを管理する SNMP エージェントのインストールによって判別されます。

dump オプションを指定すると、snmpinfo コマンドは、指定されたエージェントの MIB ツリー全体を検索するために使用できます。グループが Variable パラメーターとして渡されると、snmpinfo コマンドは MIB ツリーの指定されたパスを検索します。

snmpinfo コマンドには、送信されたパケットおよび受信されたパケットのデバッグ情報をダンプするデバッグ機能があります。この機能は、-d フラグによって使用可能となります。

フラグ

-c Community SNMP エージェントを照会するために使用されるコミュニティー名を指定します。 -c フラグが指定されない場合、デフォルトのコミュニティー名は public です。
-d Level 入出力デバッグ情報のレベルを指定します。 Level の値は以下のいずれかです。
0
デバッグ情報なし
1
ポートのバインドと、送信および受信されたバイト数
2
レベル 1 と受信パケットおよび送信パケットの 16 進ダンプ
3
レベル 2 と要求パケットおよび応答パケットの英語バージョン

-d フラグを指定しないと、デフォルトのデバッグ・レベルは 0 となります。

-h HostName 照会される SNMP エージェントのホスト名を指定します。 -h フラグが指定されないと、デフォルトのホスト名は、ユーザーが現在ログインしているマシンのホスト名となります。
-m Option MIB 変数にアクセスするモードを指定します。

Option 値は以下のいずれかです。

get
指定された MIB 変数に関する情報を要求します。
next
指定されたインスタンスの後に続くインスタンスを要求します。
set
指定された書き込みアクセス可能な MIB 変数を修正します。
dump
MIB ツリーの指定された部分をダンプします。

注:
  1. オプション名は、必要最小限の文字数で指定して、固有の名前にできます。
  2. -m フラグが指定されないと、デフォルト・モードは get です。
-o ObjectsFile snmpinfo コマンドが要求できる MIB オブジェクトを定義するオブジェクト定義ファイルの名前を指定します。複数の ObjectsFile は、親定義を含むファイルが子定義を含むファイルの前に定義されるという制限付きで参照できます。
-t Tries メッセージ no SNMP response で終了する前に、snmpinfo コマンドが SNMP エージェントに SNMP 要求を送信する回数を指定します。 -t フラグが指定されないと、デフォルトの試行回数は 3 です。
-v snmpinfo コマンドからの出力を詳細モードで表示するよう指定します。 -v フラグが指定されないと、情報が詳細モードで表示されません。

パラメーター

Value MIB Variable パラメーターに設定される値を指定します。値は各変数に対して指定しなければなりません。値が指定されなければ、要求パケットは無効となります。
Variable 特定の MIB 変数の名前を、テキスト・フォーマットまたは数値フォーマットで指定します。 -m フラグに対するオプションが next または dump である場合、Variable パラメーターが MIB グループとして指定されます。
Instance MIB Variable パラメーターのインスタンス修飾子を指定します。 -m フラグに対するオプションが get または set であれば、Instance パラメーターは必須です。 -m フラグに対するオプションが next または dump であれば、Instance パラメーターはオプショナルです。

注:
  1. Variable.Instance パラメーター・シーケンスには、ブランク・スペースを入れないでください。
  2. Instance パラメーターを指定しない場合は、Variable パラメーターの後に . (ドット) を入力しないでください。

詳細については、ネットワーク管理に関しては管理情報ベース (MIB) を定義している RFC 1213 を、MIB 情報の要求の作成方法および応答のフォーマットに関しては SNMP を定義している RFC 1157 を参照してください。

  1. ifIndex.1 および SysDescr に関するインターフェース用に、MIB 変数 ifDescr.1 の値を取得するには、以下のように入力します。

    snmpinfo -m get -v sysDescr.0 ifDescr.1

    上記の例では、snmpinfo コマンドは -m get フラグにより、 MIB 変数 ifDescr.1 (ifIndex.1 に関連したインターフェースのインターフェース記述) および sysDescr.0 (ローカル・ホストのシステム記述) の値を取り出すように指定されています。

  2. IP アドレス 192.100.154.1 で指定されるホスト用に、 ipAdEntIfIndex MIB 変数の後に続く MIB 変数の値を取得するには、以下のように入力します。

    snmpinfo -m next -v 1.3.6.1.2.1.4.20.1.2.192.100.154.1

    上記の例では、snmpinfo コマンドは -m next フラグにより、MIB 変数 ifAdEntIfIndex.192.100.154.1. の情報を取り出すように指定されています。

  3. システム・グループの最初の MIB 変数を取得するには、以下のように入力します。

    snmpinfo -m next -v -h giants system

    上記の例では、snmpinfo コマンドは -m next フラグにより、システム・グループの後に続く MIB 変数 sysDescr.0 の情報を取り出すように指定されています。 -v フラグは詳細モードを示します。 -h フラグは照会されるエージェントが giants であることを示します。情報を取り出す対象となるグループは system です。

  4. MIB 変数の値を設定するには、以下のようなコマンドを入力します。

    snmpinfo -m set -v -h giants -c monitor -t 2 ifAdminStatus.1=2

    上記の例では、MIB ifAdminStatus 変数は、 giants というホスト上の ifIndex.1 に関連するインターフェースに対して 2 (down) を設定しています。 -c フラグはホストのコミュニティーを指定します。 -t 2 フラグは、SNMP エージェントからの応答を受け取らなかった場合に、snmpinfo コマンドが SNMP エージェントに SNMP 要求を 2 回送ってから終了することを指定しています。

  5. MIB ツリーのグループを詳細モードでダンプするには、以下のようなコマンドを入力します。

    snmpinfo -m dump -v interfaces

    上記の例では、interfaces グループが詳細モードでダンプされます。

  6. MIB ツリー全体をダンプするには、以下のように入力します。

    snmpinfo -m dump

関連情報