array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.snmp3-walk.php', 1 => 'snmp3_walk', 2 => 'Récupère tous les objets SNMP depuis un agent', ), 'up' => array ( 0 => 'ref.snmp.php', 1 => 'Fonctions SNMP', ), 'prev' => array ( 0 => 'function.snmp3-set.php', 1 => 'snmp3_set', ), 'next' => array ( 0 => 'function.snmpget.php', 1 => 'snmpget', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/snmp/functions/snmp3-walk.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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", "SHA", "SHA256" ou "SHA512").
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.

Historique

Version Description
8.1.0 Le paramètre auth_protocol accepte désormais "SHA256" et "SHA512" lorsqu'il est supporté par libnetsnmp.

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