rsyslogd(8)
DESCRIPTION
Rsyslogd is a system utility providing support for message logging.
Rsyslogd は、message loggingを提供するsystemのutilityです。
Support of both internet and unix domain sockets enables this utility to support both local and remote logging.
Note that this version of rsyslog ships with extensive documentation in HTML format.
HTML形式のより詳細なドキュメントが存在しますので、そちらもご参照ください。
一部省略
Rsyslogd(8) is derived from the sysklogd package which in turn is derived from the stock BSD source. RsyslogdはBSDのソースコードに含まれる、sysklogd packageから派生しています。 Rsyslogd provides a kind of logging that many modern programs use.
Rsyslogdは現在主流のプログラムが利用する様々な種類のロギング機能を提供しています。
Every logged message contains at least a time and hostname field, normally a program name field, too, but that depends on how trusty the logging program is.
すべてのログメッセージには、最低でもロギング時刻とhostnameのフィールドが存在します。通常はそれに加えてプログラム名のフィールドも存在しますが、ロギングを実行するプログラムによっては存在しなかったりします。
The rsyslog package supports free definition of output formats via templates.
rsyslogでは、templateによって出力形式を自由に設定することができます。
It also supports precise timestamps and writing directly to databases.
ミリセカンド単位でタイムスタンプを記録することや、データベースに直接ログを出力したりすることができるようになります。
一部略
While the rsyslogd sources have been heavily modified a couple of notes are in order.
rsyslogd のソースコードは大きく変更されていますが、その中でもいくつか説明したい点があります。
First of all there has been a systematic attempt to ensure that rsyslogd follows its default, standard BSD behavior.
ひとつめは、rsyslogdはそのふるまいを、標準的なBSDと同様のものにしようとしているということです。
However, rsyslogd should be able to use a standard syslog.conf and act like the original syslogd.
そのため、rsyslogdは標準的なsyslog.confを利用できるようにし、また、syslogdと同様にふるまうことが期待されるでしょう。
However, an original syslogd will not work correctly with a rsyslog-enchanced configuration file.
しかし、syslogdはrsyslogdのconfigファイルでは正しく動作しません。
At best, it will generate funny looking file names.
せいぜい、おかしな名前のファイルが生成される程度です。
The second important concept to note is that this version of rsyslogd interacts transparently with the version of syslog found in the standard libraries.
ふたつめは、rsyslogdは標準ライブラリに含まれるsyslogと透過的に相互作用するということです。
If a binary linked to the standard shared libraries fails to function correctly we would like an example of the anomalous behavior.
もし、これに失敗した場合は、その異常な挙動の例を私たちに教えてください。
The main configuration file /etc/rsyslog.conf or an alternative file, given with the -f option, is read at startup
main configuration fileは/etc/rsyslog.conf、もしくは、起動時のオプション (-f) で受け渡されたファイルです。
Any lines that begin with the hashmark (\#'') and empty lines are ignored.
hashmarkで始まる行および、空行はすべてコメントとして無視されます。
If an error occurs during parsing the error element is ignored.
設定ファイルの読み込みの際、parseの結果エラーが出た行についても無視されます。
It is tried to parse the rest of the line.
続く行の読み込みは引き続き行われます。
OPTIONS
SIGNALS
Rsyslogd reacts to a set of signals. You may easily send a signal to rsyslogd using the following:
Rsyslogdはsignalに反応します。以下のようにして、rsyslogdにsignalに送ることができます。
kill -SIGNAL $(cat /var/run/rsyslogd.pid)
HUP This lets rsyslogd perform close all open files
TERM, INT, QUIT
Rsyslogd will die.
USER1 Switch debugging on/off. This option can only be used if rsyslogd is started with the -d debug option.
CHLD Wait for childs if some were born, because of wall'ing messages.
CHLD childs processが存在する場合はそれを待つ。
SECURITY THREATS
514/UDPポートに接続するIPをFirewallで絞ろうとか、ディスク溢れによるシステム停止を防ぐためにログ用のパーティションを切ろうとかが書いてある。
DEBUGGING
When debugging is turned on using the -d option, rsyslogd produces debugging information according to the RSYSLOG_DEBUG environment variable and the signals received.
debbuging optionである-dオプションを指定することで、rsyslogdは RSYSLOG_DEBUG 環境変数、およびシグナルによってdebugging information を生成するようになる。
When run in forground, the information is written to stdout.
forgroundでrsyslogを実行している場合、stdoutにdebugging informationが出力される。
An additional output file can be specified using the RSYSLOG_DEBUGLOG environment variable.
RSYSLOG_DEBUGLOG 環境変数を設定することで、ファイル出力先を追加で指定できる。
FILES
ファイルについての説明がされている。