snmp3_walk

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

snmp3_walkRecupera todos los objetos SNMP desde un agente

Descripción

function 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.

Los argumentos de autenticación y de privacidad deben pasarse siempre, pero sus valores se ignoran cuando security_level no los utiliza.

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

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.

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

Véase 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.