Updated documentation of xorriso and xorrisofs about HFS+

This commit is contained in:
2012-06-06 18:48:26 +00:00
parent 379e984717
commit 396fe7db8a
10 changed files with 624 additions and 181 deletions

View File

@ -51,8 +51,8 @@ shares no source code with cdrtools.

File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Overview, Up: Top
2 ISO 9660, Rock Ridge, Joliet
******************************
2 ISO 9660, Rock Ridge, Joliet, HFS+
************************************
*ISO 9660* (aka *ECMA-119*) is a read-only filesystem that is mainly
used for optical media CD, DVD, BD, but may also reside on other
@ -80,6 +80,14 @@ provides longer filenames. It allows single file names to have up to
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.
*HFS+* 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.
The main purpose for having an embedded HFS+ partition is booting of
certain models of Apple computers.

File: xorrisofs.info, Node: Insert, Next: Xorriso, Prev: Standards, Up: Top
@ -613,6 +621,43 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op
Oversized names get truncated. Without this option, oversized
paths get excluded from the Joliet tree.
-hfsplus
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.
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.
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.
-hfsplus-file-creator-type 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.
-hfsplus-bless-by blessing iso_rr_path
Issue a HFS+ blessing. They are roles which can be attributed to
up to four directories and a data file:
"ppc_bootdir", "intel_bootfile", "show_folder", "os9_folder",
"osx_folder".
They may be abbreviated as "p", "i", "s", "9", and "x".
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.
-hfsplus-bless iso_rr_path
Alias for -hfsplus-bless-by "ppc_bootdir" iso_rr_path

File: xorrisofs.info, Node: SetHide, Next: ImageId, Prev: SetExtras, Up: Options
@ -641,6 +686,14 @@ File: xorrisofs.info, Node: SetHide, Next: ImageId, Prev: SetExtras, Up: Opt
Perform -hide-joliet using each line out of file disk_path as
argument disk_path_pattern.
-hide-hfsplus 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.
-hide-hfsplus-list disk_path
Perform -hide-hfsplus using each line out of file disk_path as
argument disk_path_pattern.

File: xorrisofs.info, Node: ImageId, Next: Bootable, Prev: SetHide, Up: Options
@ -1542,6 +1595,8 @@ entitled to modify this text under that same license.
`xorrisofs' 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.
Compliments towards Joerg Schilling whose cdrtools served me for ten
years.
@ -1628,7 +1683,15 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -graft-points enable target=source pathspecs: SetInsert. (line 31)
* -hard-disk-boot El Torito boot image emulation: Bootable. (line 68)
* -help list supported options: Miscellaneous. (line 20)
* -hfsplus enable production of HFS+ partition: SetExtras. (line 124)
* -hfsplus-bless HFS+ blessing ppc_bootdir: SetExtras. (line 147)
* -hfsplus-file-creator-type HFS+ creator-type attribute: SetExtras.
(line 143)
* -hide keep matching files invisible in ISO tree: SetHide. (line 8)
* -hide-hfsplus keep matching files invisible in HFS+ tree: SetHide.
(line 29)
* -hide-hfsplus-list keep matching files invisible in HFS+ tree: SetHide.
(line 33)
* -hide-joliet keep matching files invisible in Joliet tree: SetHide.
(line 20)
* -hide-joliet-list keep matching files invisible in Joliet tree: SetHide.
@ -1783,6 +1846,15 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* El Torito, _definition: Bootable. (line 13)
* Examples: Examples. (line 6)
* Forced output, control, --stdio_sync: SetProduct. (line 25)
* HFS+, _definition: Standards. (line 32)
* HFS+, enables production: SetExtras. (line 124)
* HFS+, issue blessing ppc_bootdir, -hfsplus-bless: SetExtras.
(line 158)
* HFS+, issue blessing, -hfsplus-bless-by: SetExtras. (line 147)
* HFS+, set creator and type of file, -hfsplus-file-creator-type: SetExtras.
(line 143)
* Hiding, from HFS+, -hide-hfsplus: SetHide. (line 29)
* Hiding, from HFS+, -hide-hfsplus-list: SetHide. (line 33)
* Hiding, from ISO and Rock Ridge, -hide: SetHide. (line 8)
* Hiding, from ISO and Rock Ridge, -hide-list: SetHide. (line 16)
* Hiding, from Joliet, -hide-joliet: SetHide. (line 20)
@ -1889,34 +1961,34 @@ Tag Table:
Node: Top397
Node: Overview1103
Node: Standards1541
Node: Insert3245
Node: Xorriso5083
Node: Options6222
Node: Loading6939
Node: SetInsert9235
Node: SetProduct13651
Node: SetCompl17358
Node: SetExtras19954
Node: SetHide25027
Node: ImageId26026
Node: Bootable29531
Node: SystemArea33596
Node: Charset39930
Node: Jigdo40956
Node: Miscellaneous45223
Node: Examples46596
Node: ExSimple47082
Node: ExGraft47561
Node: ExMkisofs48808
Node: ExGrowisofs50061
Node: ExIncBackup51233
Node: ExIncBckAcc54341
Node: ExBootable56017
Node: Files58109
Node: Seealso59183
Node: Bugreport59839
Node: Legal60420
Node: CommandIdx61235
Node: ConceptIdx73364
Node: Insert3732
Node: Xorriso5570
Node: Options6709
Node: Loading7426
Node: SetInsert9722
Node: SetProduct14138
Node: SetCompl17845
Node: SetExtras20441
Node: SetHide27375
Node: ImageId28683
Node: Bootable32188
Node: SystemArea36253
Node: Charset42587
Node: Jigdo43613
Node: Miscellaneous47880
Node: Examples49253
Node: ExSimple49739
Node: ExGraft50218
Node: ExMkisofs51465
Node: ExGrowisofs52718
Node: ExIncBackup53890
Node: ExIncBckAcc56998
Node: ExBootable58674
Node: Files60766
Node: Seealso61840
Node: Bugreport62496
Node: Legal63077
Node: CommandIdx63972
Node: ConceptIdx76684

End Tag Table