AGENTXTRAP(1) Net-SNMP AGENTXTRAP(1)

# [NAME](#NAME)

agentxtrap - send an AgentX NotifyPDU to an AgentX master agent

# [SYNOPSIS](#SYNOPSIS)

**agentxtrap** \[*OPTIONS*] *trap-oid* \[*OID TYPE VALUE*...]

# [DESCRIPTION](#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)*](/man/os/net-snmp/variables.5).

# [OPTIONS](#OPTIONS)

[**-c contextName**](#c)

if the **-c** option is present then the notification is sent in the nondefault name context.

[**-U uptime**](#U)

if the **-U** option is present then that value, parsed as centiseconds, is taken to be the sysUpTime field of the application.

[**-x ADDRESS**](#x)

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)*](/man/os/net-snmp/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 following characters:

**=**

Let *OID* decide how *VALUE* should be interpreted

[**i**](#i)

INTEGER

[**u**](#u)

Unsigned

[**c**](#c~2)

Counter32

[**s**](#s)

OCTET STRING of characters

[**x**](#x~2)

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

[**d**](#d)

OCTET STRING, entered as a sequence of space-separated decimal digits in the range 0 - 255

[**n**](#n)

NULL

[**o**](#o)

OBJECT IDENTIFIER

[**t**](#t)

TimeTicks

[**a**](#a)

IpAddress

[**b**](#b)

BITS

which are handled in the same way as the **snmpset** command.

# [EXAMPLES](#EXAMPLES)

To send a generic linkUp trap to the manager for interface 1 the following command can be used:

agentxtrap netSnmp.0.3 ifindex.1 i 1

# [SEE ALSO](#SEE_ALSO)

[snmpcmd(1)](/man/os/net-snmp/snmpcmd.1), [snmpset(1)](/man/os/net-snmp/snmpset.1), [variables(5)](/man/os/net-snmp/variables.5), RFC 2741

20 Dec 2009 V5.9.5.2

---

Document: agentxtrap(1) from net-snmp 5.9.5.2-r9 (Chainguard OS)
Source: https://github.com/net-snmp/net-snmp.git