1MKZFTREE(1)                     H. Peter Anvin                     MKZFTREE(1)
2
3
4

NAME

6       mkzftree - Create a zisofs/RockRidge compressed file tree
7

SYNOPSIS

9       mkzftree [OPTIONS]... INPUT OUTPUT
10

DESCRIPTION

12       Takes  an input file tree (INPUT) and create a corresponding compressed
13       file tree (OUTPUT) that can  be  used  with  an  appropriately  patched
14       mkisofs(8)  to  create  a  transparent-compression  ISO 9660/Rock Ridge
15       filesystem using the "ZF" compression records.
16

OPTIONS

18       -f, --force
19              Always compress all files, even if they  get  larger  when  com‐
20              pressed.
21
22       -z level, --level level
23              Select compression level (1-9, default is 9).  Lower compression
24              levels are faster, but typically result in larger output.
25
26       -u, --uncompress
27              Uncompress an already compressed tree.  This can be used to read
28              a  compressed  filesystem  on  a  system  which cannot read them
29              natively.
30
31       -p parallelism, --parallelism parallelism
32              Compress in parallel.  The parallelism value indicates how  many
33              compression threads are allowed to run.
34
35       -x, --one-filesystem
36              Do  not  cross filesystem boundaries, but create directory stubs
37              at mount points.
38
39       -X, --strict-one-filesystem
40              Do not cross filesystem boundaries, and do not create  directory
41              stubs at mount points.
42
43       -C path, --crib-path path
44              Steal  ("crib")  files from another directory if it looks (based
45              on name, size, type  and  modification  time)  like  they  match
46              entries  in  the new filesystem.  The "crib tree" is usually the
47              compressed version of an older version  of  the  same  workload;
48              this  thus  allows  for  "incremental  rebuilds" of a compressed
49              filesystem tree.  The files are hardlinked from the crib tree to
50              the  output  tree,  so if it is desirable to keep the link count
51              correct the crib path should be deleted before running  mkisofs.
52              The crib tree must be on the same filesystem as the output tree.
53
54       -l, --local
55              Do  not  recurse into subdirectories, but create the directories
56              themselves.
57
58       -L, --strict-local
59              Do not recurse into subdirectories, and do not  create  directo‐
60              ries.
61
62       -F, --file
63              Indicates  that  INPUT  may not necessarily be a directory; this
64              allows operation on a single file.  Note especially that  if  -F
65              is specified, and INPUT is a symlink, the symlink itself will be
66              copied rather than whatever it happens to point to.
67
68       -s, --sloppy
69              Treat file modes, times and ownership data as less than precious
70              information  and don't abort if they cannot be set.  This may be
71              useful if running mkisofs on an input tree you do not own.
72
73       -v, --verbose
74              Increase the program verbosity.
75
76       -V value, --verbosity value
77              Set the program verbosity to value.
78
79       -q, --quiet
80              Issue no messages whatsoever, including error messages.  This is
81              the same as specifying -V 0.
82
83       -h, --help
84              Display a brief help message.
85
86       -w, --version
87              Display the release version.
88

BUGS

90       Long  options (beginning with --) may not work on all systems.  See the
91       message printed out by mkzftree -h to see if this applies to your  sys‐
92       tem.
93
94       Inode  change  times (ctimes) are not copied.  This is a system limita‐
95       tion and applies to all file copy programs.
96
97       If using the parallel option (-z) the access times (atimes) on directo‐
98       ries  may  or may not be copied.  If it is important that the atimes on
99       directories are copied exactly, avoid using -z.
100

AUTHOR

102       Written by H. Peter Anvin <hpa@zytor.com>.
103
105       Copyright © 2001-2002 H. Peter Anvin.
106       This is free software; see the source for copying conditions.  There is
107       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
108       PURPOSE.
109

SEE ALSO

111       mkisofs(8)
112
113
114
115zisofs-tools                     30 July 2001                      MKZFTREE(1)
Impressum