snmp3_walk

Fetch all the SNMP objects from an agent

&reftitle.description; ``array``false```snmp3_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

`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.

&reftitle.parameters;

`hostname`

- The hostname of the SNMP agent (server).

`security_name`

- the security name, usually some kind of username

`security_level`

- the security level (noAuthNoPriv|authNoPriv|authPriv)

`auth_protocol`

- the authentication protocol (`"MD5"`, `"SHA"`, `"SHA256"`, or `"SHA512"`)

`auth_passphrase`

- the authentication pass phrase

`privacy_protocol`

- the privacy protocol (DES or AES)

`privacy_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.

&reftitle.returnvalues;

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

&reftitle.changelog;

&Version; | &Description;
8.1.0 | The `auth_protocol` now accepts `"SHA256"` and `"SHA512"` when supported by libnetsnmp.

&reftitle.examples;

### `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', )

&reftitle.seealso;

- `snmp3_real_walk`