f95723cad8
Reviewed by: Japanese Online Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>
277 lines
6.8 KiB
Groff
277 lines
6.8 KiB
Groff
.\" This file contains changes from the Open Software Foundation.
|
|
.\"
|
|
.\" from: @(#)newsyslog.8
|
|
.\" %Id: newsyslog.8,v 1.14.2.1 1999/02/25 18:38:33 wollman Exp %
|
|
.\"
|
|
.\" Copyright 1988, 1989 by the Massachusetts Institute of Technology
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software
|
|
.\" and its documentation for any purpose and without fee is
|
|
.\" hereby granted, provided that the above copyright notice
|
|
.\" appear in all copies and that both that copyright notice and
|
|
.\" this permission notice appear in supporting documentation,
|
|
.\" and that the names of M.I.T. and the M.I.T. S.I.P.B. not be
|
|
.\" used in advertising or publicity pertaining to distribution
|
|
.\" of the software without specific, written prior permission.
|
|
.\" M.I.T. and the M.I.T. S.I.P.B. make no representations about
|
|
.\" the suitability of this software for any purpose. It is
|
|
.\" provided "as is" without express or implied warranty.
|
|
.\"
|
|
.\" jpman %Id: newsyslog.8,v 1.3 1997/08/16 13:33:00 horikawa Stab %
|
|
.Dd January 27, 1999
|
|
.Dt NEWSYSLOG 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm newsyslog
|
|
.Nd システムのログファイルを保守し、適切なサイズに保つ
|
|
.Sh 書式
|
|
.Nm newsyslog
|
|
.Op Fl Fnrv
|
|
.Op Fl f Ar config_file
|
|
.Sh 解説
|
|
.Nm
|
|
は
|
|
.Xr cron 8
|
|
から定期的に実行されるようにスケジュールされるべきプログラムです。
|
|
実行されると、
|
|
.Nm
|
|
は必要に応じてログファイルを保存 (アーカイブ) します。
|
|
あるログファイルを保存する必要があると判断すると、
|
|
.Dq Va logfile
|
|
が空になり、
|
|
.Dq Va logfile Ns Li \&.0
|
|
に前回のログファイルが入り、
|
|
.Dq Va logfile Ns Li \&.1
|
|
に前々回のログが入り‥‥ といった具合に、
|
|
ユーザが指定した数の保存ログが残るよう、
|
|
.Nm
|
|
はファイルを再編します。
|
|
オプションにより、保存ログを圧縮してスペースを節約することもできます。
|
|
.Pp
|
|
ログが保存される場合には 3 つの理由があります:
|
|
.Bl -enum -offset indent
|
|
.It
|
|
ログが設定サイズ (キロバイト数) より大きくなった。
|
|
.It
|
|
前回ログを保存してから指定した時間が経過した。
|
|
.It
|
|
ログ入れ替えを行う指定時間である。
|
|
.El
|
|
.Nm
|
|
の粒度は、このコマンドが
|
|
.Xr cron 8
|
|
からどの程度の頻度で実行されるかに依存しています。
|
|
.Nm
|
|
の実行は十分速いので、毎時間実行するようにスケジュールしても
|
|
悪影響はありませんし、
|
|
第 3 のモード (前述) はそうなっていることを仮定しています。
|
|
.Pp
|
|
起動されると、
|
|
.Nm
|
|
は設定ファイルを読み込んで、
|
|
どのログファイルが潜在的に保存されうるかを決定します。
|
|
デフォルトでは、この設定ファイルは
|
|
.Pa /etc/newsyslog.conf
|
|
です。
|
|
設定ファイルの各行には、
|
|
.Nm
|
|
が処理すべき特定のログファイルに関する情報を記述します。
|
|
各行は 5 つの必須フィールドと、4 つのオプションフィールドからなり、
|
|
それらは空白で区切られています。
|
|
空行や ``#'' で始まる行は無視されます。
|
|
設定ファイルの各フィールドは以下の通りです:
|
|
.Pp
|
|
.Bl -tag -width indent
|
|
.It Ar logfile_name
|
|
保存するシステムログファイル名。
|
|
.It Ar owner.group
|
|
このフィールドはオプションであり、
|
|
保存ファイルの所有者とグループ名を指定します。
|
|
.Ar owner
|
|
あるいは
|
|
.Ar group
|
|
が空白のままである場合でも "." は必須です。
|
|
指定は数値、あるいは
|
|
.Pa /etc/passwd
|
|
か
|
|
.Pa /etc/group
|
|
にある名前で行います。
|
|
.It Ar mode
|
|
ログファイルと保存ログファイルのモードを指定します。
|
|
.It Ar count
|
|
ログファイルそのものに加えて保存しておく保存ファイルの数を指定します。
|
|
.It Ar size
|
|
ログファイルのサイズが
|
|
.Ar size
|
|
に達すると、ログファイルは上記のように入れ換えられます。
|
|
このフィールドがアスタリスク
|
|
.Pq Ql \&*
|
|
で置き換えられると、ログファイル入れ換えに際して
|
|
そのサイズは考慮されなくなります。
|
|
.It Ar when
|
|
.Ar when
|
|
フィールドは、インターバル、特定の時刻、もしくは双方のいずれかです。
|
|
.Ar when
|
|
フィールドがアスタリスク
|
|
.Pq Ql \&*
|
|
の場合、ログ入れ替えは
|
|
.Ar size
|
|
フィールドにのみ依存します。
|
|
そうでない場合、
|
|
.Ar when
|
|
フィールドは、オプションのインターバル時間指定からなり、単一の
|
|
.So Li \&@ Sc
|
|
記号と制限された
|
|
.Tn ISO 8601
|
|
フォーマットで時刻を続けることができます。
|
|
時刻を指定すると、指定した時刻の 1 時間以内に
|
|
.Nm newsyslog
|
|
が実行された場合のみ、ログファイルを入れ替えます。
|
|
インターバル時間が指定された場合、
|
|
最後の入れ替えからその時間数が経過した場合に、ログファイルを入れ替えます。
|
|
時刻とインターバルの両方が指定された場合、入れ替えが実行されるには、
|
|
両方の条件が満たされることが必要です。
|
|
.Pp
|
|
時刻のフォーマットは
|
|
.Sm off
|
|
.Oo
|
|
.Oo
|
|
.Oo
|
|
.Oo
|
|
.Oo
|
|
.Va \&cc
|
|
.Oc
|
|
.Va \&yy
|
|
.Oc
|
|
.Va \&mm
|
|
.Oc
|
|
.Va \&dd
|
|
.Oc
|
|
.Oo
|
|
.Li \&T
|
|
.Oo
|
|
.Va \&hh
|
|
.Oo
|
|
.Va \&mm
|
|
.Oo
|
|
.Va \&ss
|
|
.Oc
|
|
.Oc
|
|
.Oc
|
|
.Oc
|
|
.Oc です。
|
|
.Sm on
|
|
日付フィールドはオプションであり、デフォルトは現在の日付の適切な部分です。
|
|
時刻フィールドはオプションであり、デフォルトは深夜です。
|
|
よって、今日が 1999 年 1 月 22 日の場合、次の日付指定はすべて同等です:
|
|
.Pp
|
|
.Bl -item -compact -offset indent
|
|
.It
|
|
.Sq Li 19990122T000000
|
|
.It
|
|
.Sq Li 990122T000000
|
|
.It
|
|
.Sq Li 0122T000000
|
|
.It
|
|
.Sq Li 22T000000
|
|
.It
|
|
.Sq Li T000000
|
|
.It
|
|
.Sq Li T0000
|
|
.It
|
|
.Sq Li T00
|
|
.It
|
|
.Sq Li 22T
|
|
.It
|
|
.Sq Li \&T
|
|
.It
|
|
.Sq Li \&
|
|
.El
|
|
.Pp
|
|
タイムゾーンは指定できません。
|
|
現在の実装では、明確に分や秒の部分を指定することは、ほとんどできません。
|
|
「1 時間以内」であることのみ、比較するからです。
|
|
.It Ar flags
|
|
このフィールドはオプションであり、
|
|
保存に際してログファイルに特別な処理を行うかどうかを指定します。
|
|
.Ar Z
|
|
フラグを指定すると、スペース節約のために
|
|
保存ファイルは
|
|
.Xr gzip 1
|
|
で圧縮されます。
|
|
.Ar B
|
|
フラグはファイルがバイナリファイルであることを指示し、
|
|
ログファイルが入れ換わったという意味で
|
|
.Nm
|
|
が挿入する
|
|
.Tn ASCII
|
|
メッセージを含めないようにします。
|
|
.Ar -
|
|
は何も意味しませんが、
|
|
.Ar path_to_pid_file
|
|
フィールドが指定された場合には埋め草として使用可能です。
|
|
.It Ar path_to_pid_file
|
|
このオプションのフィールドは、
|
|
デーモンのプロセス ID を調べるために読むファイルを指定します。
|
|
このフィールドが存在する場合、
|
|
このファイルに書かれたプロセス ID に
|
|
.Ar signal_number
|
|
が送られます。
|
|
正しく認識するために、このフィールドは "/" から開始する必要があります。
|
|
.It Ar signal_number
|
|
このオピションフィールドは、
|
|
デーモンプロセスに送られるシグナル番号を指定します。
|
|
デフォルトで SIGHUP が送られます。
|
|
.El
|
|
.Sh オプション
|
|
newsyslog では以下のオプションが利用できます:
|
|
.Bl -tag -width indent
|
|
.It Fl f Ar config_file
|
|
設定ファイルとして
|
|
.Pa /etc/newsyslog.conf
|
|
に代えて
|
|
.Ar config_file
|
|
を使用します。
|
|
.It Fl v
|
|
.Nm
|
|
を詳細情報出力モードにします。
|
|
このモードでは、ログを入れ換えるあるいはそれをスキップするたびに、
|
|
そのログファイル名と理由を表示します。
|
|
.It Fl n
|
|
実際にログの入れ換えは行わず、このオプションが指定されない場合に
|
|
本来行うはずの処理内容を表示します。
|
|
.It Fl r
|
|
.Nm
|
|
は root として動作しなければならない、という制約を取り除きます。
|
|
もちろん、
|
|
.Nm
|
|
は
|
|
.Xr syslogd 8
|
|
に HUP シグナルを送れなくなりますから、
|
|
このオプションはデバッグにのみ用いるべきです。
|
|
.It Fl F
|
|
ログを入れ替える条件に合致しないとしても、強制的に
|
|
.Nm
|
|
にログを入れ替えさせます。
|
|
システムの問題を診断しているときには、
|
|
このオプションの使用により、
|
|
問題のみを含む新しいログを提供できるので有用です。
|
|
.El
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /etc/newsyslog.confxxxx -compact
|
|
.It Pa /etc/newsyslog.conf
|
|
.Nm
|
|
の設定ファイル
|
|
.El
|
|
.Sh バグ
|
|
セキュリティ侵害を見つけるためにログを自動的に読むことは、
|
|
まだ行っていません。
|
|
.Sh 作者
|
|
.An Theodore Ts'o ,
|
|
MIT Project Athena
|
|
.Pp
|
|
Copyright 1987, Massachusetts Institute of Technology
|
|
.Sh 関連項目
|
|
.Xr gzip 1 ,
|
|
.Xr syslog 3 ,
|
|
.Xr syslogd 8
|