SNMPSET

Section: User Commands (1)
Updated: 13 July 1994
Index Return to Main Contents

NAME

snmpset - communicates with a network entity using SNMP SET Requests.

SYNOPSIS

snmpset -v 1 hostname community objectID type value [objectID type value]...

snmpset [-v 2] hostname noAuth objectID type value [objectID type value]...

snmpset [-v 2] hostname srcParty dstParty objectID type value [objectID type value]...

DESCRIPTION

Snmpset is an SNMP application that uses the SET Request to set information on a network entity. One or more fully qualified object identifiers must be given as arguments on the command line. A type and a value to set must accompany each object identifier. Each variable name is given in the format specified in variables(5).

The hostname specification may be either a host name or an internet address specified in "dot notation".

The version 1 community specifies the community name for the transaction with the remote system.

The version 2 srcParty and dstParty specify the party names for the transaction with the remote system, as they are defined in /etc/party.conf. To forgo authentication, use the noAuth keyword instead of specifying party names.

The type is a single character, one of:

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

For example

snmpset test-hub zeusMS zeusAgent system.sysContact.0 s dpz@noc.rutgers.edu ip.ipforwarding.0 i 2

will set the variables sysContact.0 and ipforwarding.0:

system.sysContact.0 = "dpz@noc.rutgers.edu"
ip.ipForwarding.0 = not-forwarding(2)

If the network entity has an error processing the request packet, an error packet will be returned and a message will be shown, helping to pinpoint in what way the request was malformed. If there were other variables in the request, the request will be resent without the bad variable.

Adding a "-d" to the argument list will cause the application to dump input and output packets.

Adding a "-q" to the argument list will cause the application to use a quicker, less verbose output form.

BUGS

Option -q is not avail for Linux - sorry (maybe i'll add it - schoenfr).