©
This document uses PHP Chinese website manual Release
(PHP 4, PHP 5)
snmp3_walk — Fetch all the SNMP objects from an agent
$host
, string $sec_name
, string $sec_level
, string $auth_protocol
, string $auth_passphrase
, string $priv_protocol
, string $priv_passphrase
, string $object_id
[, string $timeout
= 1000000
[, string $retries
= 5
]] ) 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', )