change required in man page for snmptrapd.conf

[Mohan Gorai]

Hi,

The current manpage of snmptrapd.conf doesn't have the right 
information. The current manpage has the following information.

 as  per  RFC  2576, before being passed to the program.  The
 input format is as follows, one entry per line:

  HOSTNAME
   The name of the host that sent  the  notification,
   as determined by gethostbyaddr(3).

  IPADDRESS
   The IP address of the host that sent the notifica-
   tion.
 VARBINDS
   A list of variable bindings  describing  the  con-
   tents  of  the  notification,  one  per line.  The


But the actual output is like below.

Host: hostname***  (UDP: [xx.xx.xx.xx]:xxx)
DISMAN-EVENT-MIB::sysUpTimeInstance  13:0:54:35.94
  SNMPv2-MIB::snmpTrapOID.0
SNMPv2-SMI::enterprises.42.9.0.99
 SNMPv2-SMI::enterprises.42.9.1  "TestTrap"
  SNMP-COMMUNITY-MIB::snmpTrapAddress.0  xx.xx.xx.xx
SNMP-COMMUNITY-MIB::snmpTrapCommunity.0  "public"
   SNMPv2-MIB::snmpTrapEnterprise.0 SNMPv2-SMI::enterprises.42.9


I have attached the patch which might be used to change the manpage 
information. Any Evaluators please?



Thanks!
-- Mohan.
--- a/man/snmptrapd.conf.5.def  2006-09-25 01:42:15.0 -0700
+++ b/man/snmptrapd.conf.5.def  2014-02-24 04:30:55.947050368 -0800
@@ -199,12 +199,11 @@
 program.
 The input format is as follows, one entry per line:
 .RS
-.IP HOSTNAME
-The name of the host that sent the notification, as determined by
-.IR gethostbyaddr(3) .
+.IP HOSTDETAILS
+The details of the host that sent the notification in the format :
+.IP
+Host : HOSTNAME (PROTOCOL: [IPADDRESS]:PORTNO)
 .br
-.IP IPADDRESS
-The IP address of the host that sent the notification.
 .\"
 .\" XXX - What about non-IPv4 transports?
 .\"
--
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech___
Net-snmp-coders mailing list
Net-snmp-coders@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders

Re: change required in man page for snmptrapd.conf

[Niels Baggesen]

Den 03-03-2014 06:30, Mohan Gorai skrev:
> But the actual output is like below.
>> Host: hostname***  (UDP: [xx.xx.xx.xx]:xxx)
>> DISMAN-EVENT-MIB::sysUpTimeInstance  13:0:54:35.94
>>   SNMPv2-MIB::snmpTrapOID.0
>> SNMPv2-SMI::enterprises.42.9.0.99
>>  SNMPv2-SMI::enterprises.42.9.1  "TestTrap"
>>   SNMP-COMMUNITY-MIB::snmpTrapAddress.0  xx.xx.xx.xx
>> SNMP-COMMUNITY-MIB::snmpTrapCommunity.0  "public"
>>SNMPv2-MIB::snmpTrapEnterprise.0 SNMPv2-SMI::enterprises.42.9

This is actually the contents of a mail sent by traptoemail. The data 
passed to traptoemail would have been

hostname***
UDP: [xx.xx.xx.xx]:xxx
DISMAN-EVENT-MIB::sysUpTimeInstance  13:0:54:35.94
SNMPv2-MIB::snmpTrapOID.0 SNMPv2-SMI::enterprises.42.9.0.99
et.c.

The format is configurable, using the "format execute string" config 
directive, the default being "format execute %B\n%b\n%V\n%v\n" (but if 
you change that, you should probably use something else than traptoemail 
to process it)

But there seems to need some docs for the format directive :-(

/Niels

-- 
Niels Baggesen - @home - Århus - Denmark - n...@users.sourceforge.net
The purpose of computing is insight, not numbers   ---   R W Hamming

--
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
___
Net-snmp-coders mailing list
Net-snmp-coders@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders