snmp3_walk

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

snmp3_walkRecupera todos los objetos SNMP desde un agente

Descripción

snmp3_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_walk() se utiliza para leer todos los valores desde un agente SNMP especificado por el parámetro host.

Aunque el nivel de seguridad no utilice un protocolo de autenticación, se deben especificar valores válidos.

Parámetros

hostname

El nombre del host del agente SNMP (servidor).

security_name

El nombre de la seguridad, habitualmente, el nombre del usuario.

security_level

El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv).

auth_protocol

El protocolo de autenticación ("MD5", "SHA", "SHA256" o "SHA512").

auth_passphrase

La frase secreta de autenticación.

privacy_protocol

El protocolo privado (DES o AES).

privacy_passphrase

La frase secreta privada.

object_id

Si vale null, object_id será 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.

timeout

El número de microsegundos antes del primer tiempo límite.

retries

El número de intentos en caso de que ocurra el tiempo límite.

Valores devueltos

Devuelve un array de valores de objetos SNMP comenzando desde el objeto object_id como raíz, o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro auth_protocol acepta ahora "SHA256" y "SHA512" cuando es soportado por libnetsnmp.

Ejemplos

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',
)

Ver también

  • snmp3_real_walk() - Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top