繁體中文 | 简体中文 | English

arclog.pl v2.0.1

說明

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

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

注意事項

歸類記錄檔很耗時間。自 2.0.0 版以後，會先把原記錄檔複製到暫時工作檔，視需要把原記錄檔歸零，再慢慢在暫時工作檔上作業。這樣可以將佔用原記錄檔的時間減到最低，就不用其她的記錄檔歸零程式了。不過仍請注意下列事項：一、如果原記錄檔很大（好幾十 MB ），光複製檔案還是很花時間。這時，最好還是先關閉記錄程式，等整理完以後，再繼續記錄，以避免記錄錯亂。若平常有定期歸檔，記錄檔就不會無限制膨脹了。二、若執行到一半因故中斷，會留下殘存的暫時工作檔。日後執行時，若碰到之前殘存的暫時工作檔，程式會立刻停止。要先處理掉之前的暫時工作檔，才能繼續。妳可以改個檔名，當成另外一個記錄檔來歸檔，就可以了。
妳可以用 --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 可以由下列位址下載：

旅舍依瑪的 FTP: ftp://ftp.imacat.idv.tw/pub/arclog.pl/
arclog.pl 的網頁: http://www.imacat.idv.tw/linux/arclog.pl.html

安裝

解壓縮：
```
% 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 模式。

--keep=模式

原記錄檔要怎麼處理。目前有下列模式：

all: 歸檔後，原記錄檔不動。預設是 all 。
restart: 歸檔後，原記錄檔歸零。
delete: 歸檔後，刪除原記錄檔。
this-month: 將之前月份的記錄歸檔，保留這個月的記錄，留待下個月歸檔。這是給 crontab 每月歸檔用的。

-d, --debug

顯示詳細的執行過程。

-q, --quiet

沒事不要吵。 :p

-h, --help

顯示程式說明。

-v, --version

顯示程式版本。

版權聲明

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

arclog.pl v2.0.1

最新消息

說明

注意事項

系統需求

下載

安裝

解壓縮：

以自動安裝程式安裝（強烈推薦）

手動安裝

執行

命令列參數

版權聲明

版本紀錄