Updated documentation of xorriso and xorrisofs about HFS+

xorriso/xorrisofs.1

@@ -9,7 +9,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISOFS 1 "Version 1.2.3, May 22, 2012"
+.TH XORRISOFS 1 "Version 1.2.3, Jun 06, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -41,7 +41,7 @@ Joerg Schilling.
 Its implementation is part of program xorriso which shares no source
 code with cdrtools.
 .SS
-\fBISO 9660, Rock Ridge, Joliet:\fR
+\fBISO 9660, Rock Ridge, Joliet, HFS+:\fR
 .br
 \fBISO 9660\fR
 (aka \fBECMA\-119\fR) is a read\-only filesystem that is mainly used for
@@ -77,6 +77,16 @@ It might be of use with some older computer system boot
 facilities which read neither Rock Ridge nor Joliet but
 need longer filenames nevertheless.
 Production of this directory tree may be enabled by option \-iso\-level 4.
+.br
+\fBHFS+\fR
+is the name of a filesystem which is normally used for writing and reading
+on hard disks and similar devices. It is possible to embed a HFS+ partition
+into the emerging ISO 9660 image and to mark it by Apple Partition Map
+entries. This interferes with options which copy data into the first 32 KiB
+of the ISO image, like \-G or \-isohybrid\-mbr. See option \-hfsplus.
+.br
+The main purpose for having an embedded HFS+ partition is booting of
+certain models of Apple computers.
 .SS
 .B Inserting files into the ISO image:
 .PP
@@ -614,6 +624,45 @@ by the specification. Allow Joliet paths longer than the prescribed limit of
 Oversized names get truncated. Without this option, oversized paths get
 excluded from the Joliet tree.
 .TP
+\fB\-hfsplus\fR
+Enable the production of an additional HFS+ filesystem inside the ISO 9660
+image and mark it by Apple Partition Map (APM) entries in the System Area,
+the first 32 KiB of the image.
+.br
+This may collide with options like \-G or \-isohybrid\-mbr which submit user data
+for inclusion in the same address range.
+The first 8 bytes of the System Area get overwritten by
+{ 0x45, 0x52, 0x08 0x00, 0xeb, 0x02, 0xff, 0xff }
+which can be executed as x86 machine code without negative effects.
+So if an MBR gets combined with this feature, then its first 8 bytes
+should contain no essential commands.
+.br
+The next blocks of 2 KiB in the System Area will be occupied by APM entries.
+The first one covers the part of the ISO image before the HFS+ filesystem
+metadata. The second one marks the range from HFS+ metadata to the end
+of file content data. If more ISO image data follow, then a third partition
+entry gets produced. Other features of xorriso might cause the need for
+more APM entries.
+.TP
+\fB\-hfsplus-file-creator-type\fR creator type iso_rr_path
+Set the HFS+ creator and type attributes of a file in the emerging image.
+These are two codes of 4 characters each.
+.TP
+\fB\-hfsplus-bless-by\fR blessing iso_rr_path
+Issue a HFS+ blessing. They are roles which can be attributed to
+up to four directories and a data file:
+.br
+"ppc_bootdir", "intel_bootfile", "show_folder", "os9_folder", "osx_folder".
+.br
+They may be abbreviated as "p", "i", "s", "9", and "x".
+.br
+Each such role can be attributed to at most one file object. "intel_bootfile"
+is the one that would apply to a data file. All others apply to directories.
+No file object can bear more than one blessing.
+.TP
+\fB\-hfsplus-bless\fR iso_rr_path
+Alias for \-hfsplus\-bless\-by "ppc_bootdir" iso_rr_path
+.TP
 .B Settings for file hiding:
 .TP
 \fB\-hide\fR disk_path_pattern
@@ -637,6 +686,14 @@ if their disk_path matches the given shell parser pattern.
 Perform \-hide\-joliet using each line out of file disk_path as argument
 disk_path_pattern.
 .TP
+\fB\-hide-hfsplus\fR disk_path_pattern
+Like option \-hide but making files invisible in the directory tree of HFS+,
+if their disk_path matches the given shell parser pattern.
+.TP
+\fB\-hide-hfsplus-list\fR disk_path
+Perform \-hide\-hfsplus using each line out of file disk_path as argument
+disk_path_pattern.
+.TP
 .B ISO image ID strings:
 .PP
 The following strings and file addresses get stored in the Primary Volume
@@ -1594,5 +1651,6 @@ to modify this text under that same license.
 .SH CREDITS
 \fBxorrisofs\fR is in part based on work by Vreixo Formoso who provides
 libisofs together with Mario Danic who also leads the libburnia team.
+Vladimir Serbinenko contributed the HFS+ filesystem code and related knowledge.
 .br
 Compliments towards Joerg Schilling whose cdrtools served me for ten years.