Last minute correction in xorriso man page

This commit is contained in:
Thomas Schmitt 2009-04-18 15:00:41 +00:00
parent 724d61a4b8
commit 789cbcd3c0

View File

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Apr 14, 2009" .TH XORRISO 1 "Apr 18, 2009"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -497,7 +497,7 @@ the history of previous input lines.
.br .br
See man readline for more info about libreadline. See man readline for more info about libreadline.
.PP .PP
Option -page activates a builtin result text pager which may be convenient in Option -page activates a built-in result text pager which may be convenient in
dialog. After an action has put out the given number of terminal lines, dialog. After an action has put out the given number of terminal lines,
the pager prompts the user for a line of input. the pager prompts the user for a line of input.
.br .br
@ -1137,7 +1137,7 @@ External filters may also be banned totally at compile time of xorriso.
By default they are banned if xorriso runs under setuid permission. By default they are banned if xorriso runs under setuid permission.
.TP .TP
\fB\-set_filter\fR name iso_rr_path [***] \fB\-set_filter\fR name iso_rr_path [***]
Apply an -external_filter or a builtin filter to the given data files in the Apply an -external_filter or a built--in filter to the given data files in the
ISO image. ISO image.
If the filter suffix is not empty , then it will be applied to the file name. If the filter suffix is not empty , then it will be applied to the file name.
Renaming only happens if the filter really gets attached and is not revoked by Renaming only happens if the filter really gets attached and is not revoked by
@ -1166,7 +1166,7 @@ Builtin filters are "--zisofs" and "--zisofs-decode". The former is to be
applied via -set_filter, the latter is automatically applied if zisofs applied via -set_filter, the latter is automatically applied if zisofs
compressed content is detected with a file when loading the ISO image. compressed content is detected with a file when loading the ISO image.
.br .br
Another builtin filter pair is "--gzip" and "--gunzip" with suffix ".gz". Another built-in filter pair is "--gzip" and "--gunzip" with suffix ".gz".
They behave about like external gzip and gunzip but avoid forking a process They behave about like external gzip and gunzip but avoid forking a process
for each single file. So they are much faster if there are many small files. for each single file. So they are much faster if there are many small files.
.TP .TP
@ -1657,7 +1657,7 @@ of different type. Nevertheless those hops can loop. Example:
.br .br
\fB$\fR ln -s .. uploop \fB$\fR ln -s .. uploop
.br .br
Link hopping has a builtin loop detection which stops hopping at the first Link hopping has a built-in loop detection which stops hopping at the first
repetition of a link target. Then the repeated link is handled as itself repetition of a link target. Then the repeated link is handled as itself
and not as its target. and not as its target.
Regrettably one can construct link networks which Regrettably one can construct link networks which
@ -1805,7 +1805,7 @@ Group id to be used for all files when the new ISO tree gets written to media.
\fB\-zisofs\fR option[:options] \fB\-zisofs\fR option[:options]
Set global parameters for zisofs compression. This data format is recognized Set global parameters for zisofs compression. This data format is recognized
and transparently uncompressed by some Linux kernels. It is to be applied and transparently uncompressed by some Linux kernels. It is to be applied
via option -set_filter with builtin filter "--zisofs". via option -set_filter with built-in filter "--zisofs".
Parameters are: Parameters are:
.br .br
"level="[0-9] zlib compression: 0=none, 1=fast,..., 9=slow "level="[0-9] zlib compression: 0=none, 1=fast,..., 9=slow
@ -3333,6 +3333,10 @@ the old one.
.br .br
This makes sense if the full backup leaves substantial remaining capacity This makes sense if the full backup leaves substantial remaining capacity
on media and if the expected changes are much smaller than the full backup. on media and if the expected changes are much smaller than the full backup.
To apply zisofs compression to those data files which get newly copied from
the local filesystem, perform immediately before -commit :
.br
-find / -type f -lba_range -1 2000000000 -exec set_filter --zisofs --
.br .br
Option -disk_dev_ino depends on stable device and inode numbers on disk. Option -disk_dev_ino depends on stable device and inode numbers on disk.
Without it, an update run will probably save no time but last longer than Without it, an update run will probably save no time but last longer than