snmp3_get

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

snmp3_get — Récupère un objet SNMP

Description

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 fonction snmp3_get() est utilisée pour lire la valeur d'un objet SNMP spécifié par l'identifiant object_id.

Liste de paramètres

hostname: Le nom de l'hôte de l'agent SNMP (serveur).
security_name: Le nom de sécurité, généralement une sorte de nom d'utilisateur.
security_level: Le niveau de sécurité : "noAuthNoPriv", "authNoPriv" ou "authPriv".
auth_protocol: Le protocole d'authentification : "MD5", "SHA", "SHA256" ou "SHA512".
auth_passphrase: La phrase secrète d'authentification.
privacy_protocol: Le protocole de confidentialité : "DES" ou "AES", accepté aussi comme "AES128". "AES192", "AES192C", "AES256" et "AES256C" sont acceptés lorsqu'ils sont supportés par la bibliothèque Net-SNMP.
privacy_passphrase: La phrase secrète de confidentialité.
object_id: L'identifiant de l'objet SNMP.
timeout: Le nombre de microsecondes avant le premier délai d'expiration.
retries: Le nombre de tentatives dans le cas où le délai d'expiration survient.

Valeurs de retour

Retourne la valeur de l'objet SNMP en cas de succès, ou false si une erreur survient.

Historique

Version	Description
8.6.0	Le protocole de confidentialité accepte désormais `"AES192"`, `"AES192C"`, `"AES256"` et `"AES256C"` lorsqu'ils sont supportés par la bibliothèque Net-SNMP.
8.5.0	Lance désormais une ValueError quand la longueur du nom d'hôte est supérieure ou égale à 128 octets, quand le port est négatif ou supérieur à 65535, ou quand les valeurs du délai d'expiration ou du nombre de tentatives sont inférieures à -1 ou trop grandes.
8.1.0	Le protocole d'authentification accepte désormais `"SHA256"` et `"SHA512"` lorsqu'ils sont supportés par la bibliothèque Net-SNMP.

Exemples

Exemple #1 Exemple avec snmp3_get()

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

Voir aussi

snmp3_set() - Définit la valeur d'un objet 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.