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

説明

snmp3_real_walk(
    string $hostname,
    string $security_name,
    string $security_level,
    string $auth_protocol,
    string $auth_passphrase,
    string $privacy_protocol,
    string $privacy_passphrase,
    array|string $object_id,
    int $timeout = -1,
    int $retries = -1
): array|false

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)。
privacy_passphrase: プライバシーパスフレーズ。
object_id: SNMP オブジェクト ID。
timeout: 最初のタイムアウトまでのマイクロ秒数。
retries: タイムアウト発生時の再試行回数。

戻り値

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

変更履歴

バージョン	説明
8.1.0	`auth_protocol` は、 libnetsnmp がサポートする場合に、新たに `"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() - エージェントから全ての SNMP オブジェクトを取得する