snmp3_real_walk

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

snmp3_real_walk — Retorna todos os objetos, incluindo seus respectivos IDs de objeto dentro do especificado

Descrição

snmp3_real_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_real_walk() é usada para percorrer uma série de objetos SNMP a partir de object_id e retornar não apenas seus valores, mas também seus IDs de objeto.

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 ou SHA)
auth_passphrase
A senha de autenticação
privacy_protocol
O protocolo de autenticação ("MD5", "SHA", "SHA256" ou "SHA512")
privacy_passphrase
A senha de privacidade
object_id
O ID do objeto SNMP.
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 associativo dos IDs de objetos SNMP e seus valores em caso de sucesso ou false em caso de erro. Em caso de erro, uma mensagem E_WARNING é exibida.

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 Usando snmp3_real_walk()

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

O resultado do exemplo acima será algo como: 

array (
  'IF-MIB::ifName.1' => 'STRING: lo',
  'IF-MIB::ifName.2' => 'STRING: eth0',
  'IF-MIB::ifName.3' => 'STRING: eth2',
  'IF-MIB::ifName.4' => 'STRING: sit0',
  'IF-MIB::ifName.5' => 'STRING: sixxs',
)

Veja Também

  • snmpwalk() - Busca todos os objetos SNMP de um agente