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
    ＋adicionar nota

    Notas de Usuários

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