(PHP 4, PHP 5, PHP 7, PHP 8)
snmp3_walk — Recupera todos los objetos SNMP desde un agente
$hostname,$security_name,$security_level,$auth_protocol,$auth_passphrase,$privacy_protocol,$privacy_passphrase,$object_id,$timeout = -1,$retries = -1
La función snmp3_walk() se utiliza para leer
todos los valores desde un agente SNMP especificado
por el parámetro host.
Los argumentos de autenticación y de privacidad deben pasarse siempre, pero
sus valores se ignoran cuando security_level no los
utiliza.
hostnameEl nombre del host del agente SNMP (servidor).
security_nameEl nombre de seguridad, habitualmente algún tipo de nombre de usuario.
security_levelEl nivel de seguridad: "noAuthNoPriv",
"authNoPriv" o "authPriv".
auth_protocolEl protocolo de autenticación: "MD5", "SHA",
"SHA256" o "SHA512".
auth_passphraseLa frase de contraseña de autenticación.
privacy_protocolEl protocolo de privacidad: "DES" o "AES",
aceptado también como "AES128". "AES192", "AES192C",
"AES256" y "AES256C" se aceptan cuando la biblioteca
Net-SNMP los soporta.
privacy_passphraseLa frase de contraseña de privacidad.
object_id
Si es un string vacío, object_id se toma como
.1.3.6.1.2.1, la raíz del árbol de objetos
SNMP, y todos los objetos subyacentes se devuelven en
forma de array.
Si object_id está especificado,
todos los objetos SNMP bajo el objeto
object_id serán devueltos.
timeoutEl número de microsegundos antes del primer tiempo límite.
retriesEl número de intentos en caso de que ocurra el tiempo límite.
Devuelve un array de valores de objetos SNMP
comenzando desde el objeto object_id
como raíz, o false si ocurre un error.
| Versión | Descripción |
|---|---|
| 8.6.0 |
El protocolo de privacidad ahora acepta "AES192",
"AES192C", "AES256" y
"AES256C" cuando la biblioteca Net-SNMP lo soporta.
|
| 8.1.0 |
El protocolo de autenticación ahora acepta "SHA256"
y "SHA512" cuando la biblioteca Net-SNMP lo soporta.
|
Ejemplo #1 Ejemplo con snmp3_walk()
<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>La llamada a la función anterior devolverá todos los objetos SNMP desde el agente SNMP ejecutándose en localhost:
array ( 0 => 'STRING: lo', 1 => 'STRING: eth0', 2 => 'STRING: eth2', 3 => 'STRING: sit0', 4 => 'STRING: sixxs', )