PHP Manual»Funciones SNMP»snmp3_real_walk

snmp3_real_walk

(PHP 4, PHP 5, PHP 7, PHP 8)

snmp3_real_walk — Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos

Descripción

function snmp3_real_walk(
    string $hostname,
    string $security_name,
    string $security_level,
    string $auth_protocol,
    string $auth_passphrase,
    string $privacy_protocol,
    string $privacy_passphrase,
    array|string $object_id,
    int $timeout = -1,
    int $retries = -1
): array|false

La función snmp3_real_walk() se utiliza para recorrer un número de objetos SNMP comenzando por el objeto cuyo identificador es object_id y devuelve no solo sus valores, sino también los identificadores de los objetos asociados.

Parámetros

hostname: El nombre del host del agente SNMP (servidor).
security_name: El nombre de seguridad, habitualmente algún tipo de nombre de usuario.
security_level: El nivel de seguridad: "noAuthNoPriv", "authNoPriv" o "authPriv".
auth_protocol: El protocolo de autenticación: "MD5", "SHA", "SHA256" o "SHA512".
auth_passphrase: La frase de contraseña de autenticación.
privacy_protocol: El 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_passphrase: La frase de contraseña de privacidad.
object_id: El identificador del objeto SNMP.
timeout: El número de microsegundos antes del primer tiempo límite.
retries: El número de intentos en caso de que ocurra un tiempo límite.

Valores devueltos

Devuelve un array asociativo de identificadores de objetos SNMP junto con sus valores en caso de éxito, o false si ocurre un error. En caso de error, se emite una alerta de nivel E_WARNING.

Historial de cambios

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.

Ejemplos

Ejemplo #1 Ejemplo con snmp3_real_walk()

<?php
 var_export(snmp3_real_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName'));
?>

El ejemplo anterior mostrará algo como:

array (
  'IF-MIB::ifName.1' => 'STRING: lo',
  'IF-MIB::ifName.2' => 'STRING: eth0',
  'IF-MIB::ifName.3' => 'STRING: eth2',
  'IF-MIB::ifName.4' => 'STRING: sit0',
  'IF-MIB::ifName.5' => 'STRING: sixxs',
)

Véase también

snmpwalk() - Recibe todos los objetos SNMP de un agente