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