unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



snmp_trapsnd(8)						      snmp_trapsnd(8)



NAME

  snmp_trapsnd - A program that	sends SNMPv1 and SNMPv2	traps

SYNOPSIS

  /usr/sbin/snmp_trapsnd enterprise agent_addr generic specific	timeticks [-v
  version] [-c community] [-h host] [-p	port] [-tcp] [variable [type value]]

OPTIONS

  -v version
      Specifies	the type of message in which to	send the PDU. The default
      version is SNMPv1.  Use 2c to specify that the PDU be sent in an
      SNMPv2C message.

  -h host
      Specifies	the host name or dot-formatted IP address of the destination
      node to receive the trap message.	 If no host is specified, the trap is
      sent to the loopback interface.

  -d  Causes a hexadecimal dump	of the encoded packet to be sent to stdout.

  -tcp
      Specifies	that the TCP transport be used instead of the UDP transport.
      If a connection cannot be	established, the program silently sends	the
      trap to the standard transport address (UDP 162).

  -p port
      Specifies	the port number	on the destination host	to which this message
      is sent.	The default is 162, the	well-known SNMP	trap port.

  -c community
      Specifies	the community string used to send the trap.  The default is
      public.

OPERANDS

  enterprise
      For SNMPv1 traps,	this is	the enterprise object identifier, in dot
      string notation, on whose	behalf the trap	is being sent (for example,
      1.3.6.1.4.1.232).

      For SNMPv2 traps (specified with the -v 2c option), this represents the
      value of snmpTrapOID.0.  For an SNMPv2 enterprise-specific trap, this
      is typically a concatenated string containing the	enterprise OID,	0
      (zero), and a single digit.  See the generic parameter table.

  agent_addr
      The hostname or IP address of the	entity on whose	behalf the trap	is
      being generated (the agent-addr field in the V1 trap PDU).  The special
      name local reports the host on which this	program	is running.  This
      value is ignored if the -v 2c option is present.

  generic
      The generic trap identifier.  This is a non-zero number.	The following
      table summarizes the trap	IDs:



      ______________________________________________________________________
      Description

			      V1 generic Value

						  V2 enterprise	Value
      ______________________________________________________________________
      coldStart		      0			  1.3.6.1.6.3.1.1.5.1
      warmStart		      1			  1.3.6.1.6.3.1.1.5.2
      linkDown		      2			  1.3.6.1.6.3.1.1.5.3
      linkUp		      3			  1.3.6.1.6.3.1.1.5.4
      authenticationFailure   4			  1.3.6.1.6.3.1.1.5.5
      egpNeighborLoss	      5			  1.3.6.1.6.3.1.1.5.6
      enterpriseSpecific      6			  enterprise.0.x
      ______________________________________________________________________

      If the -v	2c option is present, this parameter is	ignored.

  specific
      Specifies	the enterprise-specific	trap number.  A	value must be
      present, but is ignored if the -v	2c option is present or	if generic is
      a	value other than 6.

  timeticks
      Specifies	the relative time associated with the generation of this trap
      message.	This is	the number of TIMETICKS	(1/100 of a second) since the
      sending SNMP entity started.

  variable type	value
      Specifies	a list of MIB variables	to be included in the trap message.
      See snmp_request(8) for information on specifiying SNMP MIB variables
      on the command line.

DESCRIPTION

  The snmp_trapsnd program encodes an SNMPv1 Trap protocol data	unit (PDU)
  (see RFC 1215) or a SNMPv2 Trap PDU (see RFC 1905) into an SNMP message,
  and sends it to the specified	host(s).  All data fields in the trap PDU can
  be specified in the run-time arguments.

  SNMPv1 traps are uniquely identified by the combination of enterprise, gen-
  eric,	and specific operands.	SNMPv2 traps are uniquely identified by	the
  value	of snmpTrapOID.0 in the	enterprise operand.

RESTRICTIONS

  The use of this command should be limited.  SNMP traps should	be sent
  rarely, when significant state changes occur on a managed node.

SEE ALSO

  Commands: snmpd(8), snmp_request(8), snmp_traprcv(8)

  RFC 1907, Management Information Base	for Version 2 of the Simple Network
  Management Protocol (SNMPv2)