snmp3_walk

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

snmp3_walkBusca todos os objetos SNMP de um agente

Descrição

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

A função snmp3_walk() é usada para ler todos os valores de um agente SNMP especificado pelo hostname.

Mesmo que o nível de segurança não use um protocolo/senha auth ou priv, valores válidos devem ser especificados.

Parâmetros

hostname

O nome do host do agente SNMP (servidor).

security_name

O nome de segurança, geralmente algum tipo de nome de usuário

security_level

O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)

auth_protocol

O protocolo de autenticação ("MD5", "SHA", "SHA256" ou "SHA512")

auth_passphrase

A senha de autenticação

privacy_protocol

O protocolo de privacidade (DES ou AES)

privacy_passphrase

A senha de privacidade

object_id

Se null, object_id for considerado a raiz da árvore de objetos SNMP e todos os objetos sob essa árvore serão retornados como um array.

Se object_id for especificado, todos os objetos SNMP abaixo desse object_id serão retornados.

timeout

O número de microssegundos até o primeiro tempo limite.

retries

O número de tentativas caso ocorram tempos limite.

Valor Retornado

Retorna um array de valores de objetos SNMP começando pelo object_id como raiz ou false em caso de erro.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro auth_protocol agora aceita "SHA256" e "SHA512" quando suportado por libnetsnmp.

Exemplos

Exemplo #1 Exemplo de snmp3_walk()

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

A chamada de função acima retornaria todos os objetos SNMP do agente SNMP em execução no host local:

array (
  0 => 'STRING: lo',
  1 => 'STRING: eth0',
  2 => 'STRING: eth2',
  3 => 'STRING: sit0',
  4 => 'STRING: sixxs',
)

Veja Também

  • snmp3_real_walk() - Retorna todos os objetos, incluindo seus respectivos IDs de objeto dentro do especificado