正體中文 | 简体中文 | English

:::

mpresent 0.01 版

最新消息

2007-12-03

arclog 最新版本 0.01 。说明文件修正。若你之前安装了 arclog 3.00 版或之后的版本,不需要升级新版。下载 arclog 0.01 版

2007-12-03

arclog 最新版本 3.03 。修正测试套件。所需 Perl 版本号码改用相容於旧版的号码格式,以消除 Perl 5.10 的警告讯息。若你之前安装了 arclog 3.00 版或之后的版本,不需要升级新版。下载 arclog 3.03 版

2007-11-30

arclog 最新版本 3.02 。修正测试套件,以处理日光节约时间问题。若你之前安装了 arclog 3.00 版或之后的版本,不需要升级新版。下载 arclog 3.02 版

2007-11-28

arclog 最新版本 3.01 。修正测试套件,以协助厘清 CPAN 测试回报的错误。若你之前安装了 arclog 3.00 版,不需要升级新版。下载 arclog 3.01 版

2007-11-28

arclog 最新版本 3.00 。从 reslog 借过来的全新程式码,档名也从 arclog.pl 改为 arclog 。新的物件导向处理器,可顺利处理各种压缩法及档案格式。安装系统由 GNU autoconf 改用 PerlExtUtils::MakeMakerModule::Build 。新加上完整的测试套件,协助程式品管。版权更新为 GPLv3下载 arclog 3.00 版

2002-09-26

arclog.pl 最新版本 2.1.0 。这是 2.1.0 的最终版,加上了 bzip2 压缩的支援,用 gzip 程式代替 Compress::Zlib 压缩,并改用 GNU autoconf 安装设定程式。下载 arclog.pl 2.1.0

2002-09-18

arclog.pl 最新版本 2.1.0dev2 。本版修正了几个说明文件的错误,并把 SourceForge 加进 arclog.pl 的下载网址中。你可以把它当做申请 SourceForge 纪念版。原则上,不需要急著升级。下载 arclog.pl 2.1.0dev2

2002-09-17

好消息! arclog.pl 已开始架设於 SourceForge 罗!(虽然我几乎还完全搞不清楚要怎么架…摸索中… ^^; )

说明

arclog 是记录档每月归档程式,将记录档中,前月的记录按月份压缩归档,以节省硬碟空间,并避免记录档被有心人士破坏。

arclog 目前支援 ApacheSyslogNTPApache 1 SSL engine log 及我自己用的括弧 ISO 修正格式五种格式的记录档,与 gzipbzip2 两种压缩法。很多程式都可以用 Apache 相容记录档格式记录,如 CUPSProFTPDPure-FTPd…等, arclog 也可以归档这些 Apache 相容格式的记录档。

注意事项

系统需求

  1. Perl 5.8.0 以上。 arclog 用三个参数的 open() 来复制档案操作,我还不知道怎么改写到更早的版本上执行。若你可以改写到更早的版本上执行,请告诉我。你可以输入 perl -v 查询你目前的 Perl 版本。如果你没有 Perl 或需要升级,可以到 Perl 网站下载安装最新版 Perl 。若你是用 MS-Windows ,可以到 ActiveState 公司下载 ActivePerl 安装。

  2. 需搭配的 Perl 模组:

    Date::Parse

    这是辨识记录时间用的。你可以CPAN 模组库下载安装 Date::Parse ,或用 CPAN Shell 执行 cpan Date::Parse 安装,或用 CPANPLUS Shell 执行 cpanp i Date::Parse 安装。若你是 Debian/Ubandu Linux 使用者,可以执行 apt-get install libtimedate-perl 安装。若你是 Red Hat/Fedora/CentOS Linux 使用者,可以执行 yum install perl-TimeDate 安装。若你是 FreeBSD 使用者,可以执行 ports install p5-TimeDate 安装。若你是 ActivePerl 使用者,可以执行 ppm install Date::Parse 安装。

  3. 选配的 Perl 模组:

    File::MMagic

    这是检查档案类型用的。若没有安装, arclog 会找 file 程式代替。若还找不到, arclog 会改用档尾(副档名)判断档案类型。这时若从标准输入读档, arclog 就无法判断了。你可以CPAN 模组库下载安装 File::MMagic ,或用 CPAN Shell 执行 cpan File::MMagic 安装,或用 CPANPLUS Shell 执行 cpanp i File::MMagic 安装。若你是 Debian/Ubandu Linux 使用者,可以执行 apt-get install libfile-mmagic-perl 安装。若你是 Red Hat/Fedora/CentOS Linux 使用者,可以执行 yum install perl-File-MMagic 安装。若你是 FreeBSD 使用者,可以执行 ports install p5-File-MMagic 安装。若你是 ActivePerl 使用者,可以执行 ppm install File::MMagic 安装。若你要在 MS-Windows 下使用 file.exe 程式,可以由 GnuWin32 网站下载。请确认下载后,存档在系统的路径下,档名为 file.exe

    建议用 File::MMagicfile 程式偶尔会误判。

    Compress::Zlib

    这是处理 gzip 压缩档用的,只有在处理 gzip 压缩档才会用到。若要用时没有安装, arclog 会试著改用 gzip 程式代替。若还找不到, arclog 就无法执行。你可以CPAN 模组库下载安装 Compress::Zlib ,或用 CPAN Shell 执行 cpan Compress::Zlib 安装,或用 CPANPLUS Shell 执行 cpanp i Compress::Zlib 安装。若你是 Debian/Ubandu Linux 使用者,可以执行 apt-get install libcompress-zlib-perl 安装。若你是 Red Hat/Fedora/CentOS Linux 使用者,可以执行 yum install perl-Compress-Zlib 安装。若你是 FreeBSD 使用者,可以执行 ports install p5-Compress-Zlib 安装。若你是 ActivePerl 使用者,可以执行 ppm install Compress::Zlib 安装。若你要在 MS-Windows 下使用 gzip.exe 程式,可以由 gzip 网站下载。请确认下载后,存档在系统的路径下,档名为 gzip.exe

    Compress::Bzip2 第二版以上

    这是处理 bzip2 压缩档用的,只有在处理 bzip2 压缩档才会用到。若要用时没有安装, arclog 会试著改用 bzip2 程式代替。若还找不到, arclog 就无法执行。你可以CPAN 模组库下载安装 Compress::Bzip2 ,或用 CPAN Shell 执行 cpan Compress::Bzip2 安装,或用 CPANPLUS Shell 执行 cpanp i Compress::Bzip2 安装。若你是 Debian/Ubandu Linux 使用者,可以执行 apt-get install libcompress-bzip2-perl 安装。若你是 Red Hat/Fedora/CentOS Linux 使用者,可以执行 yum install perl-Compress-Bzip2 安装。若你是 FreeBSD 使用者,可以执行 ports install p5-Compress-Bzip2 安装。若你是 ActivePerl 使用者,可以执行 ppm install Compress::Bzip2 安装。若你要在 MS-Windows 下使用 bzip2.exe 程式,可以由 bzip2 网站下载。请确认下载后,存档在系统的路径下,档名为 bzip2.exe

    Term::ReadKey

    这是显示进度列用的,若没有安装,就不会显示进度列。此外不会有任何问题。进度列可以让你对 arclog 的工作进度一目了然。你可以CPAN 模组库下载安装 Term::ReadKey ,或用 CPAN Shell 执行 cpan Term::ReadKey 安装,或用 CPANPLUS Shell 执行 cpanp i Term::ReadKey 安装。若你是 Debian/Ubandu Linux 使用者,可以执行 apt-get install libterm-readkey-perl 安装。若你是 Red Hat/Fedora/CentOS Linux 使用者,可以执行 yum install perl-TermReadKey 安装。若你是 FreeBSD 使用者,可以执行 ports install p5-Term-ReadKey 安装。若你是 ActivePerl 使用者,可以执行 ppm install Term::ReadKey 安装。

下载

arclog 的官方网站在:

最新版 arclog 可由下列位址下载:

依玛猫的 PGP 公钥在:

安装

若你是由 arclog.pl 2.1.1dev4 以前的版本升级,请参阅 UPGRADE.zh-cn 档的升级说明。

ExtUtils::MakeMaker 安装

arclogPerl 标准的 ExtUtils::MakeMaker 安装,程序如下:

% perl Makefile.PL
% make
% make test
% make install

make install 前,请先确认你有在安装目录存档的权限。通常这时候要切换为 root ,才能安装存档。

若你是用 MS-Windows 下的 ActivePerlmake 请改用 nmakenmake 可由微软的 FTP 站下载

若要安装到其它地方,请设定好 PREFIX 。例如,一般使用者,要安装在自己的目录下时:

% perl Makefile.PL PREFIX=/home/jessica

要知道更多安装选项的细节,请参阅 ExtUtils::MakeMaker 的说明(请执行 perldoc ExtUtils::MakeMaker )。

Module::Build 安装

若你喜欢,也可以用 Module::Build 安装,程序如下:

% perl Build.PL
% ./Build
% ./Build test
% ./Build install

./Build install 前,请先确认你有在安装目录存档的权限。通常这时候要切换为 root ,才能安装存档。

若要安装到其它地方,请设定好 --prefix 。例如,一般使用者,要安装在自己的目录下时:

% perl Build.PL --prefix=/home/jessica

要知道更多安装选项的细节,请参阅 Module::Build 的说明(请执行 perldoc Module::Build )。

命令列参数

./arclog [参数] 记录档档名… [归档档名开头]
./arclog [-h|-v]
记录档档名

要整理归档的记录档档名。若要从标准输入读记录档,请设定成 - 。可同时指定许多档案。支援 gzipbzip2 压缩档。

归档档名开头

归档档名用的开头,归档后的档案会取名叫开头.yymmdd,如:开头.200101开头.200102 …等。如果没有设定,会用记录档的档名当开头。若你要从标准输入读记录档,就一定要设归档档名开头。这里不能用 - (标准输入),因为这里设定的是档名的开头,不是档名。

-c, --compress 压缩法

设定归档用的压缩法。记录大多都长得很像,压缩掉会省下非常多的空间。(不然干嘛归档? ^_*’ )目前支援下列的压缩法:

g, gzip

gzip 压缩。预设是用 gzip 压缩。 arclog 可以用 Compress::Zlib 来代替 gzip 压缩,不用呼叫外部程式,比较快比较安全。不过如果你没有装 Compress::Zlibarclog 还是会自己改用 gzip 程式压缩。但如果连 gzip 程式都没有,却要用到 gzip 压缩,就没有办法了,无法执行。

b, bzip2

bzip2 压缩。 arclog 可以用 Compress::Bzip2 来代替 bzip2 压缩,不用呼叫外部程式,比较快比较安全。不过如果你没有装 Compress::Bzip2arclog 还是会自己改用 bzip2 程式压缩。但如果连 bzip2 程式都没有,却要用到 bzip2 压缩,就没有办法了,无法执行。

n, none

不要压缩。(你没搞错吧? :p )

--nocompress

归档后不要压缩,效果和 --compress none 一样。

-s, --sort

按记录时间先后(及记录本身顺序)排序。排序很耗记忆体和 CPU ,所以预设是不排序。请参见前面关於排序的注意事项。

--nosort

不要排序(预设值)。

-o, --override 模式

如果有同名的旧档,该怎么办。目前有下列模式:

o, overwrite

盖掉旧档。旧档的记录会被删掉,请多加小心。若你的记录档是主记录档,有最完整的记录,你可以用 overwrite

a, append

和旧档加在一起。这有可能会演变成大混乱,请多加小心。若你想把两份不同时间的记录档加在一起,你可以用 append

i, ignore

略过所有该月的记录。这有可能造成部份记录流失,请多加小心。若你只要补充没有归档的月份,你可以用 ignore

f, fail

结束程式,以免不小心破坏旧档。若你要用 crontab 之类的程式,全自动化执行,最好这样,以免破坏资料。因此,若标准输入不是连到键盘上,预设是 fail

ask

问你该怎么办。若你是手动执行,这样最方便。因此,若标准输入是连到键盘上,预设是 ask 。答案是从标准输入读的。因为标准输入只有一个,若你要从标准输入读记录档,不能跑 ask 模式,会自动退回 fail 模式。还有,如果从标准输入读不到东西,像 crontab 里标准输入被关掉了,也会自动退回 fail 模式。

-k, --keep 模式

原记录档要怎么处理。目前有下列模式:

a, all

完全保留原档。

r, restart

归档后,原记录档归零。

d, delete

归档后,删除原记录档。

t, this-month

将之前月份的记录归档,保留这个月的记录,留待下个月归档。这是给 crontab 每月归档用的。因此,预设是 this-month

-d, --debug

显示详细的执行过程。

-q, --quiet

没事不要吵。 :p

-h, --help

显示程式说明。

-v, --version

显示程式版本。

版权声明

版权所有 © 2001-2007 依玛猫。

本程式是自由软体,您可以遵照自由软体基金会 (Free Software Foundation) 出版的 GNU 通用公共许可证条款 (GNU General Public License) 第三版来修改和重新发布这一程式,或者自由选择使用任何更新的版本。

发布这一程式的目的是希望它有用,但没有任何担保。甚至没有适合特定目的而隐含的担保。更详细的情况请参阅 GNU 通用公共许可证

您应该已经和程式一起收到一份 GNU 通用公共许可证的副本。如果还没有,参阅<http://www.gnu.org/licenses/>

版本纪录

请阅读 NEWS 档,查看程式的演变、新增的功能和修补的错误。

支援协助

arclog 网站架在 SourceForgeCPAN旅舍依玛。索取最新资讯,请驾临:

SourceForge 上有一个 arclog 的邮件通讯 。使用上的问题、建议或错误回报,请提到通讯上讨论。它是 Mailman 的邮件通讯。若要加入,请到 arclog 邮件通讯的网页 。你也可以写信到 E-mail 指令信箱,标题填上 help ,索取 E-mail 指令说明。