Pixz项目技术文档

1. 安装指南

依赖项

在构建Pixz之前，您需要确保以下依赖项已经安装在您的系统上：

• pthreads
• liblzma 4.999.9-beta-212 或更新版本（来自xz发行版）
• libarchive 2.8 或更新版本
• AsciiDoc（用于生成手册页）

从发布压缩包构建

1. 下载最新版本的Pixz发布压缩包。
2. 解压缩到指定目录。
3. 执行以下命令构建：

./configure
make
make install

您可能需要sudo权限来运行make install。

从GitHub构建

1. 克隆GitHub仓库：

git clone https://github.com/vasi/pixz.git

2. 进入克隆后的目录：

cd pixz

3. 执行以下命令构建：

./autogen.sh
./configure
make
make install

您可能需要sudo权限来运行make install。

2. 项目的使用说明

Pixz是一个支持并行压缩和索引的版本，适用于.xz文件格式。以下是一些基本用法示例：

单个文件

• 压缩单个文件（非tarball，仅压缩），多核：

pixz bar bar.xz

• 解压缩该文件，多核：

pixz -d bar.xz bar

Tarballs

• 压缩并索引一个tarball，多核：

pixz foo.tar foo.tpxz

• 快速列出压缩tarball的内容：

pixz -l foo.tpxz

• 解压缩tarball，多核：

pixz -d foo.tpxz foo.tar

• 快速提取单个文件，多核，同时验证内容与索引是否匹配：

pixz -x dir/file < foo.tpxz | tar x

• 使用Pixz创建tarball进行多核压缩：

tar -Ipixz -cf foo.tpxz foo/

指定输入和输出

以下命令同样适用于-x、-d和-l：

pixz foo.tar foo.tpxz
pixz < foo.tar > foo.tpxz
pixz -i foo.tar -o foo.tpxz

从foo.tpxz提取文件到foo.tar：

pixz -x -i foo.tpxz -o foo.tar file1 file2 ...

压缩到foo.tpxz，删除原始文件：

pixz foo.tar

解压缩到foo.tar，删除原始文件：

pixz -d foo.tpxz

其他选项

• 更快、压缩效果较差：

pixz -1 foo.tar

• 更慢、压缩效果较好：

pixz -9 foo.tar

• 使用确切2个线程：

pixz -p 2 foo.tar

• 压缩，但不将其视为tarball，即不索引：

pixz -t foo.tar

• 解压缩，但不检查内容是否与索引匹配：

pixz -d -t foo.tpxz

• 列出xz块而不是文件：

pixz -l -t foo.tpxz

更多调整选项，请查阅手册页：

man pixz

3. 项目API使用文档

当前Pixz项目未提供API文档。有关使用Pixz的详细信息，请参考项目手册页和readme文件。

4. 项目安装方式

请参考上文“安装指南”部分，了解如何从发布压缩包或GitHub仓库安装Pixz。