snmp3_walk()
(PHP 4, PHP 5, PHP 7)
Fetch all the SNMP objects from an agent
说明
snmp3_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
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_idis taken as the root of the SNMP objects tree and all objects under that tree are returned as an array.If$object_idis specified, all the SNMP objects below that$object_idare 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_idas 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