(PHP 4, PHP 5, PHP 7, PHP 8)
snmp3_walk — Busca todos os objetos SNMP de um agente
$hostname
,$security_name
,$security_level
,$auth_protocol
,$auth_passphrase
,$privacy_protocol
,$privacy_passphrase
,$object_id
,$timeout
= -1,$retries
= -1
A função snmp3_walk() é usada para ler todos os valores de
um agente SNMP especificado pelo hostname
.
Mesmo que o nível de segurança não use um protocolo/senha auth ou priv, valores válidos devem ser especificados.
hostname
O nome do host do agente SNMP (servidor).
security_name
O nome de segurança, geralmente algum tipo de nome de usuário
security_level
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
auth_protocol
O protocolo de autenticação ("MD5"
, "SHA"
,
"SHA256"
ou "SHA512"
)
auth_passphrase
A senha de autenticação
privacy_protocol
O protocolo de privacidade (DES ou AES)
privacy_passphrase
A senha de privacidade
object_id
Se null
, object_id
for considerado a raiz da
árvore de objetos SNMP e todos os objetos sob essa árvore serão retornados como
um array.
Se object_id
for especificado, todos os objetos SNMP
abaixo desse object_id
serão retornados.
timeout
O número de microssegundos até o primeiro tempo limite.
retries
O número de tentativas caso ocorram tempos limite.
Retorna um array de valores de objetos SNMP começando pelo
object_id
como raiz ou false
em caso de erro.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro auth_protocol agora aceita "SHA256"
e "SHA512" quando suportado por libnetsnmp.
|
Exemplo #1 Exemplo de snmp3_walk()
<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>
A chamada de função acima retornaria todos os objetos SNMP do agente SNMP em execução no host local:
array ( 0 => 'STRING: lo', 1 => 'STRING: eth0', 2 => 'STRING: eth2', 3 => 'STRING: sit0', 4 => 'STRING: sixxs', )