`snmpset`

Communicate with a network entity using SNMP SET requests

Syntax:

snmpset [-d] [-p port] [-r retry] [-t timeout] -v 1 
        host community variable_name type value
        [variable_name type value]

snmpset [-d] [-p port] [-r retry] [-t timeout] [-v 2]
        host noAuth variable_name type value
        [variable_name type value]

snmpset [-d] [-p port] [-r retry] [-t timeout] [-v 2]
        host scrparty dstparty context variable_name type value
        [variable_name type value]

Options:

-d

Dump input and output packets.

-p port

Specify the destination port number.

-r retry

Specify the number of retries.

-t timeout

Specify timeout (in seconds).

-v 1|2

SNMP version (default is 2).

community

The community name for the transaction with the remote system.

context

The collection of object resources that can be set by the dstparty.

dstparty

The name of the party performing the action.

host

An Internet address specified in dot notation or a hostname.

srcparty

The name of the party requesting an action.

type

The data type where type is one of the following:

a: IPADDRESS
d: DECIMAL STRING
i: INTEGER
n: NULLOBJ
o: OBJID
s: STRING
t: TIMETICKS
x: HEX STRING

value

The data value.

variable_name

The variable name in the format specified in the file mib.txt.

Description:

The snmpset utility uses the SET request to set information about a network entity. You can specify one or more fully qualified object identifiers in the format specified in the file mib.txt.

If you're using SNMP version 2, the following files must be configured:

/etc/acl.conf
/etc/context.conf
/etc/party.conf
/etc/snmpd.conf (required only if you change the default location of your config files)

For a description on how to configure the files please see the file page for each of the configuration files listed above. If you wish to change the location of your configuration files, you must include a snmpd.conf file.

Examples:

Set the variable sysContact.0 to "John Doe":

Using SNMPv1

snmpset -v 1 netdev-kbox.cc.cmu.edu public system.sysContact.0 s "John Doe"

Using SNMPv2

snmpset netdev-kbox.cc.cmu.edu manager_party agent_party agent_context
  system.sysContact.0 s "John Doe"

The output is similar to:

system.sysContact.0 = "John Doe"

Environment variables:

MIBFILE

Specify the location of the mib.txt file. For example, MIBFILE=path/mib.txt (the default path is /etc).

SUFFIX

If SUFFIX exists in your environment, all object IDs with a symbolic name are printed with only the last element. Examples:

This ID:

system.syscontact.0

is printed as:

syscontact.0

This ID:

udp.udpTable.udpEntry.udpLocalAddress.0.0.0.161

is printed as:

udpLocalAddress.0.0.0.161

Errors:

If the network entity has an error processing the request packet, an error packet is returned and snmpset displays a message to help pinpoint how the request was malformed.