snmp3_walk

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

    snmp3_walk — Recupera 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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

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