繁體中文 | 简体中文 | English

arclog.pl v2.1.0

说明

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

arclog.pl 目前支援 Apache 和 Syslog 两种格式的记录档 ,与 gzip 和 bzip2 两种压缩法。

注意事项

系统需求

  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::FunctionsFile::TempDate::ParseCompress::Zlib 。 如果你没有,可以到 CPAN 程式库 http://search.cpan.org/ 下载安装。
  3. 本程式可以使用下列 perl 模组: Compress::ZlibFile::MMagic 。 如果你要安装,可以到 CPAN 程式库 http://search.cpan.org/ 下载安装。

下载

arclog.pl 的官方网站在:

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

依玛猫的 PGP Public Key 在:

安装

  1. 解压缩:

    % tar -xzf arclog.pl-x.xx.xx.tar.gz
    
  2. 以 autoconf 设定程式安装

    虽然本程式不需要设定,跑一遍 autoconf 设定程式还是有她的好处。设定 程式会检查你的系统环境,告诉你相关的问题。设定程式还会安装说明档,并 支援解除安装的功能。

    到解压缩后的目录中,执行设定程式 configure

    % ./configure
    

    安装程式会检查你的系统环境,并产生 Makefile 。接下来 做 make

    % make
    

    最后,切换到 root 权限,安装程式:

    % su
    Password:
    # make install
    

    这样就好了。你也可以下:

    % ./configure --help
    

    查看有哪些设定选项。

  3. 手动安装

    到解压缩后的目录中,将 arclog.pl 档复制到你要存的目录 下,就可以罗~! ^_*'

  4. 执行

    跑跑看有没有问题。你可以下:

    % ./arclog.pl --help
    

    查看有哪些选项,或下:

    % perldoc arclog.pl
    

    查阅完整的程式说明。

命令列参数

./arclog.pl [参数] 记录档档名... [归档档名开头]
./arclog.pl [-h|-v]
记录档档名
要整理归档的记录档档名。若要从标准输入读记录档,请设定成「 - 」。可同时指定许多档案。可以用 gzipbzip2 压缩档。
归档档名开头
归档档名用的开头,归档后的档案会取名叫「开头.yymmdd 」,如:开头.200101开头.200102 ……等。 如果没有设定,会用记录档的档名当开头。若你要从标准输入读记录档,就一 定要设归档档名开头。这里不能用「 - 」(标准输入),因为 这里设定的是档名的开头,不是档名。
-c, --compress[=压缩法]
设定归档用的压缩法。录大多都长得很像,压缩掉会省下非常多的空间。 (不然干嘛归档? ^_*' )目前支援下列的压缩法:
g, gzip
gzip 压缩。预设是用 gzip 压缩。 arclog.pl 可以用 Compress::Zlib 来代替 gzip 压缩,不用呼叫外部程式,比较快比较安全。不过如果你 没有装 Compress::Zlibarclog.pl 还是会自 己改用 gzip 程式压缩。但如果连 gzip 程式都 没有,却要用到 gzip 压缩,就没有办法了,无法执行。
b, bzip2
bzip2 压缩。因为 Compress::Bzip2 目 前的功能有限,所以 arclog.pl 只用 bzip2 程 式来压缩。如果没有 bzip2 程式,却要用到 bzip2 压缩法,就没有办法了,无法执行。
n, none
不要压缩。(你没搞错吧? :p )
--nocompress
归档后不要压缩,效果和 --compress=none 一样。
-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.

版本纪录

若想了解新增的功能、修补的错误等,请查阅 NEWS.zh-tw 档。若想查阅程式改版的记录,请参考 ChangeLog.zh-tw 档。

错误回报

arclog.plSourceForge 上有一个邮件通讯 Mailing List arclog-users@lists.sourceforge.net ,供大家 讨论、回报问题。加入邮件通讯的网址在 http://lists.sourceforge.net/lists/listinfo/arclog-users 。若有任何 arclog.pl 使用上的问题、建议或错误回报,请先 上该网址,加入邮件通讯后,将问题提到通讯上讨论,谢谢。

依玛猫 <imacat@mail.imacat.idv.tw> 初稿 2001-06-08 ,上次更新日期 2002-09-26

Valid XHTML 1.1! 本页符合 XHTML 1.1 规格