snmpinform, snmptrap

sends an SNMP notification to a manager 

Command

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

The snmptrap utility 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 snmp_variables.

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 

INTEGER

u 

UNSIGNED

c 

COUNTER32

s 

STRING

x 

HEX STRING

d 

DECIMAL STRING

n 

NULLOBJ

o 

OBJID

t 

TIMETICKS

a 

IPADDRESS

b 

BITS

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

For example: 

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

snmptrap takes the common options described in the snmpcmd reference page in addition to the -Ci option described above. Note that snmptrap REQUIRES an argument specifying the agent to query as described there.

PORTABILITY

All UNIX systems. Windows 10. Windows Server 2016. Windows Server 2019. Windows 11. Windows Server 2022. Windows Server 2025.

AVAILABILITY

PTC MKS Toolkit for System Administrators
PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Commands:
snmpset

Miscellaneous:
snmp_variables, snmpcmd

PTC MKS Toolkit 10.5 Documentation Build 40.