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

# snmp3_real_walk

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### 説明

function 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 オブジェクトを取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open