snmp3_walk
(PHP 4, PHP 5, PHP 7)
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
[,
int $timeout
= 1000000 [,
int $retries
= 5 ]] ) :
array
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 thatobject_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', )
参见
- snmp3_real_walk() - Return all objects including their respective object ID within the specified one