すべての SNMP オブジェクトをエージェントから取得する

説明

array snmp3_walk ( string $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',
)

参考

snmp3_real_walk() - 指定したすべてのオブジェクトとそのオブジェクト ID を返す