(バージョン情報なし。おそらく SVN 版にしか存在しないでしょう)
snmp3_set — Description
snmp3_set() は、 object_id で指定した SNMP オブジェクトの値を設定します。
セキュリティレベルに auth や priv を使っていなくても、 protocol/password には有効な値を指定しなくてはなりません。
SNMP エージェント (サーバ) のホスト名。
セキュリティ名。通常はユーザ名のようなもの。
セキュリティレベル (noAuthNoPriv|authNoPriv|authPriv)。
認証プロトコル (MD5 あるいは SHA)。
認証パスフレーズ。
プライバシープロトコル (DES あるいは AES)。
プライバシーパスフレーズ。
SNMP オブジェクト ID。
オブジェクト 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');
型として "x" を使い、通常のプレフィックス "0x" をつけずに(!) 16 進数を指定する:
snmpset('FOO-MIB::bar.42', 'x', 'F0');
新しい値。
最初のタイムアウトまでのマイクロ秒数。
タイムアウト発生時の再試行回数。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
SNMP ホストがデータ型を却下すると、"Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." のような’ E_WARNING メッセージが表示されます。未知の OID あるいは無効な OID を指定した場合は、おそらく "Could not add variable" のような警告となります。
例1 snmp3_set() の使用法
<?php
snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifAlias.3', 's', "foo");
?>