# snmp3_walk

(PHP 4, PHP 5, PHP 7)

snmp3_walk — Fetch all the SNMP objects from an agent

### 说明

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` [, int `$timeout` = 1000000 [, int `$retries` = 5 ]] ) : array

snmp3_walk() function is used to read all the values from an SNMP agent specified by the `hostname`.

Even if the security level does not use an auth or priv protocol/password valid values have to be specified.

### 参数

`host`

  The hostname of the SNMP agent (server).

`sec_name`

  the security name, usually some kind of username

`sec_level`

  the security level (noAuthNoPriv|authNoPriv|authPriv)

`auth_protocol`

  the authentication protocol (MD5 or SHA)

`auth_passphrase`

  the authentication pass phrase

`priv_protocol`

  the privacy protocol (DES or AES)

`priv_passphrase`

  the privacy pass phrase

`object_id`

  If `NULL`, `object_id` is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array.

  If `object_id` is specified, all the SNMP objects below that `object_id` are returned.

`timeout`

  The number of microseconds until the first timeout.

`retries`

  The number of times to retry if timeouts occur.

### 返回值

Returns an array of SNMP object values starting from the `object_id` as root or `FALSE` on error.

### 范例

Example #1 snmp3_walk() Example

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

Above function call would return all the SNMP objects from the SNMP agent running on localhost:

    array (
      0 => 'STRING: lo',
      1 => 'STRING: eth0',
      2 => 'STRING: eth2',
      3 => 'STRING: sit0',
      4 => 'STRING: sixxs',
    )

### 参见

- snmp3_real_walk() - Return all objects including their respective object ID within the specified one