-zchunk (1.1.6+ds1-2) UNRELEASED; urgency=medium
+zchunk (1.1.7+ds1-1) UNRELEASED; urgency=medium
* Reformat the source of the autopkgtest using black 20.
* Add a trivial git-buildpackage config file.
+ * New upstream release:
+ - drop the unzck-require-ext patch, merged upstream
+ - drop the debian/*.1 manual pages, merged upstream
+ - update the upstream copyright years
-- Peter Pentchev <roam@debian.org> Thu, 22 Oct 2020 15:59:58 +0300
Files: *
Copyright:
- 2018 Jonathan Dieter <jdieter@gmail.com>
+ 2018, 2020 Jonathan Dieter <jdieter@gmail.com>
+License: BSD-2-clause
+
+Files: doc/unzck.1
+ doc/zck.1
+ doc/zck_delta_size.1
+ doc/zck_gen_zdict.1
+ doc/zck_read_header.1
+ doc/zckdl.1
+Copyright:
+ (c) 2020 Peter Pentchev <roam@ringlet.net>
License: BSD-2-clause
Files: src/lib/buzhash/*
+++ /dev/null
-unzck-require-ext.patch
+++ /dev/null
-Description: unzck: require a *.zck extension.
-Forwarded: https://github.com/zchunk/zchunk/pull/26
-Author: Peter Pentchev <roam@ringlet.net>
-Last-Update: 2020-06-01
-
---- a/src/unzck.c
-+++ b/src/unzck.c
-@@ -120,6 +120,13 @@
-
- zck_set_log_level(arguments.log_level);
-
-+ if(!arguments.std_out) {
-+ if(strlen(arguments.args[0]) < 5 ||
-+ strcmp(arguments.args[0] + strlen(arguments.args[0]) - 4, ".zck") != 0) {
-+ dprintf(STDERR_FILENO, "Not a *.zck file: %s\n", arguments.args[0]);
-+ exit(1);
-+ }
-+ }
- int src_fd = open(arguments.args[0], O_RDONLY);
- if(src_fd < 0) {
- dprintf(STDERR_FILENO, "Unable to open %s\n", arguments.args[0]);
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt UNZCK 1
-.Os
-.Sh NAME
-.Nm unzck
-.Nd decompress a file in the zchunk format
-.Sh SYNOPSIS
-.Nm
-.Op Fl c | Fl -stdout
-.Op Fl -dict
-.Op Fl v | Fl -verbose
-.Ar file
-.Nm
-.Fl ? | Fl -help
-.Nm
-.Fl -usage
-.Nm
-.Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility extracts the original file from a zchunk-compressed one.
-.Pp
-.Em NOTE:
-The
-.Nm
-utility will place the new file without the
-.Pa .zck
-extension in the
-.Em current
-working directory, not in the directory where the original file resides.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl c , Fl -stdout
-Extract the data to the standard output stream, do not write it to a file.
-.It Fl -dict
-Only extract the zstd compression dictionary.
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Create (in the current directory) an uncompressed
-.Pa words
-file from a compressed one:
-.Pp
-.Dl unzck /mnt/xfer/words.zck
-.Pp
-Do not create the
-.Pa words
-file, but send the contents to the standard output stream:
-.Pp
-.Dl unzck -c /mnt/xfer/words.zck
-.Pp
-.Sh SEE ALSO
-.Xr zck 1 ,
-.Xr zck_delta_size 1 ,
-.Xr zck_gen_zdict 1 ,
-.Xr zck_read_header 1 ,
-.Xr zckdl 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
+++ /dev/null
-debian/unzck.1
-debian/zck.1
-debian/zck_delta_size.1
-debian/zck_gen_zdict.1
-debian/zck_read_header.1
-debian/zckdl.1
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt ZCK 1
-.Os
-.Sh NAME
-.Nm zck
-.Nd compress a file using the zchunk format
-.Sh SYNOPSIS
-.Nm
-.Op Fl D Ar file | Fl -dict Ns = Ns Ar file
-.Op Fl m Ar chunk | Fl -manual Ns = Ns Ar chunk
-.Op Fl o Ar file | Fl -output Ns = Ns Ar file
-.Op Fl s Ar string | Fl -split Ns = Ns Ar string
-.Op Fl v | Fl -verbose
-.Ar file
-.Nm
-.Fl ? | Fl -help | Fl -usage | Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility creates a new zchunk file from the data in the specified input file.
-.Pp
-.Em NOTE:
-If no output file is specified using the
-.Fl o
-option, the
-.Nm
-utility will place the new file with the
-.Pa .zck
-extension in the
-.Em current
-working directory, not in the directory where the original file resides.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl D , Fl -dict
-Set the zstd compression dictionary to the specified file.
-.It Fl m , Fl -manual
-Do not do any automatic chunking (implies
-.Fl s ) .
-.It Fl o , Fl -output
-Output to the specified file.
-.It Fl s , Fl -split
-Split chunks at the beginning of the specified string.
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Create (in the current directory) a zchunk-compressed
-.Pa words.zck
-file from a dictionary:
-.Pp
-.Dl zck /usr/share/dict/words
-.Pp
-The same, but specify an output file:
-.Pp
-.Dl zck -o /tmp/words.txt.zck /usr/share/dict/words
-.Pp
-Generate a zchunk file with chunks separated on HTML sections:
-.Pp
-.Dl zck -s '<h2>' doc.html
-.Pp
-.Sh SEE ALSO
-.Xr unzck 1 ,
-.Xr zck_delta_size 1 ,
-.Xr zck_gen_zdict 1 ,
-.Xr zck_read_header 1 ,
-.Xr zckdl 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt ZCK_DELTA_SIZE 1
-.Os
-.Sh NAME
-.Nm zck_delta_size
-.Nd calculate the differences between two zchunk files
-.Sh SYNOPSIS
-.Nm
-.Op Fl v | Fl -verbose
-.Ar file1
-.Ar file2
-.Nm
-.Fl ? | Fl -help | Fl -usage | Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility examines two zchunk compressed files and determines how similar
-they are: how many chunks are the same between the files, so that tools
-like e.g.
-.Xr rsync 1
-or
-.Xr zckdl 1
-could only transfer the small parts that differ instead of the full files.
-This is especially useful for structured files that have been compressed
-using the
-.Xr zck 1
-tool's
-.Fl s Po Fl -split Pc
-option.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Examine two zchunk files:
-.Pp
-.Dl zck_delta_size doc1.txt.zck doc2.txt.zck
-.Pp
-.Sh SEE ALSO
-.Xr unzck 1 ,
-.Xr zck 1 ,
-.Xr zck_gen_zdict 1 ,
-.Xr zck_read_header 1 ,
-.Xr zckdl 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt ZCK_GEN_ZDICT 1
-.Os
-.Sh NAME
-.Nm zck_gen_zdict
-.Nd extract a dictionary and optionally the separate chunks from a zdict file
-.Sh SYNOPSIS
-.Nm
-.Op Fl d Ar directory | Fl -dir Ns = Ns Ar directory
-.Op Fl v | Fl -verbose
-.Ar file
-.Nm
-.Fl ? | Fl -help | Fl -usage | Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility reads the specified zchunk file, extracts the dictionary used
-during the compression, and optionally uncompresses the individual chunks
-into the specified directory.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl d , Fl -dir
-In addition to extracting the dictionary, uncompress the individual chunks
-as sequential files into the specified directory.
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Extract a zchunk file's dictionary into the
-.Pa words.txt.zdict
-file:
-.Pp
-.Dl zck_gen_zdict words.txt.zck
-.Pp
-Extract the dictionary into
-.Pa words.txt.zdict
-and also the chunks into the
-.Pa chunks/
-directory:
-.Pp
-.Dl zck_gen_zdict -d chunks/ words.txt.zck
-.Pp
-.Sh SEE ALSO
-.Xr unzck 1 ,
-.Xr zck 1 ,
-.Xr zck_delta_size 1 ,
-.Xr zck_read_header 1 ,
-.Xr zckdl 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt ZCK_READ_HEADER 1
-.Os
-.Sh NAME
-.Nm zck_read_header
-.Nd display information from the header of a zchunk file
-.Sh SYNOPSIS
-.Nm
-.Op Fl c | Fl -show-chunks
-.Op Fl f | Fl -verify
-.Op Fl q | Fl -quiet
-.Op Fl v | Fl -verbose
-.Ar file
-.Nm
-.Fl ? | Fl -help | Fl -usage | Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility reads a zchunk file's header and displays some of the information
-recorded there.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl c , Fl -show-chunks
-Display information about the individual chunks, too.
-.It Fl f , Fl -verify
-Instead of only reading the zchunk file's header, read the whole file and
-verify its integrity.
-.It Fl q , Fl -quiet
-Quiet operation; only display error messages.
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Examine a zchunk file's header:
-.Pp
-.Dl zck_delta_size doc.txt.zck
-.Pp
-.Sh SEE ALSO
-.Xr unzck 1 ,
-.Xr zck 1 ,
-.Xr zck_delta_size 1 ,
-.Xr zck_gen_zdict 1 ,
-.Xr zckdl 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
+++ /dev/null
-.\" Copyright (c) 2020 Peter Pentchev <roam@ringlet.net>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright notice,
-.\" this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright notice,
-.\" this list of conditions and the following disclaimer in the documentation
-.\" and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd May 31, 2020
-.Dt ZCKDL 1
-.Os
-.Sh NAME
-.Nm zckdl
-.Nd download a zchunk file
-.Sh SYNOPSIS
-.Nm
-.Op Fl -fail-no-ranges
-.Op Fl q | Fl -quiet
-.Op Fl s Ar file | Fl -source Ns = Ns Ar file
-.Op Fl v | Fl -verbose
-.Ar url
-.Nm
-.Fl ? | Fl -help | Fl -usage | Fl -version
-.Sh DESCRIPTION
-The
-.Nm
-utility attempts to download a zchunk file in an optimized way,
-taking into consideration the chunked structure.
-.Pp
-The
-.Nm
-utility accepts the following optional arguments:
-.Pp
-.Bl -tag -width indent
-.It Fl -fail-no-ranges
-If the server does not support ranges, fail instead of downloading
-the whole file.
-.It Fl q | Fl -quiet
-Quiet operation; only display warning and error messages.
-If specified twice, only display error messages.
-.It Fl s | Fl -source
-Specify the file to use as a source with the premise that most of
-the chunks in the downloaded file will be the same.
-.It Fl v , Fl -verbose
-Verbose operation; display some diagnostic output.
-.It Fl ? , Fl -help
-Display program usage information and exit.
-.It Fl -usage
-Display brief program usage information and exit.
-.It Fl -version
-Display program version information and exit.
-.El
-.Sh EXIT STATUS
-.Ex -std
-.Sh EXAMPLES
-Download a zchunk file that is hopefully not much different from
-the previous version:
-.Pp
-.Dl zckdl -s doc1.txt.zck https://example.com/doc2.txt.zck
-.Pp
-.Sh SEE ALSO
-.Xr unzck 1 ,
-.Xr zck 1 ,
-.Xr zck_delta_size 1 ,
-.Xr zck_gen_zdict 1 ,
-.Xr zck_read_header 1
-.Sh AUTHOR
-The
-.Nm
-utility was written by
-.An Jonathan Dieter Aq jdieter@gmail.com .
-This manual page stub was written by
-.An Peter Pentchev Aq roam@ringlet.net .
projects / zchunk.git / commitdiff