1
2	mkhybrid v1.12b5.1 - make ISO9660/HFS shared hybrid CD volume
3
4HFS hybrid code Copyright (C) James Pearson 1997, 1998, 1999
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
10WARNING - this is Beta release code - please use with care!
11If you find a bug, please report it to the address given below.
12
13This code is based on a Beta release of mkisofs, so there may be
14problems unrelated to my additions. However, I have found mkisofs
15v1.12b5 to be very stable.
16
17However, many people are using v1.12, so although it's called a "beta"
18release, I would encourage people to use it ...
19Most of the HFS features work fine, however, some are not fully tested.
20These are marked as "Alpha" in the man page.
21
22Please read the man page (mkhybrid.8, or mkhybrid_man.html) for information
23on how to use mkhybrid.
24
25Also see "ChangeLog.mkhybrid" for any minor changes/bug fixes
26
27DESCRIPTION
28
29mkhybrid is a pre-mastering utility that creates ISO9660/ROCKRIDGE/JOLIET/HFS
30hybrid CDROM images. You will have to use some other CD-R package to write
31the image to a CD.
32
33INSTALLATION
34
35To make/install, type "./configure", make any changes to the Makefile
36and type "make"
37
38This has been tested with gcc on SunOS 4.1.3 (see below), gcc on Linux
39(Redhat v5.1), cc on IRIX 5.3/6.2 and gcc on Win95/WinNT4 using Cygnus'
40cygwin (see README.win32)
41
42If you are using SunOS 4.1.[34], then you need the following patches
43to read CDs with associated files:
44
45SunOS 4.1.3:		Patch 101832-05
46SunOS 4.1.3_U1:		Patch 101833-02
47SunOS 4.1.4:		Patch 102583-02
48
49
50EXAMPLES
51
52To create a HFS hybrid CD with the Joliet and Rock Ridge extensions or
53the source directory cd_dir:
54
55% mkhybrid -o cd.iso -r -J -hfs cd_dir
56
57To create a HFS hybrid CD from the source directory cd_dir that contains
58Netatalk Apple/Unix files:
59
60% mkhybrid -o cd.iso --netatalk cd_dir
61
62To create a HFS hybrid CD from the source directory cd_dir, giving all files
63CREATOR and TYPES based on just their filename extensions listed in the file
64"mapping".:
65
66% mkhybrid -o cd.iso -no-mac-files -map mapping cd_dir
67
68To create a CD with the 'Apple Extensions to ISO9660', from the source
69direcories cd_dir and another_dir. Files in all the known Apple/Unix format
70are decoded and any other files are given CREATOR and TYPE based on their
71magic number given in the file "magic":
72
73% mkhybird -o cd.iso -magic -apple cd_dir another_dir
74
75The following example puts different files on the CD that all have
76the name README, but have different contents when seen as a
77ISO9660/RockRidge Joliet or HFS CD.
78
79Current directory contains
80
81% ls -F
82README.hfs     README.joliet  README.unix    cd_dir/
83
84The following command puts the contents of the directory "cd_dir" on the
85CD along with the three README files - but only one will be seen from
86each of the three filesystems:
87
88% mkhybrid -o cd.iso -hfs -J -r \
89        -hide README.hfs -hide README.joliet \
90        -hide-joliet README.hfs -hide-joliet README.unix \
91        -hide-hfs README.joliet -hide-hfs README.unix \
92        README=README.hfs README=README.joliet README=README.unix \
93        cd_dir
94
95i.e. the file README.hfs will be seen as README on the HFS CD and the
96other two README files will be hidden. Similarly for the Joliet and
97ISO9660/RockRidge CD.
98
99There are probably all sorts of stange results possible with
100combinations of the hide options ...
101
102
103Any comments, bug reports/fixes to the address below.
104
105Please state the version, platform and command line used when submitting
106a bug report - the output from "-log-file -v" would help.
107
108James Pearson (j.pearson@ge.ucl.ac.uk)
109