繁體中文 | 简体中文 | English

arclog.pl v2.1.0-dev1

最新消息

arclog.pl 最新版本 v2.1.0-dev1 ，可以按 這裏 下載。

說明

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 可以由下列位址下載：

安裝

  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 複製到妳要存的目 錄下，記得設為可執行。 

    % chmod +x 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 依瑪貓。依瑪貓保有所有權利。

本程式是自由軟體，您可以遵照自由軟體基金會（ 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-09-01
HTML 4.01
本頁符合 HTML 4.01 規格