agentxtrap - send an AgentX NotifyPDU to an AgentX master agent
agentxtrap [OPTIONS] trap-oid [OID TYPE VALUE...]
AGENTXTRAP(1) Net-SNMP AGENTXTRAP(1)
NAME
agentxtrap - send an AgentX NotifyPDU to an AgentX master agent
SYNOPSIS
agentxtrap [OPTIONS] trap-oid [OID TYPE VALUE...]
DESCRIPTION
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 variables(5).
OPTIONS
-c contextName
if the -c option is present then the notification is sent in the
nondefault name context.
-U uptime
if the -U option is present then that value, parsed as centisec-
onds, is taken to be the sysUpTime field of the application.
-x ADDRESS
if the -x option is present then contact the AgentX master at
ADDRESS and not the default one.
Additionally all the options described in snmpcmd(1) under the MIB
PARSING OPTIONS, LOGGING OPTIONS and INPUT OPTIONS headers as well as
the -d, -D, -m and -M options are supported.
In OID TYPE VALUE the parsing of the VALUE field is controlled by the
TYPE field. The possible values for the TYPE field is one of the fol-
lowing characters:
= Let OID decide how VALUE should be interpreted
i INTEGER
u Unsigned
c Counter32
s OCTET STRING of chaacters
x OCTET STRING, entered as a sequence of optionally space sepa-
rated hexadecimal digit pairs
d OCTET STRING, entered as a sequence of space separated deci-
mal digits in the range 0 - 255
n NULL
o OBJECT IDENTIFIER
t TimeTicks
a IpAddress
b BITS
which are handled in the same way as the snmpset command.
EXAMPLES
To send a generic linkUp trap to the manager for interface 1 the fol-
lowing command can be used:
agentxtrap netSnmp.0.3 ifindex.1 i 1
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+---------------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+---------------------------------+
|Availability | system/management/snmp/net-snmp |
+---------------+---------------------------------+
|Stability | Volatile |
+---------------+---------------------------------+
SEE ALSO
snmpcmd(1), snmpset(1), variables(5), RFC 2741
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://sourceforge.net/projects/net-
snmp/files/net-snmp/5.8/net-snmp-5.8.tar.gz.
Further information about this software can be found on the open source
community website at http://www.net-snmp.org/.
V5.8 20 Dec 2009 AGENTXTRAP(1)