snmp3_walk

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

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

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

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

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