manual/ucd-snmp/draft/man8/snmptrapd.8

   1 .\" /***********************************************************
   2 .\"     Copyright 1989 by Carnegie Mellon University
   3 .\"
   4 .\"                       All Rights Reserved
   5 .\"
   6 .\" Permission to use, copy, modify, and distribute this software and its
   7 .\" documentation for any purpose and without fee is hereby granted,
   8 .\" provided that the above copyright notice appear in all copies and that
   9 .\" both that copyright notice and this permission notice appear in
  10 .\" supporting documentation, and that the name of CMU not be
  11 .\" used in advertising or publicity pertaining to distribution of the
  12 .\" software without specific, written prior permission.
  13 .\"
  14 .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  15 .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  16 .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  17 .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  18 .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  19 .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  20 .\" SOFTWARE.
  21 .\" ******************************************************************/
  22 .\"
  23 .\" Japanese Version Copyright (c) 2002 Yuichi SATO
  24 .\"         all rights reserved.
  25 .\" Translated Sat Feb 16 20:15:39 JST 2002
  26 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
  27 .\"
  28 .TH SNMPTRAPD 8 "07 Aug 2001"
  29 .UC 4
  30 .\"O .SH NAME
  31 .SH 名前
  32 .\"O snmptrapd - Receive and log snmp trap messages.
  33 snmptrapd - snmp trap メッセージを受信してログに記録する
  34 .\"O .SH SYNOPSIS
  35 .SH 書式
  36 snmptrapd [common options] [-P] [-o file] [-s] [-f] [-p port] [-e] [-l [d0-7]] [-a] [-C] [-c confFile] [-F FORMAT]
  37 .\"O .SH DESCRIPTION
  38 .SH 説明
  39 .\"O Snmptrapd
  40 .\"O is an SNMP application that receives and logs snmp trap messages
  41 .\"O sent to the SNMP-TRAP port (162) on the local machine.
  42 .I snmptrapd
  43 はローカルマシンの SNMP-TRAP ポート (162) に送られてきた
  44 snmp trap メッセージを受信してログに記録する SNMP アプリケーションである。
  45 .PP
  46 .\"O The log messages are of the form:
  47 ログメッセージは以下のような形式である:
  48 .br
  49 .I Sep 17 22:39:52 suffern snmptrapd: 128.2.13.41:
  50 .I Cold Start Trap (0) Uptime:
  51 .I 8 days, 0:35:46
  52 .PP
  53 .\"O .I Snmptrapd
  54 .\"O must be run as root so that UDP port 162 can be opened.
  55 .I snmptrapd
  56 は UDP ポート 162 をオープンするので、
  57 root で実行しなければならない。
  58 .\"O .SH COMMAND LINE ARGUMENTS
  59 .SH コマンドライン引き数
  60 .\"O In addition to the command arguments described under
  61 .\"O .IR snmpcmd (1)
  62 .\"O the following arguments are understood:
  63 .IR snmpcmd (1)
  64 で説明されているコマンドライン引き数に加え、以下の引き数が使用できる。
  65 .IP "-P"
  66 .\"O Print the logged messages to stderr.
  67 ログメッセージを標準エラーに表示する。
  68 .IP "-o file"
  69 .\"O Logs messages to a given file.
  70 指定したファイルにメッセージを記録する。
  71 .IP "-p port"
  72 .\"O Specifies the port to run on, if the default 162 is not desired.
  73 デフォルトの 162 番ポートで実行したくない場合に、
  74 実行させるポートを指定する。
  75 .IP "-s"
  76 .\"O Log the messages to syslog(8).  These syslog messages are sent with
  77 .\"O the level of LOG_WARNING, and to the LOG_LOCAL0 facility (by
  78 .\"O default).  The demon will also fork away from its caller when
  79 .\"O the syslog facilities are used.
  80 .\"O This is the default unless the '-P' flag or '-o' flag is used.
  81 メッセージを syslog(8) に記録する。
  82 syslog メッセージは、(デフォルトでは) level を LOG_WARNING、
  83 facility を LOG_LOCAL0 として送られる。
  84 syslog 機能を使うと、デーモンは fork されて
  85 呼び出し元から切り離される。
  86 これは '-P' フラグまたは  '-o' フラグを使わない場合のデフォルトである。
  87 .IP "-n"
  88 .\"O Don't do reverse translation from IP address to host name.
  89 IP アドレスからホスト名への逆変換を行わない。
  90 .IP "-l [d0-7]"
  91 .\"O Specifies the syslog facility to use, demon or local[0-7].
  92 使用する syslog facility を指定する。demon または local[0-7]。
  93 .IP "-a"
  94 .\"O makes
  95 .\"O .I snmptrapd
  96 .\"O ignore AuthenticationFailure traps
  97 .I snmptrapd
  98 に AuthenticationFailure trap を無視させる。
  99 .IP "-d"
 100 .\"O Causes the application to dump input and output packets.
 101 アプリケーションに入出力パケットをダンプさせる。
 102 .IP "-D"
 103 .\"O Turn debugging output on.
 104 デバッグ出力を有効にする。
 105 .IP "-f"
 106 .\"O Don't fork away from the caller when using syslog().
 107 syslog() を使用する場合に、
 108 fork による呼び出し元から切り離しを行わない。
 109 .IP "-C"
 110 .\"O Don't read the default set of configuration files.
 111 デフォルトの設定ファイルのセットを読み込ませない。
 112 .IP "-c confFile"
 113 .\"O Force the reading of confFile as a configuration file.
 114 confFile を設定ファイルとして読み込ませる。
 115 .IP "-F FORMAT"
 116 .\"O When logging to standard output, use the format in the string FORMAT.
 117 標準出力にログを記録するときに、フォーマットとして文字列 FORMAT を使う。
 118 .PP
 119 .\"O FORMAT is a printf-like string.
 120 .\"O .I Snmptrapd
 121 .\"O interprets the following formatting sequences:
 122 FORMAT は printf で使われる文字列に似ている。
 123 .I snmptrapd
 124 は以下のフォーマット文字列を解釈する:
 125 .TP
 126 %%
 127 .\"O a literal %
 128 % という文字
 129 .TP
 130 %t
 131 .\"O decimal number of seconds since the operating system's epoch
 132 OS の紀元 (epoch) からの 10 進数での秒数
 133 .TP
 134 %y
 135 .\"O current year
 136 現在の年
 137 .TP
 138 %m
 139 .\"O current (numeric) month
 140 現在の月 (数値)
 141 .TP
 142 %l
 143 .\"O current day of month
 144 現在の月内日
 145 .TP
 146 %h
 147 .\"O current hour
 148 現在の時
 149 .TP
 150 %j
 151 .\"O current minute
 152 現在の分
 153 .TP
 154 %k
 155 .\"O current second
 156 現在の秒
 157 .TP
 158 %T
 159 .\"O up-time in seconds (in decimal)
 160 稼働時間 (up-time) (10 進数での秒数)
 161 .TP
 162 %Y
 163 .\"O the year field from the up-time
 164 稼働時間の「年」のフィールド。
 165 .TP
 166 %M
 167 .\"O the numeric month field from the up-time
 168 稼働時間の「月 (数値)」のフィールド。
 169 .TP
 170 %L
 171 .\"O the day of month field from the up-time
 172 稼働時間の「月内日」のフィールド。
 173 .TP
 174 %H
 175 .\"O the hour field from the up-time
 176 稼働時間の「時」のフィールド。
 177 .TP
 178 %J
 179 .\"O the minute field from the up-time
 180 稼働時間の「分」のフィールド。
 181 .TP
 182 %K
 183 .\"O the seconds field from the up-time
 184 稼働時間の「秒」のフィールド。
 185 .TP
 186 %A
 187 .\"O agent's hostname if available, otherwise IP address
 188 取得可能な場合はエージェントのホスト名。
 189 取得不可能な場合はエージェントの IP アドレス。
 190 .TP
 191 %a
 192 .\"O agent's IP address
 193 エージェントの IP アドレス。
 194 .TP
 195 %B
 196 .\"O PDU's hostname if available, otherwise IP address
 197 取得可能な場合は PDU のホスト名。
 198 取得不可能な場合は PDU の IP アドレス。
 199 .TP
 200 %b
 201 .\"O PDU's IP address
 202 PDU の IP アドレス。
 203 .TP
 204 %N
 205 .\"O Enterprise string
 206 enterprise 文字列。
 207 .TP
 208 %w
 209 .\"O Trap type (numeric, in decimal)
 210 trap タイプ (10 進数)
 211 .TP
 212 %W
 213 .\"O Trap description
 214 trap の説明
 215 .TP
 216 %q
 217 .\"O Trap sub-type (numeric, in decimal)
 218 trap サブタイプ (10 進数)
 219 .TP
 220 %P
 221 .\"O Security information from the PDU (community name for v1/v2c,
 222 .\"O user and context for v3)
 223 PDU のセキュリティ情報
 224 (v1/v2c におけるコミュニティ名、v3 におけるユーザーとコンテキスト)
 225 .TP
 226 %v
 227 .\"O list of trap's variables
 228 trap 変数のリスト
 229 .PP
 230 .\"O In addition to these values, you may also specify an optional field
 231 .\"O width and precision, just as in printf, and a flag value. The
 232 .\"O following flags are legal:
 233 これらの値に加え、フィールドの幅と精度 (printf と同じ) および
 234 フラグ値などをオプションとして指定することもできる。
 235 以下のフラグを指定することができる:
 236 .TP
 237 -
 238 .\"O left justify
 239 左寄せ
 240 .TP
 241 0
 242 .\"O use leading zeros
 243 先頭を 0 で埋める
 244 .TP
 245 #
 246 .\"O use alternate form
 247 別形式を使用する
 248 .PP
 249 .\"O The "use alternate form" flag changes the behavior of some format
 250 .\"O flags. Normally, the fields that display time information base it
 251 .\"O on the local time, but this flag tells them to use GMT instead.
 252 「別形式を使用する」ためのフラグを指定すると、
 253 いくつかのフォーマットフラグは動作が変更される。
 254 通常、時間情報のフィールドはローカル時刻に基づいて表示されるが、
 255 このフラグを使うと GMT を使うようになる。
 256 .\"O Also, the variable list is normally a tab-separated list, but this
 257 .\"O flag changes it to a comma-separated one. The alternate form for the
 258 .\"O uptime is similar to "3 days, 0:14:34.65"
 259 また通常、変数リストはタブで区切られるが、
 260 このフラグを使うとコンマ区切りのリストになる。
 261 稼働時間の別形式は、元と同じで "3 days, 0:14:34.65" のような形式である。
 262 .PP
 263 .\"O Examples:
 264 例:
 265 .PP
 266 .\"O To get a message like "14:03 TRAP3.1 from humpty.ucd.edu" you
 267 .\"O could use something like this:
 268 "14:03 TRAP3.1 from humpty.ucd.edu" のような形式のメッセージにするためには、
 269 以下のようにすればよい:
 270 .PP
 271 .RS
 272 .NF
 273 snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A\en"
 274 .FI
 275 .RE
 276 .PP
 277 .\"O If you want the same thing but in GMT rather than local time, use
 278 上と同じであるが、ローカル時刻ではなく GMT を使いたい場合は、
 279 以下のようにすればよい:
 280 .PP
 281 .RS
 282 .NF
 283 snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\en"
 284 .FI
 285 .RE
 286 .PP
 287 .\"O .SH EXTENSIBILITY AND CONFIGURATION
 288 .SH 拡張性と設定
 289 .\"O See the snmptrapd.conf(5) manual page.
 290 snmptrapd.conf(5) の man ページを参照すること。
 291 .PP
 292 .\"O .SH "SEE ALSO"
 293 .SH 関連項目
 294 snmpcmd(1), syslog(8), variables(5)