snmp3_get

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

snmp3_get — Busca um objeto SNMP

Descrição

snmp3_get(
    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
): mixed

A função snmp3_get() é usada para ler o valor de um objeto SNMP especificado pelo object_id.

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
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 o valor do objeto SNMP em caso de sucesso ou false em caso de erro.

Registro de Alterações

Versão Descrição
8.5.0 Agora lança um ValueError quando o comprimento do nome do host for igual ou maior que 128 bytes, quando a porta for negativa ou maior que 65535, ou quando os valores de tempo limite ou tentativas forem menores que -1 ou muito grandes.
8.1.0 O parâmetro auth_protocol agora aceita "SHA256" e "SHA512" quando suportado por libnetsnmp.

Exemplos

Exemplo #1 Usando snmp3_get()

<?php
$nameOfSecondInterface = snmp3_get('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.2');
?>

Veja Também