libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

New -zisofs parameters version_2=, block_size_v2=, max_bpt=, max_bpt_f=

Browse Source
This commit is contained in:
Thomas Schmitt
2020-10-14 22:59:35 +02:00
parent 9a7dfd7721
commit dcb13954bd
11 changed files with 349 additions and 6026 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
xorriso/xorriso.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Version 1.5.3, Sep 30, 2020"
.TH XORRISO 1 "Version 1.5.3, Oct 14, 2020"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -3092,21 +3092,59 @@ User id to be used for all files when the new ISO tree gets written to media.
\fB\-gid\fR gid
Group id to be used for all files when the new ISO tree gets written to media.
.TP
\fB\-zisofs\fR option[:options]
\fB\-zisofs\fR parameter[:parameters]
Set global parameters for zisofs compression. This data format is recognized
and transparently uncompressed by some Linux kernels. It is to be applied
via command \-set_filter with built\-in filter "\-\-zisofs".
.br
Note: This command is only permitted while no \-\-zisofs filters are applied to
any files.
.br
Parameters are:
.br
"level="[0\-9] zlib compression: 0=none, 1=fast,..., 9=slow
.br
"block_size="32k|64k|128k size of compression blocks
"block_size="32k|64k|128k sets the size of version 1 compression blocks.
.br
"by_magic=on" enables an expensive test at image generation time which checks
files from disk whether they already are zisofs compressed, e.g. by program
mkzftree.
.br
"default" same as "level=6:block_size=32k:by_magic=off"
"version_2="off|as_needed|on enables the use of experimental version zisofs2
which can encode files of size 4 GiB or larger. The Linux kernel (as of 5.9)
does not yet know this format and will complain like
.br
isofs: Unknown ZF compression algorithm: PZ
.br
The files will then appear in their compressed form with zisofs2 header,
block pointer list, and compressed data.
.br
zisofs2 is recognized by xorriso in files from loaded images and gets equipped
with \-\-zisofs\-decode filters, unless restrictions on the number of
block pointers prevent this.
.br
Mode "off" restricts compression to files smaller than 4 GiB uncompressed size.
Mode "as_needed" uses zisofs2 for larger files. Mode "on" uses zisofs2 for all
zisofs compressed files.
.br
"block_size_v2="32k|64k|128k|256k|512k|1m sets the size of compression blocks
for zisofs2.
.br
"max_bpt="1k|...|128g sets the limit for the overall allocated block pointer
memory. Block pointers occupy virtual memory while a file gets uncompressed
and while a file, which shall be compressed, waits for ISO filesystem creation.
.br
One pointer occupies 8 bytes of memory and governs block_size or block_size_v2
uncompressed bytes.
I.e. with block size 128k, 1m of block pointer memory suffices for 16g of
uncompressed file size.
.br
"max_bpt_f="1k|...|128g sets the limit for the memory size of the block
pointer list of a single file. max_bpt_f is never larger than max_bpt.
If either is set to violate this rule, the other gets set to the same value.
.br
"default" same as "level=6:block_size=32k:by_magic=off:
version_2=off:block_size_v2=128k:max_bpt=256m:max_bpt_f=256m".
.TP
\fB\-speed\fR code|number[k|m|c|d|b]
Set the burn speed. Default is "max" (or "0") = maximum speed as announced
@ -4624,6 +4662,14 @@ Frequently used types are:
cout:'disk_path offset count' for \-cut_out files.
.br
extf:'filter_name' for external filters.
.br
\-\-zisofs:algorithm:block_size for zisofs compression filters.
.br
\-\-zisofs\-decode:algorithm:block_size for zisofs uncompression filters.
.br
\-\-gzip for internal gzip compression filters.
.br
\-\-gunzip for internal gzip uncompression filters.
.br
Example:
.br