snmp3_real_walk

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

説明

arrayfalse snmp3_real_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_real_walk 関数は、 object_id から始まる SNMP オブジェクトを走査し、その値とオブジェクト ID を返します。

パラメータ

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
SNMP オブジェクト ID。
timeout
最初のタイムアウトまでのマイクロ秒数。
retries
タイムアウト発生時の再試行回数。

戻り値

成功した場合に SNMP オブジェクト ID とその値の連想配列。エラー時に false を返します。 エラー時には E_WARNING が発生します。

変更履歴

バージョン 説明
8.6.0 Net-SNMP ライブラリがサポートしている場合に、プライバシープロトコルが "AES192"、"AES192C"、 "AES256"、"AES256C" を受け付けるようになりました。
8.1.0 Net-SNMP ライブラリがサポートしている場合に、認証プロトコルが "SHA256" と "SHA512" を受け付けるようになりました。

例

例1 snmp3_real_walk の使用法

<?php
 var_export(snmp3_real_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName'));
?>

上の例の結果は次のようになります。

array (
  'IF-MIB::ifName.1' => 'STRING: lo',
  'IF-MIB::ifName.2' => 'STRING: eth0',
  'IF-MIB::ifName.3' => 'STRING: eth2',
  'IF-MIB::ifName.4' => 'STRING: sit0',
  'IF-MIB::ifName.5' => 'STRING: sixxs',
)

参考

  • snmpwalk