SNMPTRAP(1) Net-SNMP SNMPTRAP(1)

# [NAME](#NAME)

snmptrap, snmpinform - sends an SNMP notification to a manager

# [SYNOPSIS](#SYNOPSIS)

**snmptrap -v 1** \[COMMON OPTIONS] AGENT enterprise-oid agent generic-trap specific-trap uptime \[OID TYPE VALUE]...

**snmptrap -v \[2c|3]** \[COMMON OPTIONS] \[-Ci] AGENT uptime trap-oid \[OID TYPE VALUE]...

**snmpinform -v \[2c|3]** \[COMMON OPTIONS] AGENT uptime trap-oid \[OID TYPE VALUE]...

# [DESCRIPTION](#DESCRIPTION)

**snmptrap** is an SNMP application that uses the SNMP TRAP operation to send information to a network manager. 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).

When invoked as **snmpinform,** or when **-Ci** is added to the command line flags of snmptrap, it sends an INFORM-PDU, expecting a response from the trap receiver, retransmitting if required. Otherwise it sends an TRAP-PDU or TRAP2-PDU.

If any of the required version 1 parameters, *enterprise-oid*, *agent*, and *uptime* are specified as empty, it defaults to *1.3.6.1.4.1.3.1.1 (enterprises.cmu.1.1)*, *hostname*, and *host-uptime* respectively.

The *TYPE* is a single character, one of:

[**i**](#i)

INTEGER

[**u**](#u)

UNSIGNED

[**c**](#c)

COUNTER32

[**s**](#s)

STRING

[**x**](#x)

HEX STRING

[**d**](#d)

DECIMAL STRING

[**n**](#n)

NULLOBJ

[**o**](#o)

OBJID

[**t**](#t)

TIMETICKS

[**a**](#a)

IPADDRESS

[**b**](#b)

BITS

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

The *AGENT* argument is only embedded in SNMP TRAP PDUs but not in SNMP INFORM PDUs. If *AGENT* is not an empty string, it must be an IPv4 address. This limitation comes from RFC 1157, in which the agent address field is defined as follows:

agent-addr NetworkAddress, -- address of object generating trap

From RFC 1155:

NetworkAddress ::=  
CHOICE {  
internet IpAddress  
}  
\[ ... ]  
IpAddress ::=  
\[APPLICATION 0] -- in network-byte order  
IMPLICIT OCTET STRING ([SIZE (4)](/man/os/net-snmp/SIZE.4))

An example of how to use **snmptrap:**

snmptrap -v 1 -c public manager enterprises.spider test-hub 3 0 '' interfaces.iftable.ifentry.ifindex.1 i 1

will send a generic linkUp trap to manager, for interface 1.

# [OPTIONS](#OPTIONS)

**snmptrap** takes the common options described in the [*snmpcmd(1)*](/man/os/net-snmp/snmpcmd.1) manual page in addition to the **-Ci** option described above. Note that **snmptrap** REQUIRES an argument specifying the agent to query as described there.

# [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).

19 Jun 2003 V5.9.5.2

---

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