PHP: snmpset - Manual

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.

snmpset

slawrance at technologist dot 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"