snmp3_walk
すべての SNMP オブジェクトをエージェントから取得する
説明
arrayfalse snmp3_walk(
string $hostname,
string $security_name,
string $security_level,
string $auth_protocol,
string $auth_passphrase,
string $privacy_protocol,
string $privacy_passphrase,
arraystring $object_id,
int $timeout = -1,
int $retries = -1
)
snmp3_walk 関数は、
hostname で指定した SNMP
エージェントからすべての値を読み込みます。
認証とプライバシーに関する引数は常に渡さなければなりませんが、
security_level で使われない引数の値は無視されます。
パラメータ
-
hostname
-
SNMP エージェント (サーバー) のホスト名。
-
security_name
-
セキュリティ名。通常はユーザー名のようなものです。
-
security_level
-
セキュリティレベル。
"noAuthNoPriv"、
"authNoPriv"、"authPriv" のいずれかです。
-
auth_protocol
-
認証プロトコル。
"MD5"、"SHA"、
"SHA256"、"SHA512" のいずれかです。
-
auth_passphrase
-
認証パスフレーズ。
-
privacy_protocol
-
プライバシープロトコル。
"DES"、
あるいは "AES"("AES128" としても受け付けられます)です。
"AES192"、"AES192C"、"AES256"、"AES256C" は、
Net-SNMP ライブラリがサポートしている場合に受け付けられます。
-
privacy_passphrase
-
プライバシーパスフレーズ。
-
object_id
-
object_id が空文字列の場合は、
SNMP オブジェクトツリーのルートである
.1.3.6.1.2.1 として解釈され、
ツリー配下のすべてのオブジェクトを配列で返します。
object_id を指定すると、
その object_id 以下のすべての
SNMP オブジェクトを返します。
-
timeout
-
最初のタイムアウトまでのマイクロ秒数。
-
retries
-
タイムアウト発生時の再試行回数。
戻り値
object_id をルートとするすべての
SNMP オブジェクトの値の配列、あるいはエラー時に
false を返します。
例
例1 snmp3_walk の例
<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>
上の関数コールは、ローカルホストで動作している
SNMP エージェントからすべての
SNMP オブジェクトを返します。
array (
0 => 'STRING: lo',
1 => 'STRING: eth0',
2 => 'STRING: eth2',
3 => 'STRING: sit0',
4 => 'STRING: sixxs',
)