NAME

ppplog - PPP の接続記録を集計するスクリプト

SYNOPSIS

  ppplog [OPTIONS] [FILES...]

DESCRIPTION

一般的な Linux システムでは，pppd(8) の接続記録は syslog(3) を通じて /var/log/messages に蓄積されている．ppplog は，この接続記録を集 計し，通話時間・料金を計算して標準出力に出力する．

OPTIONS

-a
--all
全ての接続記録を集計する(デフォルトは，前回集計時の mark 以前の記録は 集計しない)．

-q
--quiet
集計結果を標準出力に出力しない(デフォルトは出力する)．

-l FACILITY
--log-facility=FACILITY
syslog に実行記録を送るときに用いる facility を指定する．明示的な指定 がなければ，local2 が用いられる．このオプションには，pppd と同じ facility と使うように設定しておくべきである．

ppplog は，syslog に記録された自分自身の動作記録を利用して，集計済 みの PPP 接続記録を検出している．言い換えれば，PPP の接続記録と，この スクリプトの動作記録が同一の記録ファイルに記録されていなければならない． そのためには，同じ facility を利用するのが最も簡単で確実な方法である．

Debian では local2 が用いられているが，その他の環境では daemon が用いられていることが多い．

FILES

/var/log/messages
/var/log/messages.0
ファイルが明示的に指定されなかった場合は，これらの2つのファイルを対象 として接続記録を集計する．

USAGE

本スクリプトを Debian で使用する場合は，/etc/cron.weekly/ にこのス クリプトをインストールすると良い．

  Example:
    # install -o root -g root -m 755 ppplog.perl /etc/cron.weekly/ppplog

これだけで，PPP の接続記録が週毎に集計され，root 宛にメールされるよう になる．

他の環境で利用する場合は cron(8) などを参照．

SEE ALSO

pppd(8), syslog(3), cron(8).

AUTHOR

TSUCHIYA Masatoshi <tsuchiya@namazu.org>

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, you can either send email to this program's maintainer or write to: The Free Software Foundation, Inc.; 59 Temple Place, Suite 330; Boston, MA 02111-1307, USA.

Last Update: $Date: 2002/12/13 13:04:22 $