Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

snmptrap (1)

Name

snmptrap - sends an SNMP notification to a manager

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

SNMPTRAP(1)                        Net-SNMP                        SNMPTRAP(1)



NAME
       snmptrap, snmpinform - sends an SNMP notification to a manager

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

       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 (enter-
       prises.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(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.


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



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                              19 Jun 2003                      SNMPTRAP(1)