doc/genisoimage/README.mkhybrid

   1
   2 mkhybrid v1.13 has merged with mkisofs which was forked to genisoimage later
   3
   4 HFS hybrid code Copyright (C) James Pearson 1997, 1998, 1999, 2000
   5 libhfs code Copyright (C) 1996, 1997 Robert Leslie
   6 libfile code Copyright (c) Ian F. Darwin 1986, 1987, 1989,
   7         1990, 1991, 1992, 1994, 1995
   8 mkisofs code Copyright 1993 Yggdrasil Computing, Incorporated
   9
  10 *** NEWS ***
  11
  12 Macs can now read Joliet CDs - see http://www.tempel.org/joliet/
  13
  14 ***
  15
  16 *** IMPORTANT ***
  17
  18 The meaning of some of the HFS command line options has changed since
  19 version 1.12b5.2. This change is to make the way genisoimage decodes the
  20 various Apple/Unix file formats (CAP, AppleDouble, MacBinary etc.) less
  21 confusing and more logical. To decode one or more of the Apple/Unix files,
  22 then the corresponding "double dash" option must be given (i.e. --cap,
  23 --double, --macbin etc.) genisoimage can search for all known Apple/Unix files
  24 by using the -probe option.
  25
  26 The options that have changed are:
  27
  28 Option          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
  53 Most of the HFS features work fine, however, some are not fully tested.
  54 These are marked as "Alpha" in the man page.
  55
  56 See "ChangeLog.mkhybrid" for any minor changes/bug fixes
  57
  58 If you are using SunOS 4.1.[34], then you need the following patches
  59 to read CDs with associated files:
  60
  61 SunOS 4.1.3:            Patch 101832-05
  62 SunOS 4.1.3_U1:         Patch 101833-02
  63 SunOS 4.1.4:            Patch 102583-02
  64
  65
  66 EXAMPLES
  67
  68 To create a HFS hybrid CD with the Joliet and Rock Ridge extensions of
  69 the source directory cd_dir:
  70
  71 % genisoimage -o cd.iso -r -J -hfs cd_dir
  72
  73 To create a HFS hybrid CD from the source directory cd_dir that contains
  74 Netatalk Apple/Unix files:
  75
  76 % genisoimage -o cd.iso --netatalk cd_dir
  77
  78 To create a HFS hybrid CD from the source directory cd_dir, giving all files
  79 CREATOR and TYPES based on just their filename extensions listed in the file
  80 "mapping".:
  81
  82 % genisoimage -o cd.iso -map mapping cd_dir
  83
  84 To create a CD with the 'Apple Extensions to ISO9660', from the source
  85 direcories cd_dir and another_dir. Files in all the known Apple/Unix format
  86 are decoded and any other files are given CREATOR and TYPE based on their
  87 magic number given in the file "magic":
  88
  89 % genisoimage -o cd.iso -apple -magic magic -probe cd_dir another_dir
  90
  91 The following example puts different files on the CD that all have
  92 the name README, but have different contents when seen as a
  93 ISO9660/RockRidge, Joliet or HFS CD.
  94
  95 Current directory contains:
  96
  97 % ls -F
  98 README.hfs     README.joliet  README.unix    cd_dir/
  99
 100 The following command puts the contents of the directory "cd_dir" on the
 101 CD along with the three README files - but only one will be seen from
 102 each of the three filesystems:
 103
 104 % genisoimage -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
 111 i.e. the file README.hfs will be seen as README on the HFS CD and the
 112 other two README files will be hidden. Similarly for the Joliet and
 113 ISO9660/RockRidge CD.
 114
 115 There are probably all sorts of stange results possible with
 116 combinations of the hide options ...
 117
 118
 119 Any comments, bug reports/fixes about the HFS parts of genisoimage to the
 120 address below.
 121
 122 Please state the version, platform and command line used when submitting
 123 a bug report - the output from "-log-file -v" would help.
 124
 125 Original author: James Pearson (j.pearson@ge.ucl.ac.uk)
 126
 127 This describes the program as shipped with cdrkit, a spinoff from the
 128 cdrtools project. However, the cdrtools developers are no longer
 129 involved in the development of this spinoff and therefore shall not
 130 be made responsible for any problem caused by it. Do not try to get
 131 support for this program by contacting the original authors.
 132
 133 If you have support questions, send them to
 134
 135 debburn-devel@lists.alioth.debian.org
 136
 137 If you have definitely found a bug, send a mail to this list or to
 138
 139 submit@bugs.debian.org
 140
 141 writing at least a short description into the Subject and "Package: cdrkit"
 142
 143 Source: README.mkhybrid from cdrtools package
 144 Edited for cdrkit by Christian Fromme <kaner@strace.org> and Eduard Bloch
 145