snmp3_set

パラメータ

host

SNMP エージェント (サーバ) のホスト名。

sec_name

セキュリティ名。通常はユーザ名のようなもの。

sec_level

セキュリティレベル (noAuthNoPriv|authNoPriv|authPriv)。

auth_protocol

認証プロトコル (MD5 あるいは SHA)。

auth_passphrase

認証パスフレーズ。

priv_protocol

プライバシープロトコル (DES あるいは AES)。

priv_passphrase

プライバシーパスフレーズ。

object_id

SNMP オブジェクト ID。

type

オブジェクト ID の型を定義する MIB。以下の一覧のうちの一文字で指定しなければなりません。

型

=	型を MIB から取得する
i	INTEGER
u	INTEGER
s	STRING
x	HEX STRING
d	DECIMAL STRING
n	NULLOBJ
o	OBJID
t	TIMETICKS
a	IPADDRESS
b	BITS

SNMP ライブラリのコンパイル時に OPAQUE_SPECIAL_TYPES を定義した場合は、以下の型も使えます。

型

U	unsigned int64
I	signed int64
F	float
D	double

これらの大半は、対応する ASN.1 の型を使います。's', 'x', 'd' および 'b' はどれも OCTET STRING を異なる方法で表したものであり、'u' も Gauge32 値を扱うためのものです。

MIB ファイルが "snmp_read_mib" や libsnmp の設定で MIB ツリーに読み込まれている場合は、 type に '=' を使うことができます。 これはすべてのオブジェクト ID を表し、型は自動的に MIB から読み込みます。

"SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}" のような BITS 型の値変数を設定する方法は二通りあることに注意しましょう。

• 型として "b" を使い、ビット番号の一覧を

  snmpset('FOO-MIB::bar.42', 'b', '0 1 2 3 4');
  のように指定する。 これは、同じ OID に対して snmpget() を実行しても 0xF8 などを返すので成功したかどうかを調べにくいという問題があります。

• 型として "x" を使い、通常のプレフィックス "0x" をつけずに(!) 16 進数を指定する:

  snmpset('FOO-MIB::bar.42', 'x', 'F0');

value

新しい値。

timeout

最初のタイムアウトまでのマイクロ秒数。

retries

タイムアウト発生時の再試行回数。