snmptrap
形式
snmptrap [-d][-p ポート番号][-c コミュニティ名] ノード名 企業ID agentアドレス 標準トラップ番号 拡張トラップ番号 タイムスタンプ [オブジェクト識別子 値のシンタクス 値…]
機能
指定ノードに対してSNMPトラップを発行します。
格納場所
-
AIX以外の場合:/opt/OV/bin
-
AIXの場合:/usr/OV/bin
引数
- -d
-
SNMPパケットを16進数表示,およびデコーディングされたASN.1形式で標準出力に出力します。
- -p ポート番号
-
送信するマネージャーのポート番号を指定します。省略時すると162が仮定されます。
- -c コミュニティ名
-
コミュニティ名を指定します。省略するとpublicが仮定されます。
- ノード名
-
IPアドレス,またはホスト名を指定します。
- 企業ID
-
sysObjectIDを指定します。形式はA.B.C.D…です。ただしA,B,C,Dは10進数表示のサブ識別子です。形式A.B.C.D…ではオブジェクト識別子の先頭が'1.3.6.1.2.1'であれば,'1.3.6.1.2.1'は省略できます。null文字列('')はSNMPエージェントのsysObjectIDになります。SNMPエージェント機能のsysObjectIDについては,「4.3.1 日立企業固有MIBオブジェクトの構成」を参照してください。
- agentアドレス
-
IPアドレス,またはホスト名を指定します。NULL文字列('')を指定した場合,該当するシステムのOSの関数を使用して取得したホスト名を,OSの関数を使用してIPアドレスに変換した値になります。
なお,snmptrapコマンドで発行するトラップメッセージ中のエージェントアドレスに,特定のIPアドレスを使用したい場合は,「agentアドレス」にそのIPアドレスを指定してください。
- 標準トラップ番号
-
標準トラップ番号を0〜6の整数で指定します。拡張トラップを発行する場合は6を指定します。
- 拡張トラップ番号
-
拡張トラップ番号を32ビットの整数で指定します。ただし,標準トラップ番号が6でない場合無視され0が埋められます。有効値は正数,負数,16進数(0x〜),および8進数(0〜)です。
- タイムスタンプ
-
時刻を0以上の整数で指定します。NULL文字列('')を指定した場合にはシステム開始からのtimeticksが仮定されます。
- オブジェクト識別子
-
snmptrapコマンドは,「オブジェクト識別子,値のシンタクス,値」を1組とした引数を複数指定できます。一度に指定できる引数の数は1つの値の長さを256バイトとした場合,最大20個を目安としてください。オブジェクト識別子の形式はA.B.C.D…です。A,B,C,Dは10進数表示のサブ識別子です。形式A.B.C.D…ではオブジェクト識別子の先頭が'1.3.6.1.2.1'であれば,'1.3.6.1.2.1'は省略できます。
- 値のシンタクス
-
値のシンタクスは次の中から選択します。
integer(-231〜231-1),octetstring,objectidentifier(形式がA.B.C.D…で,オブジェクト識別子の先頭が'1.3.6.1.2.1'であれば,'1.3.6.1.2.1'は省略できます),null(このあとの'値'に何を設定しても無視されます),ipaddress,counter(0〜4294967295),gauge,timeticks,opaque。それぞれの詳細については,RFC1155を参照してください。
また,octetstringの特別なケースとして,octetstringhex(00〜FFの16進数列指定,例:01FF),octetstringoctal(000〜377の8進数列指定,例:001377),octetstringascii(ASCIIコード文字列指定)が指定できます。opaqueの特別なケースとして,opaquehex(00〜FFの16進数列指定,例:01FF),opaqueoctal(000〜377の8進数列指定,例:001377),opaqueascii(ASCIIコード文字列指定)が指定できます。
- 値
-
値のシンタクスに対して正しい値を指定します。
戻り値
- 0:正常終了
-
SNMPトラップはUDPで送信するので,相手ノードとの送達確認はしません。そのため,正常終了した場合でも相手ノードに通知されない場合があります。
- 1:実行時エラー
-
エラーメッセージを出力します。
注意事項
AIXでcronや/etc/inittabから起動されたシェルスクリプトやプログラムの延長でsnmptrapコマンドを実行した場合,次のようなエラーが出力されコマンドが失敗することがあります。
snmptrap:cannot set locale($LANG="Ja_JP")
この場合,環境変数LC_ALLに使用する言語を設定してください。
使用する言語に’C’を設定する場合のBシェルの例を次に示します。
LC_ALL=C export LC_ALL snmptrap flcndmak .1.3.6.1.4.1.4242 15.6.71.223 6 2 0