Php/docs/function.snmp3-real-walk
snmp3_real_walk
(PHP 4, PHP 5, PHP 7)
snmp3_real_walk — Return all objects including their respective object ID within the specified one
Description
snmp3_real_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
The
snmp3_real_walk() function is used to traverse over a number
of
SNMP objects starting from
object_id
and return not only their values but also their object ids.
Parameters
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- The SNMP object id.
timeout- The number of microseconds until the first timeout.
retries- The number of times to retry if timeouts occur.
Return Values
Returns an associative array of the
SNMP object ids and their values on success or FALSE on error.
In case of an error, an E_WARNING message is shown.
Examples
Example #1 Using snmp3_real_walk()
<?php var_export(snmp3_real_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName'));?>
The above will output something like:
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', )
