summaryrefslogtreecommitdiff
path: root/doc/genisoimage/README.mkhybrid
blob: 49036a151fbe22478168fa6025bdae93297d5d0e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

mkhybrid v1.13 has merged with mkisofs which was forked to genisoimage later

HFS hybrid code Copyright (C) James Pearson 1997, 1998, 1999, 2000
libhfs code Copyright (C) 1996, 1997 Robert Leslie
libfile code Copyright (c) Ian F. Darwin 1986, 1987, 1989,
	1990, 1991, 1992, 1994, 1995
mkisofs code Copyright 1993 Yggdrasil Computing, Incorporated

*** NEWS ***

Macs can now read Joliet CDs - see http://www.tempel.org/joliet/

***

*** IMPORTANT ***

The meaning of some of the HFS command line options has changed since
version 1.12b5.2. This change is to make the way genisoimage decodes the 
various Apple/Unix file formats (CAP, AppleDouble, MacBinary etc.) less
confusing and more logical. To decode one or more of the Apple/Unix files,
then the corresponding "double dash" option must be given (i.e. --cap, 
--double, --macbin etc.) genisoimage can search for all known Apple/Unix files
by using the -probe option.

The options that have changed are:

Option		old meaning			new meaning
======		===========			===========

-hfs		Create an HFS hybrid CD		Create an HFS hybrid CD.
		and attempt to decode all	Any Apple/Unix file is only
		Apple/Unix files (except	decoded if one or more of
		MacBinary and AppleSingle)	the "double dash" options are
						given

-apple		Create an ISO9660 with		Create an ISO9660 with
		Apple extensions CD and		Apple extensions CD. Any
		attempt to decode all		Apple/Unix file is only decoded
		Apple/Unix files (except	if one or more of the
		MacBinary and AppleSingle)	"double dash" options are given

-no-mac-files	Do not attempt to decode	No longer used
		any Apple/Unix file

-probe		Attempt to decode		Attempt to decode all
		MacBinary and AppleSingle	Apple/Unix files
		as well as the other
		Apple/Unix files

***

Most of the HFS features work fine, however, some are not fully tested.
These are marked as "Alpha" in the man page.

See "ChangeLog.mkhybrid" for any minor changes/bug fixes

If you are using SunOS 4.1.[34], then you need the following patches
to read CDs with associated files:

SunOS 4.1.3:		Patch 101832-05
SunOS 4.1.3_U1:		Patch 101833-02
SunOS 4.1.4:		Patch 102583-02


EXAMPLES

To create a HFS hybrid CD with the Joliet and Rock Ridge extensions of
the source directory cd_dir:

% genisoimage -o cd.iso -r -J -hfs cd_dir

To create a HFS hybrid CD from the source directory cd_dir that contains
Netatalk Apple/Unix files:

% genisoimage -o cd.iso --netatalk cd_dir

To create a HFS hybrid CD from the source directory cd_dir, giving all files
CREATOR and TYPES based on just their filename extensions listed in the file 
"mapping".:

% genisoimage -o cd.iso -map mapping cd_dir

To create a CD with the 'Apple Extensions to ISO9660', from the source
direcories cd_dir and another_dir. Files in all the known Apple/Unix format
are decoded and any other files are given CREATOR and TYPE based on their
magic number given in the file "magic":

% genisoimage -o cd.iso -apple -magic magic -probe cd_dir another_dir

The following example puts different files on the CD that all have
the name README, but have different contents when seen as a
ISO9660/RockRidge, Joliet or HFS CD.

Current directory contains:

% ls -F
README.hfs     README.joliet  README.unix    cd_dir/

The following command puts the contents of the directory "cd_dir" on the
CD along with the three README files - but only one will be seen from
each of the three filesystems:

% genisoimage -o cd.iso -hfs -J -r \
        -hide README.hfs -hide README.joliet \
        -hide-joliet README.hfs -hide-joliet README.unix \
        -hide-hfs README.joliet -hide-hfs README.unix \
        README=README.hfs README=README.joliet README=README.unix \
        cd_dir

i.e. the file README.hfs will be seen as README on the HFS CD and the
other two README files will be hidden. Similarly for the Joliet and
ISO9660/RockRidge CD.

There are probably all sorts of stange results possible with
combinations of the hide options ...


Any comments, bug reports/fixes about the HFS parts of genisoimage to the
address below.

Please state the version, platform and command line used when submitting
a bug report - the output from "-log-file -v" would help.

Original author: James Pearson (j.pearson@ge.ucl.ac.uk)

This describes the program as shipped with cdrkit, a spinoff from the
cdrtools project. However, the cdrtools developers are no longer
involved in the development of this spinoff and therefore shall not
be made responsible for any problem caused by it. Do not try to get
support for this program by contacting the original authors.

If you have support questions, send them to

debburn-devel@lists.alioth.debian.org

If you have definitely found a bug, send a mail to this list or to

submit@bugs.debian.org

writing at least a short description into the Subject and "Package: cdrkit"

Source: README.mkhybrid from cdrtools package
Edited for cdrkit by Christian Fromme <kaner@strace.org> and Eduard Bloch