NEWSLOG(5)

名前
newslog - ニュースログファイルの解説

機能説明
ニュースシステムのプログラムで作成されるほとんどのログファイルは /var/log/news ディレクトリにあり、``.log'' という拡張子が付いています。 いくつかのログは通常、``.1'' や ``.2'' 等のようにさらに拡張子が付いて保持されています — 数字が大きくなるほど、ログは古くなります。 古いログは圧縮されています。

scanlogs スクリプトや関連するコマンド( newslog(8) を参照してください)はこれらの古いログファイルの処理や圧縮を行います。

ログのうちいくつかにはデータが常にありますが、 問題がある場合にのみデータがあるファイルや、特別なプログラムが使用されたり、 設定パラメータが設定された場合にのみ作成されるファイルがあります。 innstat スクリプト( newslog(8) を参照してください)はすべてのこのようなログファイルの大きさを監視します。

次のファイルは control.ctl(5) での設定によりデータを累積するのみです。
    control.log miscctl.log newgroup.log rmgroup.log unwanted.log
これらのファイルを作成するには、 control.ctl の ``message'' と ``action'' のフィールドを次のテーブルから選択しなければいけません。
    message	action	意味
    all	log=miscctl	デフォルトですべての message のログを行う
    default	log=miscctl	知らない messages のログを行う
    newgroup	doit=newgroup	ニュースグループを作成し message のログを行う
    newgroup	log=newgroup	message のログを行う
    rmgroup	doit=rmgroup	ニュースグループを削除し message のログを行う
    rmgroup	log=rmgroup	message のログを行う
    ``other''	doit=miscctl	message を処理し、ログを行う
    ``other''	log=miscctl	message のログを行う
ここでの ``other'' は次のような他のコントロールメッセージです。
    checkgroups ihave sendme sendsys senduuname version

ログファイルについて次に説明します。

badcontrol.log
    このファイルは、 parsecontrol によって正しいと判断されなかったコントロールメッセージが、 writelog により追加されます。 このファイルは、コントロールメッセージと処理の内容を示すサマリ行に続いて、 4 文字分字下げをして記事の内容と空行が出力されています。

badpgp.log
    このファイルは、 pgpverify によって正しいと認証されなかったコントロールメッセージが、 writelog により追加されます。 このファイルは、コントロールメッセージと処理の内容を示すサマリ行に続いて、 4 文字分字下げをして記事の内容と空行が出力されています。

control.log
    このファイルは各ニュースグループに対する newgroup や rmgroup のコントロールメッセージの累計を保持しています。 これは、実際に処理されたかどうかに関係無く、同じ引数のコントロールメッセージの累計となります。 無効なものも含めて引数となっているすべてのニュースグループの累計となります。 このファイルは newgroup あるいは rmgroup のいずれかのログが存在していれば、 scanlogs から起動される tally.control で更新されます。 このファイルは古い情報もマージしたものとなります。

errlog
    このファイルは innd(8) から起動されるプログラムの標準出力や標準エラー出力先となります。 このうち最も共通なプログラムは /usr/news/bin/control にあるコントロールメッセージ処理コマンドとなります。 このファイルは通常は空となっていなければいけません。 scanlogs はこのファイルが空でなければ、その内容をすべて出力します。

expire.log
    デフォルトでは、 news.daily が古くなった記事を expire する場合、このファイルに日付に続いて expire(8) の出力と終了の日付を出力します。 最初の行以外はすべてスペース 4 文字分字下げが行われます。

failedpgp.log
    このファイルは、 pgp を正常に起動できなくて正しいと認証されなかったコントロールメッセージが、 writelog により追加されます。 このファイルは、コントロールメッセージと処理の内容を示すサマリ行に続いて、 4 文字分字下げをして記事の内容と空行が出力されています。

miscctl.log
    control.ctl が上記で説明したように設定されていれば、newgroup と rmgroup 以外のすべてのコントロールメッセージが writelog により追加されます。 このファイルには、コントロールメッセージと処理の内容を示すサマリ行に続いて、 4 文字分字下げをして記事の内容と空行が出力されています。

newgroup.log
    control.ctl が上記で説明したように設定されていれば、すべての newgroup のコントロールメッセージが miscctl.log と同じフォーマットでこのファイルに追加されます。

news
    このファイルは innd が受け取った記事のログが出力されます。 scanlogs はこのファイルに出力された拒否された記事のサマリを作成します。

news.crit
    innd が出力したすべての致命的なエラーメッセージは syslog(3) 経由でこのファイルに追加されます。 このログファイルは通常は空となっていなければいけません。 scanlogs はこのファイルが空でなければ、その内容をすべて出力します。 syslog.conf(5) ファイルには次の行がなければいけません。
        news.crit /var/log/news/news.crit

news.err
    innd が出力したすべての重要なエラーメッセージは syslog(3) 経由でこのファイルに出力されます。 このファイルは通常は空となっていなければいけません。 syslog.conf(5) ファイルには次の行がなければいけません。
        news.err /var/log/news/news.err

news.notice
    innd が出力したすべての標準エラーメッセージやステータスメッセージは syslog(3) 経由でこのファイルに出力されます。 scanlogs は perl(1) スクリプトの innlog.pl を使用してこのファイルのサマリを作成します。 syslog.conf(5) ファイルには次の行がなければいけません。
        news.notice /var/log/news/news.notice

nntpsend.log
    nntpsend(8) コマンドではすべてのステータスメッセージをこのファイルに追加します。

rmgroup.log
    control.ctl が上記で説明したように設定されていれば、すべての rmgroup のコントロールメッセージが miscctl.log と同じフォーマットでこのファイルに追加されます。

unwanted.log
    このログファイルにはローカルに存在していないニュースグループへの記事を 受け取ったために拒否したものの累計を保持しています。 このファイルは tally.unwanted で更新され、降順に保持されます(最も多く拒否されたニュースグループが最初になります)。 このファイルは古い情報もマージしたものとなります。

履歴
InterNetNews 用にLandon Curt Noll <chongo@toad.com> と Rich $alz <rsalz@uunet.uu.net> により記述されました。

関連項目
control.ctl(5)、 ctlinnd(8)、 expire(8)、 innd(8)、 news.daily(8)、 nntpsend(8)、 newslog(8)