snmp3_walk
(PHP 4, PHP 5)
snmp3_walk — Récupère tous les objets SNMP depuis un agent
Description
$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.
Liste de paramètres
-
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'objetobject_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