繁體中文 |
简体中文 |
English
arclog.pl v1.6.0
最新消息
arclog.pl 最新版本 v1.6.0 ，可以按
這裏
下載。
說明
arclog.pl 是記錄檔的歸檔程式，將指定的記錄檔按月份
壓縮歸檔，以方便日後整理，節省硬碟空間，並避免記錄
檔被有心人士破壞。
本程式目前只能整理 apache 和
syslog 兩種格式的記錄檔。
注意事項
-
歸類記錄檔很花時間，檔案越大，要花越多時
間。如果這時還在繼續記錄，雙方同時寫入，會破壞整個
檔案。 arclog.pl 會呼叫
flock() 完全鎖定檔案，避免別人同時寫
入。可是別人不見得會用 flock() 鎖檔，
尤其是 httpd 和 syslogd
這類記錄程式。（其實，如果她們也用
flock() ，我們就永遠鎖不到檔案了。）
因此，執行前，一定要先關掉記錄程式，不然就把
arclog.pl 跑在沒有使用中的記錄檔上。
-
妳可以加上 --sort ，按記錄時間先後（
及記錄原先的順序）排列順序。如果記錄檔是好幾個檔案
剪貼出來的，也許排個順序會比較好。不過排序很耗
記憶體和 CPU 。如果記錄檔很大，整個系統會瞬間
垮掉。我有寫一些簡單的預防措施，可是我不保證一
定擋得了。系統會不會垮，取決於妳
CPU 多快，有多少記憶體，及記錄檔多大
。基於上述原因，預設不會排序。
-
若要整理 syslog 記錄檔，請特別注意：
syslog 記錄檔沒有記錄年份。
arclog.pl 用 Date::Parse
模組解讀時間。無年份時， Date::Parse
會把年份設在「這個月」到「去年的下個月」之間。例如
，若今天是 2001-06-08 ，那年份會設在 2001-06-30 到
2000-07-01 之間。我原則上贊成這樣。不過，若妳的
syslog 記錄檔歷史超過一年，不要跑
arclog.pl ，否則記錄會完蛋。
-
從 1.5.0 版以後，可以用「 - 」從標準
輸入讀記錄檔。不過請注意：一、若要讀標準輸入，就一
定要設定歸檔檔名的開頭，不然程式不知道怎麼存檔。二
、若讀的是檔案，這個月的記錄會存回原檔中，以便下個
月再歸檔；若讀的是標準輸入，這個月的記錄沒有地方存
回去，也會被歸檔起來。三、 ask 模式的
回答也是從標準輸入讀的。因為標準輸入只有一個，所以
從標準輸入讀檔時，無法跑 ask 模式，會
自動退回到 fail 模式。
系統需求
-
Perl 5.005 或以上。本程式使用 File::Temp 模組，需
要 perl 5.005 以後才支援的一些新功能。
目前大多數的 UNIX 系統都有 perl 。如果你沒有 perl
或需要昇級，可以到
http://www.perl.com/
下載安裝最新版 perl 。若妳是用 MS-Windows ，可以到
http://www.activestate.com/
下載安裝。
-
本程式需要下列 perl 模組：
File::Spec::Functions 、
File::Temp 、
Date::Parse 、
Compress::Zlib 。
如果你沒有，可以到 CPAN 程式庫
http://search.cpan.org/
下載安裝。
下載
最新版 arclog.pl 可以由下列位址下載：
安裝
-
解壓縮：
% tar -xzf arclog.pl-x.xx.xx.tar.gz
-
以自動安裝程式安裝（強烈推薦）
雖然本程式不需要設定，我還是希望你跑一遍自動安裝程
式。自動安裝程式會檢查所需的系統環境，事先告知你程
式無法執行的問題。
要跑自動安裝程式，要先安裝
File::Spec::Functions
模組。 perl 5.6.0 以後會隨附這個模組，不用特地安裝
。如果你的 perl 比較舊，沒有這個模組，可以到 CPAN
程式庫
http://search.cpan.org/
下載安裝。
到解壓縮後的目錄中，執行自動安裝程式 Install.PL ：
% ./Install.PL
這時，安裝程式會檢查所需的系統環境，並問妳所需的設
定。請依序回答。然後，安裝程式會按妳的回答，把程式
裝起來。妳也可以下
% ./Install.PL --help
查看有哪些選項。
-
手動安裝
到解壓縮後的目錄中，將 arclog.pl 複製到妳要存的目
錄下，記得設為可執行。
% chmod +x arclog.pl
這樣就可以了。
-
執行
跑跑看有沒有問題。妳可以下
% ./arclog.pl --help
查看有哪些選項，或下
% perldoc arclog.pl
查閱完整的程式說明。
命令列參數
./arclog.pl [參數] 記錄檔檔名... [歸檔檔名開頭]
./arclog.pl [-h|-v]
- 記錄檔檔名
-
要整理歸檔的記錄檔檔名。若要從標準輸入讀記錄檔，請
設定成「 - 」。可同時指定許多檔案。
- 歸檔檔名開頭
-
歸檔檔名用的開頭，歸檔後的檔案會取名叫
「開頭.yymmdd 」，如：開頭.200101 、開頭.200102 …
…等。如果沒有設定，會用記錄檔的檔名當開頭。若妳要
從標準輸入讀記錄檔，就一定要設歸檔檔名開頭。這裏不
能用「 - 」（標準輸入），因為這只是檔
名的開頭而已，不是檔案全名。
- --compress
-
歸檔後壓縮（預設值）。記錄大多都長得很像，壓縮掉會
省下非常多的空間。（不然幹嘛歸檔？ ^_*' ）目前只支
援 gzip 壓縮法。
- --nocompress
-
歸檔後不要壓縮。（妳沒搞錯吧？ :p ）
- --sort
-
按記錄時間先後（及記錄本身順序）排序。排序很耗記憶
體和 CPU ，所以預設是不排序。請參見前面關於排序的
注意事項。
- --nosort
-
不要排序（預設值）。
- --override[=模式]
-
如果有同名的舊檔，該怎麼辦。目前有下列模式：
- overwrite
-
蓋掉舊檔。如果只有設定 --override ，
沒有設定模式，那會當你想要蓋掉舊檔。舊檔的記錄會被
刪掉，請多加小心。若你的記錄檔是主記錄檔，有最完整
的記錄，妳可以用 overwrite 。
- append
-
和舊檔加在一起。這有可能會造成記錄大混亂，請多加小
心。若你想把兩份不同時段的同種記錄檔剪貼在一起，妳
可以用 append 。
- ignore
-
略過所有該月的記錄。這有可能造成部份記錄資料流失，
請多加小心。若你只要補充舊檔所沒有的月份，妳可以用
ignore 。
- fail
-
結束程式，以免不小心破壞舊檔。若妳要全自動化執行，
如用 crontab 跑，最好這樣，以免破壞資
料。因此，若標準輸入不是終端機鍵盤，預設是
fail 。
- ask
-
問妳該怎麼辦。若妳是手動執行，這樣最方便。因此，若
標準輸入是終端機鍵盤，預設是 ask 。答
案是從標準輸入讀的。因為標準輸入只有一個，若你要從
標準輸入讀記錄檔，不能跑 ask 模式，會
自動退回 fail 模式。還有，如果從標準
輸入讀不到東西，像 crontab 把標準輸入
先關掉了，也會自動退回 fail 模式。
- -d, --debug
-
顯示詳細的執行過程。
- -q, --quiet
-
沒事不要吵。 :p
- -h, --help
-
顯示程式說明。
- -v, --version
-
顯示程式版本。
版權聲明
版權所有 © 2001 依瑪貓。依瑪貓保有所有權利。
本程式是自由軟體，您可以遵照自由軟體基金會（ 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 ，上次更新日期 2001-06-08
本頁符合 HTML 4.01 規格