.TH AGENTXTRAP 1 "20 Dec 2009" VVERSIONINFO "Net-SNMP"

.SH NAME

agentxtrap - send an AgentX NotifyPDU to an AgentX master agent

.SH SYNOPSIS

.B agentxtrap

.RI [ OPTIONS ] " trap-oid " [ "OID TYPE VALUE" ...]

.SH DESCRIPTION

.B agentxtrap

issues an AgentX NotifyPDU to a master agent. One or more object

identifiers (OIDs) can be given as arguments on the command line.

A type and a value must accompany each object identifier.

Each variable name is given in the format specified in

.IR variables(5) .

.PP

.SH OPTIONS

.PD 0

.TP 6

.BI \-c "\| contextName\^"

if the

.B \-c

option is present then the notification is sent in the nondefault name context.

.TP

.BI \-U "\| uptime\^"

if the

.B \-U

option is present then that value, parsed as centiseconds, is taken to be the

sysUpTime field of the application.

.TP

.BI \-x "\| ADDRESS\^"

if the

.B \-x

option is present then contact the AgentX master at ADDRESS and not the default

one.

.PD

.PP

Additionally all the options described in

.IR snmpcmd(1)

under the

.BR "MIB PARSING OPTIONS" ", " "LOGGING OPTIONS" " and " "INPUT OPTIONS"

headers as well as the

.BR -d ", " -D ", " -m " and " -M

options are supported.

.PP

In

.I OID TYPE VALUE

the parsing of the

.I VALUE

field is controlled by the

.I TYPE

field. The possible values for the

.I TYPE

field is one of the following characters:

.RS

.PD 0

.TP 3

.B =

Let

.I OID

decide how

.I VALUE

should be interpreted

.TP

.B i

INTEGER

.TP

.B u

Unsigned

.TP

.B c

Counter32

.TP

.B s

OCTET STRING of chaacters

.TP

.B x

OCTET STRING, entered as a sequence of optionally space separated hexadecimal

digit pairs

.TP

.B d

OCTET STRING, entered as a sequence of space separated decimal digits in the

range 0 - 255

.TP

.B n

NULL

.TP

.B o

OBJECT IDENTIFIER

.TP

.B t

TimeTicks

.TP

.B a

IpAddress

.TP

.B b

BITS

.PD

.RE

which are handled in the same way as the

.B snmpset

command.

.PP

.SH EXAMPLES

To send a generic linkUp trap to the manager for interface 1 the following

command can be used:

.PP

agentxtrap netSnmp.0.3 ifindex.1 i 1

.PP

.SH SEE ALSO

snmpcmd(1), snmpset(1), variables(5), RFC 2741