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

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top