snmp3_walk

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

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

Description

function 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 hostname.

Les arguments d'authentification et de confidentialité doivent toujours être passés, mais leurs valeurs sont ignorées lorsque security_level ne les utilise pas.

Liste de paramètres

hostname

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

security_name

Le nom de sécurité, généralement une sorte de nom d'utilisateur.

security_level

Le niveau de sécurité : "noAuthNoPriv", "authNoPriv" ou "authPriv".

auth_protocol

Le protocole d'authentification : "MD5", "SHA", "SHA256" ou "SHA512".

auth_passphrase

La phrase secrète d'authentification.

privacy_protocol

Le protocole de confidentialité : "DES" ou "AES", accepté aussi comme "AES128". "AES192", "AES192C", "AES256" et "AES256C" sont acceptés lorsqu'ils sont supportés par la bibliothèque Net-SNMP.

privacy_passphrase

La phrase secrète de confidentialité.

object_id

Si la chaîne est vide, object_id sera .1.3.6.1.2.1, 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.6.0 Le protocole de confidentialité accepte désormais "AES192", "AES192C", "AES256" et "AES256C" lorsqu'ils sont supportés par la bibliothèque Net-SNMP.
8.1.0 Le protocole d'authentification accepte désormais "SHA256" et "SHA512" lorsqu'ils sont supportés par la bibliothèque Net-SNMP.

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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.