snmp3_walk

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

snmp3_walk — Récupère tous les objets SNMP depuis un agent

Description

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

La fonction snmp3_walk() est utilisée pour lire toutes les valeurs depuis un agent SNMP spécifié par le paramètre host.

Même si le niveau de sécurité n'utilise pas de protocole d'authentification, des valeurs valides doivent être spécifiées.

Liste de paramètres

hostname

Le nom de l'hôte de l'agent SNMP (serveur).

security_name

Le nom de la sécurité, habituellement, le nom de l'utilisateur.

security_level

Le niveau de sécurité (noAuthNoPriv|authNoPriv|authPriv).

auth_protocol

Le protocole d'authentification (MD5 ou SHA).

auth_passphrase

La phrase secrète d'authentification.

privacy_protocol

Le protocole privé (DES ou AES).

privacy_passphrase

La phrase secrète privée.

object_id

Si vaut null, object_id sera la racine de l'arbre des objets SNMP et tous les objets sous-jacents sont retournés sous forme d'un tableau.

Si object_id est spécifié, tous les objets SNMP sous l'objet object_id seront retournés.

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 un tableau de valeurs d'objets SNMP en commençant depuis l'objet object_id comme racine, ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec snmp3_walk()

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

L'appel à la fonction précédente retournera tous les objets SNMP depuis l'agent SNMP s'exécutant sur localhost: 

      
array (
  0 => 'STRING: lo',
  1 => 'STRING: eth0',
  2 => 'STRING: eth2',
  3 => 'STRING: sit0',
  4 => 'STRING: sixxs',
)

Voir aussi

  • snmp3_real_walk() - Retourne tous les objets incluant les identifiants de leurs objets respectifs