★ wanayoo — archive 1999 http://www.php.net/manual/function.snmpset.phpNouvelle recherche | Portail wanayoo

PHP Home Page
Manual Table of Contents
Up to SNMP
Quick Reference
German version of this pageJapanese version of this pageItalian version of this pageFrench version of this pageHungarian version of this page
SNMP
* snmpget
* snmpset
* snmpwalk
* snmpwalkoid
* snmp_get_quick_print
* snmp_set_quick_print
Manual: snmpset
 View the source code for this pageSearch the site



Previous page
  snmpget
  Updated
Sat, 12 Aug 2000
 snmpwalk 
 Next page

snmpset

(PHP3 >= 3.0.12, PHP4 >= 4.0b2)

snmpset -- Set an SNMP object

Description

bool snmpset (string hostname, string community, string object_id, string type, mixed value [, int timeout [, int retries]])

Sets the specified SNMP object value, returning true on success and false on error.

The snmpset() function is used to set the value of an SNMP object specified by the object_id. SNMP agent is specified by the hostname and the read community is specified by the community parameter.


 User Contributed Notes: snmpset

slawrance@technologist.com
21-Jul-1999 12:01
The "type" parameter must be one of the following, depending on the type of
variable to set on the SNMP host:

i INTEGER
u unsigned INTEGER
t TIMETICKS
a IPADDRESS
o OBJID
s STRING
x HEX STRING
d DECIMAL STRING

If OPAQUE_SPECIAL_TYPES was defined while compiling the SNMP library, the
following are also valid:

U unsigned int64
I signed int64
F float
D double

As an example, using "i" would set an integer, and "s" would set a string. If the SNMP host rejects the data type, you might get the following message: "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length."

If you specify an unknown or invalid OID, you might get a "Could not add variable" message. When specifying an absolute OID (one that is already resolved) that is completely numeric, prepend it with a period. For example, an OID that could enable/disable Ethernet ports on an Asante hub might be "1.3.6.1.2.1.22.1.3.1.1.3.6.4.0", but you would need to use ".1.3.6.1.2.1.22.1.3.1.1.3.6.4.0" in the OID parameter so that the SNMP library won't try to resolve an already resolved OID. Friendly, unresolved OIDs do not need the period prepended, such as "system.SysContact.0"



 About Notes

Previous page
  snmpget
  Updated
Sat, 12 Aug 2000
 snmpwalk 
 Next page




Who's responsible for this?
Top of this page
Site
Hosting:

Located in
United States
Elements of this website are subject to copyright.
Questions about installing or using PHP should be directed to one of the mailing lists.
Only questions about the website should be directed to webmaster@php.net.