PHP 5.6.0 released

snmpwalk

(PHP 4, PHP 5)

snmpwalkHolt alle SNMP Objekte eines Agenten

Beschreibung

array snmpwalk ( string $hostname , string $community , string $object_id [, int $timeout [, int $retries ]] )

Gibt einen Array von SNMP Objekten zurück, der mit der object_id() als Wurzel beginn, oder FALSE bei einem Fehler.

Die snmpwalk() Funktion wird verwendet um alle Werte von dem SNMP Agenten zu lesen, der bei hostname angegeben wurde. Der Community Parameter bestimmt die Lese-"Community" für diesen Agenten. Ein NULL object_id wird als Wurzel des SNMP Objektbaums verwendet und alle Objekts unter diesem Baum als ein Array zurückgegeben. Wenn object_id angegeben wird, werden alle SNMP Objekte unterhalb der object_id zurückgegeben.

$a = snmpwalk("127.0.0.1", "public", "");

Der obige Funktionsaufruf gibt alle SNMP Objekte des Agenten, der auf localhost läuft, zurück. Man kann mit einer Schleife alle Werte durchlaufen.

for ($i=0; $i < count($a); $i++) {
    echo $a[$i];
}

add a note add a note

User Contributed Notes 9 notes

up
2
Lars Troen
11 years ago
Note that there's different behaviuor in php snmpwalk and ucd snmpwalk. If you try to walk an oid that has one value not under a subkey of the walked oid, ucd snmpwalk will return the value while php's snmpwalk will not.
up
1
http://mike.eire.ca
9 years ago
I found on Windows (PHP 5) an empty string did not return anything, it just timed out.  I had to use null instead:

<?php
$a
= snmpwalk("127.0.0.1", "public", null);
?>
up
1
anders at ei dot nu
11 years ago
It would be nice to be able to specify what snmp version to use ( 1,2c,3 )

For now, I'ts hardcoded in ext/snmp/snmp.c

change session.version from 1 to 2c or 3 if you need for now..

i.e

session.version = SNMP_VERSION_1;

to:
session.version = SNMP_VERSION_2c;
up
0
bobby [dot] clark [at] eku [dot] edu
10 years ago
I had to use an object_id like these.
'SNMPv2-MIB::system.sysDescr.0'
'IF-MIB::interfaces.ifTable.ifEntry.ifAdminStatus'

<?php
$host
= '192.168.1.1';
$community = 'public';
$object_id = 'IF-MIB::interfaces.ifTables.ifEntry.ifAdminStatus';

$sysdesc = snmpwalk($host, $community', $object_id);
print_r($sysdesc);
?>
up
0
steve at ourabode dot org
12 years ago
Timeout is in MICRO seconds.
1,000,000 &micros = 1 s
up
0
layer2 at www dot com
12 years ago
Something to care about in dealing with snmpwalk:<BR>
While walking the MIB, snmpwalk puts info that gets into an array, and that is correct.<BR>
The trouble happened when snmpwalk needs to collect information from instances that contains subinstances (i.e. walking .1.2.3.4.5 and having instances like 1.1, 1.2, 1.3): in this case it gets info and passes into an array, but when walking the array, each value is preceeded by 'Counter32: '.<BR>
I've tested this in many ways and it always happened the same way.
up
0
john at antefacto dot com
13 years ago
Ah. That's why all of our SNMP stuff was timing out anytime there was any load on the system. Sigh. A waste of two weeks trying to debug snmp....

Even the snmpcmd manpage doesn't give a
unit for timeout.
up
0
billf at freebsd dot org
13 years ago
for the poster wondering what the
timeout field was measured in:

from the ucd-snmp header file snmp_api.h:

    long    timeout;
    /* Number of uS until first timeout
    then exponential backoff */
up
0
jmartinson(AT_nospam)info234.com
13 years ago
A quick router device view:

<?
include "header.html";

$host = "auscr1";
$community = "tellme";
                    
$sysDescr = snmpget("$host","$community","system.sysDescr.0");
$ifDescr = snmpwalk("$host","$community","interfaces.ifTable.ifEntry.ifDescr");
$ifIndex = snmpwalk("$host","$community","interfaces.ifTable.ifEntry.ifIndex");
$ifAdminStatus = snmpwalk("$host","$community","interfaces.ifTable.ifEntry.ifAdminStatus");
$ifOperStatus = snmpwalk("$host","$community","interfaces.ifTable.ifEntry.ifOperStatus");
$ifLastChange = snmpwalk("$host","$community","interfaces.ifTable.ifEntry.ifLastChange");
                                         
print
"<table border=1 bgcolor=#ffffff><tr><td>$host</td></tr></table><br>";
print
"<table border=1 bgcolor=#ffffff><tr><td>$sysDescr</td></tr></table><br>";
print
"<table border=1 bgcolor=#ffffff>";
print
"<tr>
        <td>ifIndex</td>
        <td>ifDescr</td>
        <td>ifAdminStatus</td>
        <td>ifOperStatus</td>
        <td>ifLastChange</td>
        </tr>"
;
            
for (
$i=0; $i<count($ifIndex); $i++) {
        print
"<tr>";
        print
"<td>$ifIndex[$i]</td>";
        print
"<td>$ifDescr[$i]</td>";
        print
"<td>$ifAdminStatus[$i]</td>";
        print
"<td>$ifOperStatus[$i]</td>";
        print
"<td>$ifLastChange[$i]</td>";
        print
"</tr>";
}           
print
"</table>";

?>
To Top