繁體中文 | 简体中文 | English

arclog.pl v2.1.0dev2

最新消息

2002-09-18
arclog.pl 最新版本 v2.1.0dev2 。本版修正了幾個說明文件的錯誤，並 把 SourceForge 加進 arclog.pl 的下載網址中。妳可以把它當做「申請 SourceForge 紀念版」。原則上，不需 要急著昇級。若要下載，請按這裏。
2002-09-17
好消息！ arclog.pl 已開始架設於 SourceForge 囉！ （雖然我幾乎還完全搞不清楚要怎麼架……摸索中…… ^^; ）
2002-08-31
arclog.pl 最新版本 v2.1.0dev1 。本版修正了無法在 perl 5.8.0 執行 的錯誤。我暫時還把她當成是「 dev 」研發版，因為我想在 2.1.0 正式版的 時候，支援 Compress::Bzip2 與 ExtUtils::MakeMaker 。不過她其實很穩定。若要下載，請按這裏。

說明

arclog.pl 是記錄檔的歸檔程式，將指定的記錄檔按月份壓縮歸檔，以方便 日後整理，節省硬碟空間，並避免記錄檔被有心人士破壞。

本程式目前只能整理 Apache 和 Syslog 兩種格式的記錄檔。

注意事項

系統需求

  1. Perl 5.005 或以上。本程式使用 File::Temp 模組，需要 perl 5.005 以 後才支援的一些新功能。目前大多數的 UNIX 系統都有 perl 。如果你沒有 perl 或需要昇級，可以到 http://www.perl.com/ 下載安裝最新版 perl 。若妳是用 MS-Windows ，可以到 http://www.activestate.com/ 下載安裝。
  2. 本程式需要下列 perl 模組： File::Spec::Functions 、 File::Temp 、 Date::Parse 、 Compress::Zlib 。 如果你沒有，可以到 CPAN 程式庫 http://search.cpan.org/ 下載安裝。

下載

arclog.pl 的官方網站在：

最新版 arclog.pl 可由下列位址下載：

依瑪貓的 PGP 在：

安裝

  1. 解壓縮：

    % tar -xzf arclog.pl-x.xx.xx.tar.gz

  2. 以自動安裝程式安裝（建議）

    雖然本程式不需要設定，我還是希望你跑一遍自動安裝程式。自動安裝程式 會檢查所需的系統環境，事先告知你程式無法執行的問題。

    要跑自動安裝程式，要先安裝 File::Spec::Functions 模組。 perl 5.6.0 以後會隨附這個模組，不用特地安裝。如果你的 perl 比 較舊，沒有這個模組，可以到 CPAN 程式庫 http://search.cpan.org/ 下載安裝。

    到解壓縮後的目錄中，執行自動安裝程式 Install.PL ：

    % ./Install.PL

    這時，安裝程式會檢查所需的系統環境，並問妳所需的設定。請依序回答。 然後，安裝程式會按妳的回答，把程式裝起來。妳也可以下：

    % ./Install.PL --help

    查看有哪些選項。

  3. 手動安裝

    到解壓縮後的目錄中，將 arclog.pl 檔複製到妳要存的目錄 下，就可以了。

  4. 執行

    跑跑看有沒有問題。妳可以下：

    % ./arclog.pl --help

    查看有哪些選項，或下：

    % perldoc arclog.pl

    查閱完整的程式說明。

命令列參數

./arclog.pl [參數] 記錄檔檔名... [歸檔檔名開頭]
./arclog.pl [-h|-v]
記錄檔檔名
要整理歸檔的記錄檔檔名。若要從標準輸入讀記錄檔，請設定成「 - 」。可同時指定許多檔案。 GZIP 壓縮檔亦可。
歸檔檔名開頭
歸檔檔名用的開頭，歸檔後的檔案會取名叫「開頭.yymmdd 」，如： 開頭.200101 、開頭.200102 ……等。如果沒有設定，會用記錄檔的檔名當開 頭。若妳要從標準輸入讀記錄檔，就一定要設歸檔檔名開頭。這裏不能用「 - 」（標準輸入），因為這只是檔名的開頭而已，不是檔案全名。
-c, --compress
歸檔後壓縮（預設值）。記錄大多都長得很像，壓縮掉會省下非常多的空 間。（不然幹嘛歸檔？ ^_*' ）目前只支援 gzip 壓縮法。
--nocompress
歸檔後不要壓縮。（妳沒搞錯吧？ :p ）
-s, --sort
按記錄時間先後（及記錄本身順序）排序。排序很耗記憶體和 CPU ，所以預設是不排序。請參見前面關於排序的注意事項。
--nosort
不要排序（預設值）。
-o, --override[=模式]
如果有同名的舊檔，該怎麼辦。目前有下列模式：
o, overwrite
蓋掉舊檔。如果只有設定 --override ，沒有設定模式，那 會當你想要蓋掉舊檔。舊檔的記錄會被刪掉，請多加小心。若你的記錄檔是主 記錄檔，有最完整的記錄，妳可以用 overwrite 。
a, append
和舊檔加在一起。這有可能會演變成大混亂，請多加小心。若你想把兩份 不同時間的記錄檔加在一起，妳可以用 append 。
i, ignore
略過所有該月的記錄。這有可能造成部份記錄流失，請多加小心。若你只 要補充沒有歸檔的月份，妳可以用 ignore 。
f, fail
結束程式，以免不小心破壞舊檔。若妳要用 crontab 之類的程式，全自動 化執行，最好這樣，以免破壞資料。因此，若標準輸入不是連到鍵盤上，預設 是 fail 。
ask
問妳該怎麼辦。若妳是手動執行，這樣最方便。因此，若標準輸入是連到 鍵盤上，預設是 ask 。答案是從標準輸入讀的。因為標準輸入 只有一個，若你要從標準輸入讀記錄檔，不能跑 ask 模式，會 自動退回 fail 模式。還有，如果從標準輸入讀不到東西，像 crontab 裏標準輸入被關掉了，也會自動退回 fail 模式。
-k, --keep[=模式]
原記錄檔要怎麼處理。目前有下列模式：
a, all
完全保留原檔。如果只有設定 --keep ，沒有設定模式，那 會當你想要保留原檔。
r, restart
歸檔後，原記錄檔歸零。
d, delete
歸檔後，刪除原記錄檔。
t, this-month
將之前月份的記錄歸檔，保留這個月的記錄，留待下個月歸檔。這是給 crontab 每月歸檔用的。因此，預設是 this-month 。
-d, --debug
顯示詳細的執行過程。
-q, --quiet
沒事不要吵。 :p
-h, --help
顯示程式說明。
-v, --version
顯示程式版本。

版權聲明

版權所有 © 2001-2002 依瑪貓。依瑪貓保有所有權利。

本程式是自由軟體，您可以遵照自由軟體基金會 (Free Software Foundation) 出版的 GNU 通用公共許可證條款 (GNU General Public License) 第二版來修改和 重新發佈這一程式，或者自由選擇使用任何更新的版本。

發佈這一程式的目的是希望它有用，但沒有任何擔保。甚至沒有適合特定目 的而隱含的擔保。更詳細的情況請參閱 GNU 通用公共許 可證。

您應該已經和程式一起收到一份 GNU 通用公共許可 證的副本。如果還沒有，寫信給： Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

版本紀錄

請閱讀 RELEASE_NOTES 檔，查看程式的演變、新增的功能和 修補的錯誤。

依瑪貓 <imacat@mail.imacat.idv.tw> 初稿 2001-06-08 ，上次更新日期 2002-09-18
Valid XHTML 1.1! 本頁符合 XHTML 1.1 規格