(PHP 4, PHP 5)
snmp3_walk — Récupère tous les objets SNMP depuis un agent
$host
, string $sec_name
, string $sec_level
, string $auth_protocol
, string $auth_passphrase
, string $priv_protocol
, string $priv_passphrase
, string $object_id
[, string $timeout = 1000000
[, string $retries = 5
]] )
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.
host
Le nom de l'hôte de l'agent SNMP (serveur).
sec_name
Le nom de la sécurité, habituellement, le nom de l'utilisateur.
sec_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.
priv_protocol
Le protocole privé (DES ou AES).
priv_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.
Retourne un tableau de valeurs d'objets SNMP
en commençant depuis l'objet object_id
comme racine, ou FALSE si une erreur survient.
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', )