1
2mkhybrid v1.13 has now merged with, and is a part of mkisofs v1.13
3
4HFS hybrid code Copyright (C) James Pearson 1997, 1998, 1999, 2000
5libhfs code Copyright (C) 1996, 1997 Robert Leslie
6libfile code Copyright (c) Ian F. Darwin 1986, 1987, 1989,
7	1990, 1991, 1992, 1994, 1995
8mkisofs code Copyright 1993 Yggdrasil Computing, Incorporated
9
10*** NEWS ***
11
12Macs can now read Joliet CDs - see http://www.tempel.org/joliet/
13
14***
15
16*** IMPORTANT ***
17
18The meaning of some of the HFS command line options has changed since
19version 1.12b5.2. This change is to make the way mkisofs decodes the
20various Apple/Unix file formats (CAP, AppleDouble, MacBinary etc.) less
21confusing and more logical. To decode one or more of the Apple/Unix files,
22then the corresponding "double dash" option must be given (i.e. --cap,
23--double, --macbin etc.) mkisofs can search for all known Apple/Unix files
24by using the -probe option.
25
26The options that have changed are:
27
28Option		old meaning			new meaning
29======		===========			===========
30
31-hfs		Create an HFS hybrid CD		Create an HFS hybrid CD.
32		and attempt to decode all	Any Apple/Unix file is only
33		Apple/Unix files (except	decoded if one or more of
34		MacBinary and AppleSingle)	the "double dash" options are
35						given
36
37-apple		Create an ISO9660 with		Create an ISO9660 with
38		Apple extensions CD and		Apple extensions CD. Any
39		attempt to decode all		Apple/Unix file is only decoded
40		Apple/Unix files (except	if one or more of the
41		MacBinary and AppleSingle)	"double dash" options are given
42
43-no-mac-files	Do not attempt to decode	No longer used
44		any Apple/Unix file
45
46-probe		Attempt to decode		Attempt to decode all
47		MacBinary and AppleSingle	Apple/Unix files
48		as well as the other
49		Apple/Unix files
50
51***
52
53Most of the HFS features work fine, however, some are not fully tested.
54These are marked as "Alpha" in the man page.
55
56See "ChangeLog.mkhybrid" for any minor changes/bug fixes
57
58If you are using SunOS 4.1.[34], then you need the following patches
59to read CDs with associated files:
60
61SunOS 4.1.3:		Patch 101832-05
62SunOS 4.1.3_U1:		Patch 101833-02
63SunOS 4.1.4:		Patch 102583-02
64
65
66EXAMPLES
67
68To create a HFS hybrid CD with the Joliet and Rock Ridge extensions of
69the source directory cd_dir:
70
71% mkisofs -o cd.iso -r -J -hfs cd_dir
72
73To create a HFS hybrid CD from the source directory cd_dir that contains
74Netatalk Apple/Unix files:
75
76% mkisofs -o cd.iso --netatalk cd_dir
77
78To create a HFS hybrid CD from the source directory cd_dir, giving all files
79CREATOR and TYPES based on just their filename extensions listed in the file
80"mapping".:
81
82% mkisofs -o cd.iso -map mapping cd_dir
83
84To create a CD with the 'Apple Extensions to ISO9660', from the source
85direcories cd_dir and another_dir. Files in all the known Apple/Unix format
86are decoded and any other files are given CREATOR and TYPE based on their
87magic number given in the file "magic":
88
89% mkisofs -o cd.iso -apple -magic magic -probe cd_dir another_dir
90
91The following example puts different files on the CD that all have
92the name README, but have different contents when seen as a
93ISO9660/RockRidge, Joliet or HFS CD.
94
95Current directory contains:
96
97% ls -F
98README.hfs     README.joliet  README.unix    cd_dir/
99
100The following command puts the contents of the directory "cd_dir" on the
101CD along with the three README files - but only one will be seen from
102each of the three filesystems:
103
104% mkisofs -o cd.iso -hfs -J -r \
105        -hide README.hfs -hide README.joliet \
106        -hide-joliet README.hfs -hide-joliet README.unix \
107        -hide-hfs README.joliet -hide-hfs README.unix \
108        README=README.hfs README=README.joliet README=README.unix \
109        cd_dir
110
111i.e. the file README.hfs will be seen as README on the HFS CD and the
112other two README files will be hidden. Similarly for the Joliet and
113ISO9660/RockRidge CD.
114
115There are probably all sorts of stange results possible with
116combinations of the hide options ...
117
118
119Any comments, bug reports/fixes about the HFS parts of mkisofs to the
120address below.
121
122Please state the version, platform and command line used when submitting
123a bug report - the output from "-log-file -v" would help.
124
125James Pearson (j.pearson@ge.ucl.ac.uk)
126