Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / ucd-snmp / draft / man5 / snmptrapd.conf.5

.\"
.\" Japanese Version Copyright (c) 2002 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sat Feb 16 23:24:00 JST 2002
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\"
.TH SNMPTRAPD.CONF 5 "28 Aug 2001"
.ds )H U.C. Davis
.ds ]W V4.2.4
.UC 4
.\"O .SH NAME
.SH ̾Á°
.\"O /usr/share/snmp/snmptrapd.conf - configuration file for the ucd-snmp trap demon.
/usr/share/snmp/snmptrapd.conf - ucd-snmp trap ¥Ç¡¼¥â¥ó¤ÎÀßÄê¥Õ¥¡¥¤¥ë
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O .B snmptrapd.conf
.\"O is the configuration file(s) which define how the ucd-snmp SNMP trap
.\"O receiving demon operates when it receives a trap.  These files may
.\"O contain any of the directives found in the
.\"O .B DIRECTIVES
.\"O section below.  This file is not required for the demon to operate,
.\"O receive, or report traps.  It is used solely as a method of providing
.\"O extensibility to the trap demon.
.B snmptrapd.conf
¤Ï ucd-snmp SNMP trap ¤ò¼õ¿®¤¹¤ë¥Ç¡¼¥â¥ó¤¬
trap ¤ò¼õ¿®¤·¤¿ºÝ¤ÎÆ°ºî¤òÄêµÁ¤¹¤ëÀßÄê¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
¤³¤Î¥Õ¥¡¥¤¥ë¤Ë¤Ï¡¢°Ê²¼¤Î
.RB ¡Ö ¥Ç¥£¥ì¥¯¥Æ¥£¥Ö ¡×
¥»¥¯¥·¥ç¥ó¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥Æ¥£¥Ö¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
¤³¤Î¥Õ¥¡¥¤¥ë¤Ï¥Ç¡¼¥â¥ó¤¬ trap ¤òÁàºî¡¦¼õ¿®¡¦Êó¹ð¤¹¤ë¤¿¤á¤ËɬÍפÊÌõ¤Ç¤Ï¤Ê¤¤¡£
¤³¤Î¥Õ¥¡¥¤¥ë¤Ï trap ¥Ç¡¼¥â¥ó¤Ë³ÈÄ¥À­¤òÄ󶡤¹¤ë¤¿¤á¤Î¼êÃʤȤ·¤ÆÍѤ¤¤é¤ì¤ë¡£
.\"O .SH PLEASE READ FIRST
.SH ºÇ½é¤Ë¤ªÆɤߤ¯¤À¤µ¤¤
.\"O First, make sure you have read the snmp_config(5) manual page that
.\"O describes how the ucd-snmp configuration files operate, where they
.\"O are located and how they all work together.
ºÇ½é¤Ë¡¢snmp_config(5) ¤Î man ¥Ú¡¼¥¸¤òÆɤó¤Ç¤ª¤¯¤³¤È¡£
¤³¤Î man ¥Ú¡¼¥¸¤Ë¤Ï¡¢ucd-snmp ÀßÄê¥Õ¥¡¥¤¥ë¤Î½èÍý¤Î¤µ¤ìÊý¡¦
¥Õ¥¡¥¤¥ë¤Î¾ì½ê¡¦ÀßÄê¥Õ¥¡¥¤¥ë´Ö¤Î´ØÏ¢À­¤¬½ñ¤«¤ì¤Æ¤¤¤ë¡£
.\"O .SH DIRECTIVES
.SH ¥Ç¥£¥ì¥¯¥Æ¥£¥Ö
.IP "traphandle OID|default PROGRAM [ARGS ...]"
.\"O The
.\"O .I traphandle
.\"O configuration directive configures the snmptrapd program to launch an
.\"O external program any time it receives a trap matching the OID token.
.I traphandle
ÀßÄê¥Ç¥£¥ì¥¯¥Æ¥£¥Ö¤Ï¡¢OID ¥È¡¼¥¯¥ó¤Ë¥Þ¥Ã¥Á¤¹¤ë trap ¤ò¼õ¿®¤·¤¿¤È¤­¤Ë¡¢
snmptrapd ¤¬µ¯Æ°¤¹¤ë³°Éô¥×¥í¥°¥é¥à¤òÀßÄꤹ¤ë¡£
.\"O If the OID token is the word
.\"O .I default
.\"O then any trap not matching any other trap handler will call this
.\"O default one instead.
OID ¥È¡¼¥¯¥ó¤¬
.I default
¤Î¾ì¹ç¡¢Â¾¤Î¥È¥é¥Ã¥×¥Ï¥ó¥É¥é¤Ë¥Þ¥Ã¥Á¤·¤Ê¤¤ trap ¤Ï¡¢
¤³¤Î¥Ç¥Õ¥©¥ë¥È¤Î trap ¥Ï¥ó¥É¥é¤ò¸Æ¤Ó½Ð¤¹
(ÌõÃ𡧤½¤·¤Æ¤³¤Î¥Ç¥Õ¥©¥ë¥È¥Ï¥ó¥É¥é¤¬¡¢
¤³¤Î¥Ç¥£¥ì¥¯¥Æ¥£¥Ö¤Ë½ñ¤«¤ì¤¿¥×¥í¥°¥é¥à¤ò¸Æ¤Ó½Ð¤¹)¡£
.\"O The program is fed details about the trap to its standard input, in the
.\"O following format, one entry per line:
¥×¥í¥°¥é¥à¤Ï trap ¤Î¾ÜºÙ¤òɸ½àÆþÎϤ«¤é¼õ¤±¼è¤ë¡£
¥Õ¥©¡¼¥Þ¥Ã¥È¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤Ã¤Æ¤ª¤ê¡¢1 ¹Ô¤Ë¤Ä¤­ 1 ¥¨¥ó¥È¥ê¤Ç¤¢¤ë¡£
.RS
.IP HOSTNAME
.\"O The name of the host in question that sent the trap, as determined by
.\"O gethostbyaddr().
trap ¤òÁ÷¤Ã¤Æ¤­¤¿³ºÅö¥Û¥¹¥È¤Î̾Á°¡£
¥Û¥¹¥È̾¤Ï gethostbyaddr() ¤Ç·èÄꤵ¤ì¤¿¤â¤Î¤Ç¤¢¤ë¡£
.br
.IP IPADDRESS
.\"O The IP address of the host that sent the trap.
trap ¤òÁ÷¤Ã¤Æ¤­¤¿¥Û¥¹¥È¤Î IP ¥¢¥É¥ì¥¹¡£
.br
.IP VARBINDS
.\"O A list of variable bindings that describe the trap and the variables
.\"O enclosed in it.  The first token on the line, up until the space, in
.\"O the OID and the remainder of the line is its value.  
.\"Osato: 
.\"Osato: enclose ¤ÎÎɤ¤Ìõ¤¬»×¤¤É⤫¤Ð¤Ê¤¤¡£
.\"Osato:  
¥È¥é¥Ã¥×¤È¤½¤ÎÊÑ¿ô¤Îµ­½Ò¤ò´Þ¤à variable bindings ¤Î¥ê¥¹¥È¡£
¶õÇò¤Þ¤Ç¤Î¹Ô¤ÎºÇ½é¤Î¥È¡¼¥¯¥ó¤Ï OID ¤Ç¡¢
¹Ô¤Î»Ä¤ê¤ÎÉôʬ¤Ï¤½¤ÎÃͤǤ¢¤ë¡£
.\"O The first OID
.\"O should be the system.sysUpTime.0 OID, and the second should be
.\"O the ...snmpTrap.snmpTrapOID.0 OID.  
1 ÈÖÌܤΠOID ¤Ï system.sysUpTime.0¡¢
2 ÈÖÌܤΠOID ¤Ï ...snmpTrap.snmpTrapOID.0 ¤Ë¤¹¤Ù¤­¤Ç¤¢¤ë¡£
.\"O The remainder of the OIDs, with the
.\"O possible exception of the last one, are the variable bindings
.\"O contained within the trap.  
.\"Osato: 
.\"Osato: possible ¤ò¤É¤¦Ìõ¤»¤ÐÎɤ¤¤Î¤«¡©
.\"Osato:  
OID ¤Î»Ä¤ê¤Ï trap ¤Ë´Þ¤Þ¤ì¤ë variable bindings ¤Ç¤¢¤ë
(¤¿¤À¤·ºÇ¸å¤Î OID ¤Ï¤³¤Î¸Â¤ê¤Ç¤Ê¤¤¤«¤â¤·¤ì¤Ê¤¤)¡£
.\"O For SNMPv1 traps, the very last OID will
.\"O be the ...snmpTrap.snmpTrapEnterprise OID and its value.  
SNMPv1 trap ¤Ç¤Ï¡¢°ìÈֺǸå¤Î OID ¤Ï
\&...snmpTrap.snmpTrapEnterprise ¤È¤½¤ÎÃͤǤ¢¤ë¡£
.\"O Essentially, 
.\"O SNMPv1 traps have been converted to the SNMPv2 trap PDU type by the
.\"O method described in the SNMPv1/SNMPv2 coexistence document, for which
.\"O I forget the appropriate RFC number.
´ðËÜŪ¤Ë SNMPv1 trap ¤Ï¡¢
SNMPv1 ¤È SNMPv2 ¤Î¶¦Â¸¤Î¤¿¤á¤Î¥É¥­¥å¥á¥ó¥È¤Ë½ñ¤«¤ì¤Æ¤¤¤ëÊýË¡¤Ç¡¢
SNMPv2 trap ¤Î PDU ¥¿¥¤¥×¤ËÊÑ´¹¤µ¤ì¤Æ¤¤¤ë¡£
¤·¤«¤· RFC ¤ÎÈÖ¹æ¤ò˺¤ì¤Æ¤·¤Þ¤Ã¤¿¡£
.RE
.IP "createUser username (MD5|SHA) authpassphrase [DES]"
.\"O See the snmpd.conf manual page for a description of how to create
.\"O SNMPv3 users.  It's roughly the same, but the file name changes to
.\"O snmptrapd.conf from snmpd.conf. 
SNMPv3 ¥æ¡¼¥¶¡¼¤ÎºîÀ®¤Ë¤Ä¤¤¤Æ¤ÎÀâÌÀ¤Ï¡¢
snmpd.conf ¤Î man ¥Ú¡¼¥¸¤ò»²¾È¤¹¤ë¤³¤È¡£
ÂçÂÎƱ¤¸¤Ç¤¢¤ë¤¬¡¢¥Õ¥¡¥¤¥ë̾¤ò snmpd.conf ¤«¤é
snmptrapd.conf ¤ËÆɤßÊѤ¨¤ë¤³¤È¡£
.RE
.IP "format1 format"
.\"O The format used to print a SNMPv1 TRAP message. See
.\"O .IR snmptrapd (8)
.\"O for the layout characters available.
SNMPv1 TRAP ¥á¥Ã¥»¡¼¥¸¤òɽ¼¨¤¹¤ë¤È¤­¤Ë»È¤¦¥Õ¥©¡¼¥Þ¥Ã¥È¡£
»ÈÍѲÄǽ¤Ê¥ì¥¤¥¢¥¦¥Èʸ»ú¤Ï
.IR snmptrapd (8)
¤ò»²¾È¤¹¤ë¤³¤È¡£
.RE
.IP "format2 format"
.\"O The format used to print a SNMPv2 TRAP2 or INFORM message (note that
.\"O the SNMPv3 protocol uses SNMPv2 style TRAPs and INFORMs).
SNMPv2 TRAP2 ¥á¥Ã¥»¡¼¥¸¤È SNMPv2 INFORM ¥á¥Ã¥»¡¼¥¸¤ò
ɽ¼¨¤¹¤ë¤È¤­¤Ë»È¤¦¥Õ¥©¡¼¥Þ¥Ã¥È
(SNMPv3 ¤Ï SNMPv2 ·Á¼°¤Î TRAP ¤È INFORM ¤ò»È¤Ã¤Æ¤¤¤ëÅÀ¤ËÃí°Õ)¡£
.\"O .SH NOTES
.SH Ãí°Õ
.IP o
.\"O The demon blocks on the executing traphandle commands.  (This should
.\"O be fixed in the future with an appropriate signal catch and wait()
.\"O combination).
¤³¤Î¥Ç¡¼¥â¥ó¤Ï traphandle ¥³¥Þ¥ó¥É¤ò¼Â¹Ô¤¹¤ë¤È¥Ö¥í¥Ã¥¯¤·¤Æ¤·¤Þ¤¦
(ŬÀڤʥ·¥°¥Ê¥ë¤Î¥­¥ã¥Ã¥Á¤È wait() ¤ÎÁȹ礻¤Ë¤è¤ê¡¢
¾­Í轤Àµ¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤)¡£
.\"O .SH "SEE ALSO"
.SH ´ØÏ¢¹àÌÜ
snmp_config(5), snmptrapd(8), syslog(8), variables(5), read_config(3).