日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.2-RELEASE-K, 8.0-RELEASE-K は、プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.2-RELEASE-K, 8.0-RELEASE-K は、全翻訳済み)
6.4-STABLE-K, 7.2-STABLE-K, 8.0-STABLE-K は現在、 作成中で日々更新されています。 最新の snapshots を元に作成しています。
NEWSYSLOG(8) FreeBSD システム管理者マニュアル NEWSYSLOG(8)
名称
newsyslog - システムのログファイルを保守し、適切なサイズに保つ
書式
newsyslog [-CFnrsv] [-R tagname] [-a directory] [-f config_file]
[file ...]
解説
newsyslog ユーティリティは cron(8) から定期的に実行されるようにスケジュー
ルされるべきプログラムです。実行されると、 newsyslog は必要に応じてログ
ファイルを保存 (アーカイブ) します。あるログファイルを保存する必要がある
と判断すると、 ``logfile'' が空になり、 ``logfile.0'' に前回のログファイ
ルが入り、 ``logfile.1'' に前々回のログが入り といった具合に、ユーザが指
定した数の保存ログが残るよう、 newsyslog はファイルを再編します。オプショ
ンにより、保存ログを圧縮してスペースを節約することもできます。
ログが保存されるのは次の 3 つの場合です:
1. ログが設定サイズ (キロバイト単位で指定) より大きくなった。
2. 前回ログを保存してから指定した時間が経過した。
3. ログ入れ替えを行う指定時間になった。
newsyslog の粒度は、このコマンドが cron(8) からどの程度の頻度で実行される
かに依存しています。 newsyslog の実行は十分速いので、毎時間実行するように
スケジュールしても悪影響はありませんし、第 3 のモード (前述) はそうなって
いることを仮定しています。
起動されると、 newsyslog は設定ファイルを読み込んで、どのログファイルが潜
在的に保存されうるかを決定します。デフォルトでは、この設定ファイルは
/etc/newsyslog.conf です。設定ファイルの各行には、 newsyslog が処理すべき
特定のログファイルに関する情報を記述します。各行は 5 つの必須フィールド
と、4 つのオプションフィールドからなり、それらは空白で区切られています。
空行や ``#'' で始まる行は無視されます。 ``#'' が行の途中にある場合、
``#'' 文字とこの後の行の残りは無視されます。この特殊な意味を避けるため
に、``#'' を ``\'' でエスケープ可能です。この場合、前の ``\'' は削除さ
れ、``#'' は通常文字として扱われます。設定ファイルの各フィールドは以下の
通りです:
logfile_name
保存するシステムログファイル名か、リテラル文字列の ``<default>''
です。特別なデフォルトエントリが使用されるのは、 newsyslog コマン
ドのコマンドライン上でログファイル名が与えられ、このログファイル
名が設定ファイル注の他のどの行ともマッチしない場合だけです。
owner:group
このフィールドはオプションであり、保存ファイルの所有者とグループ
名を指定します。 owner あるいは group が空白のままである場合でも
":" は必須です。指定は数値、あるいは /etc/passwd か /etc/group に
ある名前で行います。
mode ログファイルと保存ログファイルのモードを指定します。
count ログファイルそのものに加えて保存しておく保存ファイルの数を指定し
ます。
size ログファイルのサイズが size キロバイトに達すると、ログファイルは
上記のように入れ換えられます。このフィールドがアスタリスク (`*')
で置き換えられると、ログファイル入れ換えに際してそのサイズは考慮
されなくなります。
when when フィールドは、インターバル、特定の時刻、もしくは両方です。
when フィールドがアスタリスク (`*') の場合、ログ入れ替えは size
フィールドにのみ依存します。そうでない場合、 when フィールドは、
オプションの、時間単位のインターバルからなります。これに続けて、
単一の `@' 記号と制限された ISO 8601 フォーマットで時刻を指定する
こともできますし、単一の `$' 記号と時刻を指定し、日に 1 回か週に
1 回か月に 1 回の決まった時刻にログファイルを入れ替えるように指定
することもできます。
時刻を指定すると、指定した時刻の 1 時間以内に newsyslog が実行さ
れた場合のみ、ログファイルを入れ替えます。インターバル時間が指定
された場合、最後の入れ替えからその時間数が経過した場合に、ログ
ファイルを入れ替えます。時刻とインターバルの両方が指定された場
合、入れ替えが実行されるには、両方の条件が満たされることが必要で
す。
タイムゾーンは指定できません。現在の実装では、明確に分や秒の部分
を指定することは、ほとんどできません。「1 時間以内」であることの
み、比較するからです。
ISO 8601 制限付時刻フォーマット
制限付 ISO 8601 時刻の先行文字は `@' 記号です。制約付 ISO 8601
フォーマットでの特定の時刻の指定は次の通りです:
[[[[[cc]yy]mm]dd][T[hh[mm[ss]]]]]です。日付フィールドはオプション
であり、デフォルトは現在の日付です。時刻フィールドはオプションで
あり、デフォルトは午前 0 時です。よって、今日が 1999 年 1 月 22
日の場合、次の日付指定はすべて同等です:
`19990122T000000'
`990122T000000'
`0122T000000'
`22T000000'
`T000000'
`T0000'
`T00'
`22T'
`T'
`'
日・週・月の時刻フォーマット
日・週・月の時刻フォーマットの先行文字は `$' 記号です。日・週・月
の指定の特定のフォーマットはそれぞれ次の通りです: [Dhh],
[Ww[Dhh]], [Mdd[Dhh]] 。オプションの時刻フィールドのデフォルト
は、午前 0 時です。日と時間の指定の範囲は次の通りです:
hh 時間であり、0 から 23 の範囲
w 曜日であり、0 から 6 の範囲で、0 が日曜日
dd 日であり、1 から 31 の範囲か、最終日を指定するため
の文字 L または l
以下に例を示します:
$D0 毎晩午前 0 時に入れ替えます (@T00 と同じです)
$D23 毎晩 23:00 に入れ替えます (@T23 と同じです)
$W0D23 毎週日曜日の 23:00 に入れ替えます
$W5D16 毎週金曜日の 16:00 に入れ替えます
$M1D0 毎月最初の日の午前 0 時に入れ替えます (その日の開始
時点です; @01T00 と同じです)
$M5D6 毎月 5 日の 6:00 に入れ替えます (@05T06 と同じです)
flags このオプションフィールドは 1 つ以上の文字からなり、この行にマッチ
するログファイルに対して行われる特殊処理を指定します。次の正当な
フラグがあります:
B ファイルがバイナリファイルまたは特殊フォーマットであるこ
とを指示します。通常、 newsyslog はログファイルが入れ換え
るときに ASCII メッセージをログファイルに挿入し、何時そし
て時には何故ログが入れ換えられたかを示します B が指定され
た場合、この情報メッセージはログファイルへ挿入されませ
ん。
C ログファイルが存在せず、かつ -C オプションがコマンドライ
ンに指定されていた場合、ログファイルが作成されるべきこと
を指示します。
G 指定した logfile_name がシェルパターンであることを示し、
このパターンにマッチする全ファイル名を newsyslog がアーカ
イブすることを意味します。文法とマッチ規則についての詳細
は、 glob(3) を参照してください。
J スペース節約のために、保存ファイルの bzip2(1) での圧縮を
試みるべきことを newsyslog へ指示します。
N このログファイルを入れ替えるときに、通知されるべきプロセ
スが存在しないことを示します。
U path_to_pid_file で示されるファイルが、プロセス ID ではな
くプロセスグループ ID を含むことを指示します。このオプ
ションは、そのファイル中の最初の行が負数であり、プロセス
ID と区別できるようになっていることを必要とします。
W Z や J フラグと組み合わせて使用すると、本エントリに対する
新規ジョブの前に、直前に開始した圧縮ジョブの完了を
newsyslog が待つべきことを示します。 G フラグと組み合わせ
て使用すると、パターンに複数のログファイルがマッチし、こ
れらが圧縮される場合、 newsyslog が同時には 1 個の圧縮し
か実行しないことを保証します。これは、同時には 1 個の圧縮
ジョブしか走行しないことを保証します。
Z スペース節約のために、保存ファイルの gzip(1) での圧縮を試
みるべきことを newsyslog へ指示します。
- マイナス記号は何も特別な処理を引き起こしませんが、後続
フィールド指定時に、 flags フィールドの埋め草として使用可
能です。
path_to_pid_file
このオプションのフィールドは、デーモンのプロセス ID、または U フ
ラグ指定時にはデーモンのプロセスグループ ID を調べるために読む
ファイルを指定します。このフィールドが存在する場合、このファイル
に書かれたプロセス ID に signal_number が送られます。このフィール
ドが存在しない場合、 N 指定時を除き、SIGHUP シグナルが syslogd(8)
へ送られます。正しく認識するために、このフィールドは "/" から開始
する必要があります。
signal_number
このオプションフィールドは、デーモンプロセスに送られるシグナル番
号を指定します。デフォルトで SIGHUP が送られます。
オプション
newsyslog では以下のオプションが利用できます:
-f config_file
設定ファイルとして /etc/newsyslog.conf に代えて config_file を使
用します。
-a directory
アーカイブしたログファイルを書き込む directory を指定します。相対
パスを指定した場合、これを各ログファイルのパスに後置したディレク
トリに、このログファイルのアーカイブログを書き込みます。絶対パス
を指定した場合、すべてのアーカイブログは指定した directory に書き
込まれます。パス directory のコンポーネントが存在しない場合、
newsyslog が実行されるときに生成されます。
-v newsyslog を詳細情報出力モードにします。このモードでは、ログを入
れ換えるあるいはそれをスキップするたびに、そのログファイル名と理
由を表示します。
-n 実際にログの入れ換えは行わず、このオプションが指定されない場合に
本来行うはずの処理内容を表示します。
-r newsyslog は root として動作しなければならない、という制約を取り
除きます。もちろん、 newsyslog は syslogd(8) に HUP シグナルを送
れなくなりますから、このオプションはデバッグにのみ用いるべきで
す。
-s ログファイル入れ替え時に通常は送っていたはずのデーモンプロセスへ
のシグナルを、一切送らないようにします。入れ替えられるログファイ
ルにとっては、このオプションは通常次の意味も持ちます。すなわち、
このオプションが無かった場合に通知されるデーモンがいる場合には、
入れ替えられたログファイルは圧縮されないという意味です。しかしな
がら、本オプションがもっとも有用なのはおそらく -R オプションと共
に指定された場合であり、この場合圧縮は行われます。
-C 1 回指定すると、存在しないが設定ファイルに C が指定されているログ
ファイルを newsyslog は作成します。複数回指定すると、 newsyslog
は存在しないファイルをすべて作成します。ログファイルがコマンドラ
イン上に指定されると、 -C もしくは -CC は、これらのログファイルに
のみ適用されます。
-F ログを入れ替える条件に合致しないとしても、強制的に newsyslog にロ
グを入れ替えさせます。システムの問題を診断しているときには、この
オプションの使用により、問題のみを含む新しいログを提供できるので
有用です。
-R tagname
入れ換え条件が成立していなくても、 newsyslog が指定されたリストの
ファイルを入れ替えるべきことを指示します。 tagname は、入れ替えら
れるログファイルに書き込まれるメッセージにのみ使用されます。これ
が -F オプションと違うのは、ひとつ以上のファイルを指定する必要が
あり、 newsyslog がこれらの指定されたファイルに対してのみ動作する
という点です。このオプションの主たる目的は、複数のログファイルを
書くデーモンやプログラムで、それら自身の条件で入れ替えを引き起こ
したいもののために使用することです。このオプションを使用すると、
入れ替えたいときにそれらは newsyslog を実行でき、またシステム管理
者が依然として入れ換え規則 (バックアップ保存数や圧縮の種類等) を
指定可能とします。デーモンが newsyslog を -R オプション付きで呼び
出すとき、 newsyslog の呼び出し前にそのデーモンは全ログファイルが
クローズされていることを保証することと、 newsyslog が戻った後にロ
グファイルをリオープンすることが必要です通常、呼び出しプロセスは
-s オプションも指定したいでしょうから、入れ替えを強制したプロセス
自身には newsyslog はシグナルを送らないでしょう。シグナル処理を行
わないということは、 newsyslog は通常シグナル送信後に数秒待ちます
ので、 newsyslog は高速に戻ることを意味します。
追加のコマンド行引数を指定すると、 newsyslog はこれらの引数にマッチするロ
グファイルのみを検査します。そうでない場合、設定ファイルに列挙された全
ファイルを検査します。
関連ファイル
/etc/newsyslog.conf newsyslog の設定ファイル
バグ
セキュリティ侵害を見つけるためにログを自動的に読むことは、まだ行っていま
せん。
作者
Theodore Ts'o, MIT Project Athena
Copyright 1987, Massachusetts Institute of Technology
互換性
以前のバージョンの newsyslog ユーティリティは、グループ名の識別にドット
(``.'') を使用していました。 FreeBSD 3.3 からは、これはコロン (``:'') 文
字になりましたので、ユーザ名とグループ名にドット文字を含めることが可能で
す。後方互換性のために、ドット (``.'') 文字はまだ受け付けられます。
関連項目
gzip(1), syslog(3), chown(8), syslogd(8)
FreeBSD 4.9 April 27, 2003 FreeBSD 4.9