SNMP::walk
(PHP 5 >= 5.4.0)
SNMP::walk — Fetch SNMP object subtree
Description
$object_id
[, bool $suffix_as_key
= FALSE
[, int $max_repetitions
[, int $non_repeaters
]]] )
SNMP::walk() is used to read SNMP subtree rooted at specified object_id
.
Parameters
-
object_id
-
Root of subtree to be fetched
-
suffix_as_key
-
By default full OID notation is used for keys in output array. If set to
TRUE
subtree prefix will be removed from keys leaving only suffix of object_id. -
non_repeaters
-
This specifies the number of supplied variables that should not be iterated over. The default is to use this value from SNMP object.
-
max_repetitions
-
This specifies the maximum number of iterations over the repeating variables. The default is to use this value from SNMP object.
Return Values
Returns an associative array of the SNMP object ids and their values on success or FALSE
on error.
When a SNMP error occures SNMP::getErrno() and
SNMP::getError() can be used for retrieving error
number (specific to SNMP extension, see class constants) and error message
respectively.
Errors/Exceptions
This method does not throw any exceptions by default.
To enable throwing an SNMPException exception when some of library errors occur
the SNMP class parameter exceptions_enabled
should be set to a corresponding value. See
SNMP::$exceptions_enabled
explanation for more details.
Examples
Example #1 SNMP::walk() example
<?php
$session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
$fulltree = $session->walk(".");
print_r($fulltree);
$session->close();
?>
The above example will output something similar to:
Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 [DISMAN-EVENT-MIB::sysUpTimeInstance] => Timeticks: (1150681750) 133 days, 4:20:17.50 [SNMPv2-MIB::sysContact.0] => STRING: Nobody [SNMPv2-MIB::sysName.0] => STRING: server.localdomain ... )
Example #2 suffix_as_key
example
suffix_as_key
may be used when merging multiple SNMP subtrees into one.
This example maps interface names to their type.
<?php
$session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
$session->valueretrieval = SNMP_VALUE_PLAIN;
$ifDescr = $session->walk(".1.3.6.1.2.1.2.2.1.2", TRUE);
$session->valueretrieval = SNMP_VALUE_LIBRARY;
$ifType = $session->walk(".1.3.6.1.2.1.2.2.1.3", TRUE);
print_r($ifDescr);
print_r($ifType);
$result = array();
foreach($ifDescr as $i => $n) {
$result[$n] = $ifType[$i];
}
print_r($result);
?>
The above example will output something similar to:
Array ( [1] => igb0 [2] => igb1 [3] => ipfw0 [4] => lo0 [5] => lagg0 ) Array ( [1] => INTEGER: ieee8023adLag(161) [2] => INTEGER: ieee8023adLag(161) [3] => INTEGER: ethernetCsmacd(6) [4] => INTEGER: softwareLoopback(24) [5] => INTEGER: ethernetCsmacd(6) ) Array ( [igb0] => INTEGER: ieee8023adLag(161) [igb1] => INTEGER: ieee8023adLag(161) [ipfw0] => INTEGER: ethernetCsmacd(6) [lo0] => INTEGER: softwareLoopback(24) [lagg0] => INTEGER: ethernetCsmacd(6) )
See Also
- SNMP::getErrno() - Get last error code
- SNMP::getError() - Get last error message
- Функция SNMP::close() - Close SNMP session
- Функция SNMP::__construct() - Creates SNMP instance representing session to remote SNMP agent
- Функция SNMP::get() - Fetch an SNMP object
- Функция SNMP::getErrno() - Get last error code
- Функция SNMP::getError() - Get last error message
- SNMP::getnext
- Функция SNMP::set() - Set the value of an SNMP object
- Функция SNMP::setSecurity() - Configures security-related SNMPv3 session parameters
- Функция SNMP::walk() - Fetch SNMP object subtree
Коментарии
404 Not Found