SNMPWALKOID(3) 1 SNMPWALKOID(3)
snmpwalkoid - Query for a tree of information about a network entity
SYNOPSIS
array snmpwalkoid (string $hostname, string $community, string $object_id, [int $timeout = 1000000], [int $retries = 5])
DESCRIPTION
snmpwalkoid(3) function is used to read all object ids and their respective values from an SNMP agent specified by $hostname.
The existence of snmpwalkoid(3) and snmpwalk(3) has historical reasons. Both functions are provided for backward compatibility. Use snm-
prealwalk(3) instead.
PARAMETERS
o $hostname
- The SNMP agent.
o $community
- The read community.
o $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.
o $timeout
- The number of microseconds until the first timeout.
o $retries
- The number of times to retry if timeouts occur.
RETURN VALUES
Returns an associative array with object ids and their respective object value starting from the $object_id as root or FALSE on error.
EXAMPLES
Example #1
snmpwalkoid(3) Example
<?php
$a = snmpwalkoid("127.0.0.1", "public", "");
for (reset($a); $i = key($a); next($a)) {
echo "$i: $a[$i]<br />
";
}
?>
Above function call would return all the SNMP objects from the SNMP agent running on localhost. One can step through the values with a
loop
SEE ALSO
snmpwalk(3).
PHP Documentation Group SNMPWALKOID(3)