PHP: snmpget - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

snmpgetnext snmp_set_valueretrieval

Last updated: Sat, 27 Jan 2007

view this page in

# snmpget

(PHP 3, PHP 4, PHP 5)

snmpget -- Fetch an SNMP object

## Описание

string snmpget ( string hostname, string community, string object_id [, int timeout [, int retries]] )

The snmpget() function is used to read the value of an SNMP object specified by the `object_id`.

## Список параметров

`hostname`

  The SNMP agent.

`community`

  The read community.

`object_id`

  The SNMP object.

`timeout`

`retries`

## Возвращаемые значения

Returns SNMP object value on success or `FALSE` on error.

## Примеры

Пример 1. Using snmpget()

`<?php $syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0"); ?>`

## Смотрите также

snmpset()

add a note User Contributed Notes
snmpget
tridman
21-Nov-2006 02:48
`The timeout is in micro seconds. Thus 1.000.000 means 1 Second.`
michael dot mauch at gmx dot de
10-Nov-2006 09:07
`I have no idea what the timeout value is, but 1 second is really really 1 000 000 000 nano seconds (cf. http://en.wikipedia.org/wiki/SI_prefix).`
fbleau
11-Jul-2006 11:15
`The default value of Timeout is 1000000 nanoseconde (1 sec) and the retrie is 5 thsi value is set by Net-SNMP library.
#!/usr/local/bin/php
<?php
$time_start = microtime(true);
$reponse = snmpget('10.5.1.1', 'public', "1.3.6.1.2.1.1.3.0",1000000,5);
$time_end = microtime(true);
$time = $time_end - $time_start;
echo "Delay in $time secondes\n";
?>`
Jim
14-May-2006 07:52
`Unfortunately, It appears that you can not put multiple objects into the snmpget function, ie: sysUpTime.0 ifInOctets.1 ifOutOctets.1. For what it's worth, the time argument is in nano-seconds as previously mentioned. There is a lot of conflicting information out there about this.`
bbonev at php dot net
27-Feb-2006 07:14
`about timeouts it turns out to be in nanoseconds e.g. for 1 second use value of 1 000 000`
dstjohn-NO-SPAM at mediacast1 dot com
11-Sep-2005 02:16
`2 year tidbit update :)
<?php
// author: dstjohn at mediacast1.com
// updated: 09-11-2005
// set some vars
$snmpcommunity = 'PUBLIC'; //snmp community name
$ips = 'test1.com,test2.com'; //ips or dns to get snmp data from
$system_number = '1';
//end da vars
//start da loop d loop
for ($i = 0; $i <= $system_number; $i++) {
$sysip = explode(",",$ips);
//get system name
$sysname[0] = snmpget($sysip[$i], $snmpcommunity, "sysName.0");
$sysname[1] = eregi_replace("STRING:","",$sysname[0]);
echo 'System Name: '.$sysname[1].'<br>';
//system description
$sysdesc[0] = snmpget($sysip[$i], $snmpcommunity, "sysDescr.0");
$sysdesc[1] = eregi_replace("STRING:","",$sysdesc[0]);
echo 'System Description: '.$sysdesc[1].'<br>';
//system location
$sysloc[0] = snmpget($sysip[$i], $snmpcommunity, "sysLocation.0");
$sysloc[1] = eregi_replace("STRING:","",$sysloc[0]);
echo 'System Location: '.$sysloc[1].'<br>';
//current tcp connections
$tcpcons[0] = snmpget($sysip[$i], $snmpcommunity, "tcpCurrEstab.0");
$tcpcons[1] = eregi_replace("Gauge32:","",$tcpcons[0]);
echo 'Open TCP/IP Connections: '.$tcpcons[1].'<br>';
//get system uptime
$sysuptime[0] = snmpget($sysip[$i], $snmpcommunity, "system.sysUpTime.0");
$sysuptime[1] = eregi_replace("Timeticks:","",$sysuptime[0]);
echo 'System Uptime: Timeticks -'.$sysuptime[1].'<br>';
//windows only
//installed memory
if(eregi('Windows',$sysdesc[1])){
$mem[0] = snmpget($sysip[$i], $snmpcommunity, "HOST-RESOURCES-MIB::hrMemorySize.0");
$mem[1] = eregi_replace("INTEGER:","",$mem[0]);
$mem[2] = eregi_replace("KBytes","",$mem[1]);
echo 'Insalled Memory: '.$mem[2].' KiloBytes<br>';
}
echo '<br><br>';
}//end loop
?>`
cwevers at igeneration dot info
04-Jul-2005 03:22
`I think it's MILLIseconds.
1000 ms = 1 sec`
Johann Glaser
22-Feb-2004 12:39
`It seems that for each snmpget() its own socket() will be opened. This is not closed after snmpget() finishes. Neither existing sockets are reused by subsequent snmpget() calls.
When querying a few switches with lots of ports the maximum file descriptor count of Apache is exhausted. Thus no more snmpget() are possible. Additionaly no more files can be read by this particular Apache process. Neither the PHP file, any include files nor any other files (like a .css file, ...).
This probably explains the observation of tkjode at phalnet dot com. Different to his case is that I'm using Linux.`
dstjohn-NO-SPAM at mediacast1 dot com
22-Sep-2003 07:53
`Little tidbit for snmpget function
<?php
//snmpget system stats
$host = 'localhost';
$community = 'public';
//get system name
$sysname = snmpget($host, $community, "system.sysName.0");
//get system uptime
$sysup = snmpget($host, $community, "system.sysUpTime.0");
$sysupre = eregi_replace("([0-9]{3})","",$sysup);
$sysupre2 = eregi_replace("Timeticks:","",$sysupre);
$sysupre3 = eregi_replace("[()]","",$sysupre2);
//get tcp connections
$tcpcon = snmpget($host, $community,"tcp.tcpCurrEstab.0");
$tcpconre = eregi_replace("Gauge32:","",$tcpcon);
echo '
System Name: '.$sysname.'<br>
System Uptime: '.$sysupre3.'<br>
Current Tcp Connections: '.$tcpconre.'<br>';
?>`
javierb at gmx dot net
04-Jun-2003 08:08
`pooling a cisco.
$ip = '1.1.1.1';
$community ='publico';
$a = snmpget($ip,$community, "IF-MIB::ifLastChange.1")
$b = snmpget($ip,$community, "IF-MIB::ifAlias.1");
print("a = ".$a."\n"."b = ".$b."\n");
a = Timeticks: (929969969) 107 days, 15:14:59.69
b = Timeticks: (929969969) 107 days, 15:14:59.69
when the interface has not description.`
tkjode at phalnet dot com
12-Feb-2002 11:49
`It has been observed on NT/2000 systems that flooding devices with SNMP requests will cause NT's SNMP service to stop working.
For example, I polled 183 switches on our network just fine. I then attempted to simulate heavy traffic to that page by refreshing and breaking connections (as any real world system would have to go through). SNMP stopped working throughout the entire machine, including non-PHP/Webserver processes.`
grice at berbee dot com
24-Aug-2000 04:05
`It looks like you can use a non-standard port for SNMP
with something like this:
$foo = snmpwalk('foo.bar.com:1161', 'foofoo', '.1.3.6');
This is on PHP 3.16; I haven't managed to get PHP 4.02 to compile successfully on Solaris 2.6 yet.
--Michael`
add a note
snmpgetnext snmp_set_valueretrieval

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST