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_idsera la racine de l'arbre des objets SNMP et tous les objets sous-jacents sont retournés sous forme d'un tableau.Si
object_idest spécifié, tous les objets SNMP sous l'objetobject_idseront 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
