(PHP 4, PHP 5, PHP 7)
snmp3_walk — すべての SNMP オブジェクトをエージェントから取得する
$host
, string $sec_name
, string $sec_level
, string $auth_protocol
, string $auth_passphrase
, string $priv_protocol
, string $priv_passphrase
, string $object_id
[, string $timeout
= 1000000
[, string $retries
= 5
]] )
snmp3_walk() 関数は、
hostname
で指定した SNMP
エージェントからすべての値を読み込みます。
セキュリティレベルに auth や priv を使っていなくても、 protocol/password には有効な値を指定しなくてはなりません。
host
SNMP エージェント (サーバー) のホスト名。
sec_name
セキュリティ名。通常はユーザー名のようなもの。
sec_level
セキュリティレベル (noAuthNoPriv|authNoPriv|authPriv)。
auth_protocol
認証プロトコル (MD5 あるいは SHA)。
auth_passphrase
認証パスフレーズ。
priv_protocol
プライバシープロトコル (DES あるいは AES)。
priv_passphrase
プライバシーパスフレーズ。
object_id
NULL
の場合は object_id
は
SNMP オブジェクトツリーのルートとなり、
ツリー配下のすべてのオブジェクトを配列で返します。
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', )