| .\" $Id$ |
| .\" ----------------------------------------------------------------------- |
| .\" |
| .\" 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 iso9660/RockRidge filesystem using |
| the "ZF" compression records. |
| .RP |
| .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). |
| .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\-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. |
| .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 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) |
