xref: /netbsd-src/external/gpl2/mkhybrid/dist/README.mkhybrid (revision ddaa4e7dfcdb43ad63a53c6e313d42cd4abcc54b)
1*ddaa4e7dStsutsui
2*ddaa4e7dStsutsui	mkhybrid v1.12b5.1 - make ISO9660/HFS shared hybrid CD volume
3*ddaa4e7dStsutsui
4*ddaa4e7dStsutsuiHFS hybrid code Copyright (C) James Pearson 1997, 1998, 1999
5*ddaa4e7dStsutsuilibhfs code Copyright (C) 1996, 1997 Robert Leslie
6*ddaa4e7dStsutsuilibfile code Copyright (c) Ian F. Darwin 1986, 1987, 1989,
7*ddaa4e7dStsutsui	1990, 1991, 1992, 1994, 1995
8*ddaa4e7dStsutsuimkisofs code Copyright 1993 Yggdrasil Computing, Incorporated
9*ddaa4e7dStsutsui
10*ddaa4e7dStsutsuiWARNING - this is Beta release code - please use with care!
11*ddaa4e7dStsutsuiIf you find a bug, please report it to the address given below.
12*ddaa4e7dStsutsui
13*ddaa4e7dStsutsuiThis code is based on a Beta release of mkisofs, so there may be
14*ddaa4e7dStsutsuiproblems unrelated to my additions. However, I have found mkisofs
15*ddaa4e7dStsutsuiv1.12b5 to be very stable.
16*ddaa4e7dStsutsui
17*ddaa4e7dStsutsuiHowever, many people are using v1.12, so although it's called a "beta"
18*ddaa4e7dStsutsuirelease, I would encourage people to use it ...
19*ddaa4e7dStsutsuiMost of the HFS features work fine, however, some are not fully tested.
20*ddaa4e7dStsutsuiThese are marked as "Alpha" in the man page.
21*ddaa4e7dStsutsui
22*ddaa4e7dStsutsuiPlease read the man page (mkhybrid.8, or mkhybrid_man.html) for information
23*ddaa4e7dStsutsuion how to use mkhybrid.
24*ddaa4e7dStsutsui
25*ddaa4e7dStsutsuiAlso see "ChangeLog.mkhybrid" for any minor changes/bug fixes
26*ddaa4e7dStsutsui
27*ddaa4e7dStsutsuiDESCRIPTION
28*ddaa4e7dStsutsui
29*ddaa4e7dStsutsuimkhybrid is a pre-mastering utility that creates ISO9660/ROCKRIDGE/JOLIET/HFS
30*ddaa4e7dStsutsuihybrid CDROM images. You will have to use some other CD-R package to write
31*ddaa4e7dStsutsuithe image to a CD.
32*ddaa4e7dStsutsui
33*ddaa4e7dStsutsuiINSTALLATION
34*ddaa4e7dStsutsui
35*ddaa4e7dStsutsuiTo make/install, type "./configure", make any changes to the Makefile
36*ddaa4e7dStsutsuiand type "make"
37*ddaa4e7dStsutsui
38*ddaa4e7dStsutsuiThis has been tested with gcc on SunOS 4.1.3 (see below), gcc on Linux
39*ddaa4e7dStsutsui(Redhat v5.1), cc on IRIX 5.3/6.2 and gcc on Win95/WinNT4 using Cygnus'
40*ddaa4e7dStsutsuicygwin (see README.win32)
41*ddaa4e7dStsutsui
42*ddaa4e7dStsutsuiIf you are using SunOS 4.1.[34], then you need the following patches
43*ddaa4e7dStsutsuito read CDs with associated files:
44*ddaa4e7dStsutsui
45*ddaa4e7dStsutsuiSunOS 4.1.3:		Patch 101832-05
46*ddaa4e7dStsutsuiSunOS 4.1.3_U1:		Patch 101833-02
47*ddaa4e7dStsutsuiSunOS 4.1.4:		Patch 102583-02
48*ddaa4e7dStsutsui
49*ddaa4e7dStsutsui
50*ddaa4e7dStsutsuiEXAMPLES
51*ddaa4e7dStsutsui
52*ddaa4e7dStsutsuiTo create a HFS hybrid CD with the Joliet and Rock Ridge extensions or
53*ddaa4e7dStsutsuithe source directory cd_dir:
54*ddaa4e7dStsutsui
55*ddaa4e7dStsutsui% mkhybrid -o cd.iso -r -J -hfs cd_dir
56*ddaa4e7dStsutsui
57*ddaa4e7dStsutsuiTo create a HFS hybrid CD from the source directory cd_dir that contains
58*ddaa4e7dStsutsuiNetatalk Apple/Unix files:
59*ddaa4e7dStsutsui
60*ddaa4e7dStsutsui% mkhybrid -o cd.iso --netatalk cd_dir
61*ddaa4e7dStsutsui
62*ddaa4e7dStsutsuiTo create a HFS hybrid CD from the source directory cd_dir, giving all files
63*ddaa4e7dStsutsuiCREATOR and TYPES based on just their filename extensions listed in the file
64*ddaa4e7dStsutsui"mapping".:
65*ddaa4e7dStsutsui
66*ddaa4e7dStsutsui% mkhybrid -o cd.iso -no-mac-files -map mapping cd_dir
67*ddaa4e7dStsutsui
68*ddaa4e7dStsutsuiTo create a CD with the 'Apple Extensions to ISO9660', from the source
69*ddaa4e7dStsutsuidirecories cd_dir and another_dir. Files in all the known Apple/Unix format
70*ddaa4e7dStsutsuiare decoded and any other files are given CREATOR and TYPE based on their
71*ddaa4e7dStsutsuimagic number given in the file "magic":
72*ddaa4e7dStsutsui
73*ddaa4e7dStsutsui% mkhybird -o cd.iso -magic -apple cd_dir another_dir
74*ddaa4e7dStsutsui
75*ddaa4e7dStsutsuiThe following example puts different files on the CD that all have
76*ddaa4e7dStsutsuithe name README, but have different contents when seen as a
77*ddaa4e7dStsutsuiISO9660/RockRidge Joliet or HFS CD.
78*ddaa4e7dStsutsui
79*ddaa4e7dStsutsuiCurrent directory contains
80*ddaa4e7dStsutsui
81*ddaa4e7dStsutsui% ls -F
82*ddaa4e7dStsutsuiREADME.hfs     README.joliet  README.unix    cd_dir/
83*ddaa4e7dStsutsui
84*ddaa4e7dStsutsuiThe following command puts the contents of the directory "cd_dir" on the
85*ddaa4e7dStsutsuiCD along with the three README files - but only one will be seen from
86*ddaa4e7dStsutsuieach of the three filesystems:
87*ddaa4e7dStsutsui
88*ddaa4e7dStsutsui% mkhybrid -o cd.iso -hfs -J -r \
89*ddaa4e7dStsutsui        -hide README.hfs -hide README.joliet \
90*ddaa4e7dStsutsui        -hide-joliet README.hfs -hide-joliet README.unix \
91*ddaa4e7dStsutsui        -hide-hfs README.joliet -hide-hfs README.unix \
92*ddaa4e7dStsutsui        README=README.hfs README=README.joliet README=README.unix \
93*ddaa4e7dStsutsui        cd_dir
94*ddaa4e7dStsutsui
95*ddaa4e7dStsutsuii.e. the file README.hfs will be seen as README on the HFS CD and the
96*ddaa4e7dStsutsuiother two README files will be hidden. Similarly for the Joliet and
97*ddaa4e7dStsutsuiISO9660/RockRidge CD.
98*ddaa4e7dStsutsui
99*ddaa4e7dStsutsuiThere are probably all sorts of stange results possible with
100*ddaa4e7dStsutsuicombinations of the hide options ...
101*ddaa4e7dStsutsui
102*ddaa4e7dStsutsui
103*ddaa4e7dStsutsuiAny comments, bug reports/fixes to the address below.
104*ddaa4e7dStsutsui
105*ddaa4e7dStsutsuiPlease state the version, platform and command line used when submitting
106*ddaa4e7dStsutsuia bug report - the output from "-log-file -v" would help.
107*ddaa4e7dStsutsui
108*ddaa4e7dStsutsuiJames Pearson (j.pearson@ge.ucl.ac.uk)
109