summaryrefslogtreecommitdiff
path: root/3rd-party/zisofs_tools/mkzftree.1
diff options
context:
space:
mode:
Diffstat (limited to '3rd-party/zisofs_tools/mkzftree.1')
-rw-r--r--3rd-party/zisofs_tools/mkzftree.1120
1 files changed, 120 insertions, 0 deletions
diff --git a/3rd-party/zisofs_tools/mkzftree.1 b/3rd-party/zisofs_tools/mkzftree.1
new file mode 100644
index 0000000..fcd3d15
--- /dev/null
+++ b/3rd-party/zisofs_tools/mkzftree.1
@@ -0,0 +1,120 @@
+.\" $Id: mkzftree.1,v 1.13 2004/07/20 04:03:53 hpa Exp $
+.\" -----------------------------------------------------------------------
+.\"
+.\" Copyright 2001 H. Peter Anvin - All Rights Reserved
+.\"
+.\" This program is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation, Inc., 675 Mass Ave, Cambridge MA 02139,
+.\" USA; either version 2 of the License, or (at your option) any later
+.\" version; incorporated herein by reference.
+.\"
+.\" -----------------------------------------------------------------------
+.TH MKZFTREE "1" "30 July 2001" "zisofs-tools" "H. Peter Anvin"
+.SH NAME
+mkzftree \- Create a zisofs/RockRidge compressed file tree
+.SH SYNOPSIS
+.B mkzftree
+[\fIOPTIONS\fR]... \fIINPUT\fR \fIOUTPUT\fR
+.SH DESCRIPTION
+.PP
+Takes an input file tree (\fIINPUT\fR) and create a corresponding
+compressed file tree (\fIOUTPUT\fR) that can be used with an
+appropriately patched
+.BR mkisofs (8)
+to create a transparent-compression ISO 9660/Rock Ridge filesystem using
+the "ZF" compression records.
+.SH OPTIONS
+.TP
+\fB\-f\fP, \fB\-\-force\fP
+Always compress all files, even if they get larger when compressed.
+.TP
+\fB\-z\fP \fIlevel\fP, \fB\-\-level\fP \fIlevel\fP
+Select compression level (1-9, default is 9). Lower compression
+levels are faster, but typically result in larger output.
+.TP
+\fB\-u\fP, \fB\-\-uncompress\fP
+Uncompress an already compressed tree. This can be used to read a
+compressed filesystem on a system which cannot read them natively.
+.TP
+\fB\-p\fP \fIparallelism\fP, \fB\-\-parallelism\fP \fIparallelism\fP
+Compress in parallel. The
+.I parallelism
+value indicates how many compression threads are allowed to run.
+.TP
+\fB\-x\fP, \fB\-\-one-filesystem\fP
+Do not cross filesystem boundaries, but create directory stubs at
+mount points.
+.TP
+\fB\-X\fP, \fB\-\-strict-one-filesystem\fP
+Do not cross filesystem boundaries, and do not create directory stubs
+at mount points.
+.TP
+\fB\-C\fP \fIpath\fP, \fB\-\-crib-path\fP \fIpath\fP
+Steal ("crib") files from another directory if it looks (based on
+name, size, type and modification time) like they match entries in the
+new filesystem. The "crib tree" is usually the compressed version of
+an older version of the same workload; this thus allows for
+"incremental rebuilds" of a compressed filesystem tree. The files are
+hardlinked from the crib tree to the output tree, so if it is
+desirable to keep the link count correct the crib path should be
+deleted before running \fBmkisofs\fP. The crib tree must be on the
+same filesystem as the output tree.
+.TP
+\fB\-l\fP, \fB\-\-local\fP
+Do not recurse into subdirectories, but create the directories
+themselves.
+.TP
+\fB\-L\fP, \fB\-\-strict-local\fP
+Do not recurse into subdirectories, and do not create directories.
+.TP
+\fB\-F\fP, \fB\-\-file\fP
+Indicates that \fIINPUT\fP may not necessarily be a directory; this
+allows operation on a single file. Note especially that if \fI\-F\fP
+is specified, and \fIINPUT\fP is a symlink, the symlink itself will be
+copied rather than whatever it happens to point to.
+.TP
+\fB\-s\fP, \fB\-\-sloppy\fP
+Treat file modes, times and ownership data as less than precious
+information and don't abort if they cannot be set. This may be useful
+if running
+.B mkisofs
+on an input tree you do not own.
+.TP
+\fB\-v\fP, \fB\-\-verbose\fP
+Increase the program verbosity.
+.TP
+\fB\-V\fP \fIvalue\fP, \fB\-\-verbosity\fP \fIvalue\fP
+Set the program verbosity to
+.IR value .
+.TP
+\fB\-q\fP, \fB\-\-quiet\fP
+Issue no messages whatsoever, including error messages. This is the same
+as specifying
+.IR "\-V\ 0" .
+.TP
+\fB\-h\fP, \fB\-\-help\fP
+Display a brief help message.
+.TP
+\fB\-w\fP, \fB\-\-version\fP
+Display the release version.
+.SH BUGS
+Long options (beginning with \fI\-\-\fP) may not work on all systems.
+See the message printed out by \fImkzftree\ \-h\fP to see if this
+applies to your system.
+.PP
+Inode change times (ctimes) are not copied. This is a system
+limitation and applies to all file copy programs.
+.PP
+If using the parallel option (\fI\-z\fP) the access times (atimes) on
+directories may or may not be copied. If it is important that the
+atimes on directories are copied exactly, avoid using \fI\-z\fP.
+.SH AUTHOR
+Written by H. Peter Anvin <hpa@zytor.com>.
+.SH COPYRIGHT
+Copyright \(co 2001-2002 H. Peter Anvin.
+.br
+This is free software; see the source for copying conditions. There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+.SH "SEE ALSO"
+.BR mkisofs (8)