PHP Manual»Fonctions SNMP»snmp3_real_walk

snmp3_real_walk

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

snmp3_real_walk — Retourne tous les objets incluant les identifiants de leurs objets respectifs

Description

function snmp3_real_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

La fonction snmp3_real_walk() est utilisée pour parcourir un nombre d'objets SNMP en commençant par l'objet dont l'identifiant est object_id et retourne non seulement leurs valeurs, mais aussi les identifiants des objets associés.

Liste de paramètres

hostname: Le nom d'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ù un délai d'expiration survient.

Valeurs de retour

Retourne un tableau associatif d'identifiants d'objets SNMP ainsi que leurs valeurs en cas de succès, ou false si une erreur survient. Dans le cas où une erreur survient, une alerte de niveau E_WARNING est émise.

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.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_real_walk()

<?php
 var_export(snmp3_real_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName'));
?>

L'exemple ci-dessus affichera quelque chose comme :

array (
  'IF-MIB::ifName.1' => 'STRING: lo',
  'IF-MIB::ifName.2' => 'STRING: eth0',
  'IF-MIB::ifName.3' => 'STRING: eth2',
  'IF-MIB::ifName.4' => 'STRING: sit0',
  'IF-MIB::ifName.5' => 'STRING: sixxs',
)

Voir aussi

snmpwalk() - Reçoit tous les objets SNMP d'un agent