zsyncmake - 云端在线

程序：

您的姓名

zsyncmake - 构建控制文件 zsync(1)

句法

zsyncmake [ { -z | ] -Z } ] [ -e ] [ -C ] [ -u 网址 ] [-U 网址 ] [-b 块大小 ] [-o
输出文件 ] [ -F 目标文件名 ] [-v] 文件名

zsync-V

商品描述

为 zsync 客户端程序构造一个元文件，用于执行部分文件
下载。 文件名 是用户希望下载的文件； zsyncmake 构造
适当的元文件和写入 文件名.zsync 在当前目录中。

zsync 至少需要一个 URL 来下载文件内容。 如果 .zsync
会和要下载的文件在同一个目录下，你可以接受默认的——zsync
在控制文件中包含一个相对 URL。 如果没有，请使用 -u 选项来指定 URL。
如果可用，您还应该使用 -U 指定未压缩内容的 URL，如 zsync
有时可以利用它进行更有效的下载。 （您可以编辑 .zsync 文件
然后添加这些 - 它有一个简单的键：标题中的值格式 - 但我建议
您只有在熟悉该工具后才能执行此操作。）

请注意，zsyncmake 本身（当前）不会验证 URL 或下载任何数据，您
必须在本地提供文件数据并自己检查 URL。

配置

-b 块大小
指定底层 rsync 算法的块大小。 较小的块大小可能是
对于可能有很多小而分散的文件的文件更有效
下载之间的变化； 更大的块大小对于具有以下内容的文件更有效
更少或更少的零散变化。 此块大小必须是 XNUMX 的幂。 如果不
指定，zsyncmake 选择它认为最适合此文件的一个（当前
2048 或 4096 取决于文件大小） - 所以通常你不需要
覆盖默认值。

-C 告诉 zsyncmake 不要在 .zsync 中生成任何指令告诉客户端
压缩它收到的数据。 这由 -z 暗示，但此选项位于此处
如果您自己压缩文件仅用于传输，但希望客户端结束
使用未压缩的文件（例如，您正在传输一个 ISO，它被保存在
在服务器上压缩，但客户端不能使用，除非它是
未压缩）。 如果没有 -C，zsyncmake 将为客户端生成指示
在适当的地方压缩它收到的文件； -C 在这里，所以你可以阻止它
告诉客户这样做。

-e 告诉 zsyncmake 客户端必须能够接收到的确切文件
提供。 如果没有这个选项，zsyncmake 只能提供一个较弱的保证——即
客户端将接收它包含的数据（例如，它可能会传输未压缩的
.gz 到客户端的版本）。 请注意，这仍然不能保证
客户端会得到它 - 客户端可以忽略 zsync 文件中的指令，或者
可能无法准确再现所使用的压缩。 但是 -e 你
知道 zsyncmake 使获取确切数据成为可能-它将退出
如果不能，则为错误。

-f 文件名
设置文件名以包含在输出文件中（这就是文件的名称
当用户完成下载时调用）。

-o 输出文件
覆盖默认输出文件名。

-u 网址 指定用户可以从中下载所提供文件内容的 URL。
用户需要控制文件以找出他们的文件的哪些部分
已经有，并且他们需要 URL 来检索文件的一部分
没有。 您可以通过多次指定 -u 来指定多个 URL。
如果未指定，zsync 假定文件和 .zsync 将驻留在
相同的公共目录，并包含一个相对 URL。

-U 网址 指定解压后的文件内容对应的 URL（仅
如果是 gzip 文件则适用）。 zsync 有时可以更有效地下载
来自未压缩数据而不是来自压缩数据 - 它将利用
如果可用的话。 如果未指定 URL，zsync 将查找不带
.gz 扩展名并假设这将与 .zsync 位于同一公共目录中，
并包含它的相对 URL。

-v 启用详细消息。

-V 打印 zsync 的版本。

-z 压缩要传输的文件。 请注意，这会覆盖任何名为
文件名.gz 没有警告（如果你没有给出文件名，例如因为你是
从标准输入读取，然后 zsync 将使用 -f 提供的名称，或作为最后一个
回退，zsync-target.gz）。

zsync 可以处理压缩数据，并且在大多数情况下，数据还没有
压缩，先压缩效率更高。 虽然你可以压缩
使用 gzip 传输的文件，如果您使用此选项，则 zsyncmake 将压缩文件
为您生成一个针对 zsync 优化的 .gz 文件。 这可以提高 30% 的效率
在下载时比使用 gzip --best 压缩 - 但压缩文件不会
与 gzip 产生的一样小。

-Z zsyncmake 自动查找 gzip 压缩文件并导出
底层的未压缩数据到 zsyncmake 文件。 在测试中证明了这一点
提供更高的下载效率。 -Z 覆盖默认行为并处理
gzip 文件只是二进制数据。 如果必须让用户收到，请使用此选项
压缩数据（例如因为加密签名可用
仅适用于压缩数据）。 如果指定 -Z，zsync 通常没有用，除非
gzip 文件是用特殊的 --rsync 选项压缩的，以使其友好
差异转移。

示例

zsyncmake-C-u http://ftp.uk.debian.org/debian/dists/sarge/main/binary-i386/Packages.gz
包.gz

注意使用 -C 来保存客户端在接收时压缩文件； Debian 软件包
系统使用未压缩的文件。

zsyncmake -z 我的颠覆转储

在这种情况下，需要传输一个大的、可压缩的文件。 这将创建一个 gzip
文件的版本（针对 zsync 进行了优化）和一个 .zsync 文件。 自动添加一个 URL
假设这两个文件将从 Web 服务器上的同一目录提供。

zsyncmake-e-u
http://www.mirrorservice.org/sites/ftp.freebsd.org/pub/FreeBSD/ports/distfiles/zsync-0.2.2.tar.gz
zsync-0.2.2.tar.gz

这将创建一个 zsync 引用命名的源 tarball，客户端应该
从给定的 URL 下载。 此示例用于下载源 tarball
FreeBSD 端口，因此指定 -e 以便客户端能够匹配其 md5sum。

作者

科林·菲普斯[电子邮件保护]>

使用 onworks.net 服务在线使用 zsyncmake