snmp3_get

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

snmp3_get — Recupera un objeto SNMP

Descripción

function 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

La función snmp3_get() se utiliza para leer el valor de un objeto SNMP especificado por el identificador object_id.

Parámetros

hostname: El nombre del host del agente SNMP (servidor).
security_name: El nombre de seguridad, habitualmente algún tipo de nombre de usuario.
security_level: El nivel de seguridad: "noAuthNoPriv", "authNoPriv" o "authPriv".
auth_protocol: El protocolo de autenticación: "MD5", "SHA", "SHA256" o "SHA512".
auth_passphrase: La frase de contraseña de autenticación.
privacy_protocol: El protocolo de privacidad: "DES" o "AES", aceptado también como "AES128". "AES192", "AES192C", "AES256" y "AES256C" se aceptan cuando la biblioteca Net-SNMP los soporta.
privacy_passphrase: La frase de contraseña de privacidad.
object_id: El identificador del objeto SNMP.
timeout: El número de microsegundos antes del primer tiempo límite.
retries: El número de intentos en caso de tiempo límite.

Valores devueltos

Devuelve el valor del objeto SNMP en caso de éxito, o false si ocurre un error.

Historial de cambios

Versión	Descripción
8.6.0	El protocolo de privacidad ahora acepta `"AES192"`, `"AES192C"`, `"AES256"` y `"AES256C"` cuando la biblioteca Net-SNMP lo soporta.
8.5.0	Ahora lanza un ValueError cuando la longitud del nombre de host es igual o mayor a 128 bytes, cuando el puerto es negativo o mayor que 65535, o cuando los valores de timeout o reintentos son menores a -1 o demasiado grandes.
8.1.0	El protocolo de autenticación ahora acepta `"SHA256"` y `"SHA512"` cuando la biblioteca Net-SNMP lo soporta.

Ejemplos

Ejemplo #1 Ejemplo con snmp3_get()

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

Véase también

snmp3_set() - Define el valor de un objeto SNMP

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.