libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated documentation of xorriso and xorrisofs about HFS+

Browse Source
This commit is contained in:
Thomas Schmitt
2012-06-06 18:48:26 +00:00
parent 379e984717
commit 396fe7db8a
10 changed files with 624 additions and 181 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
xorriso/xorrisofs.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.2.3, May 22, 2012"
@c man .TH XORRISOFS 1 "Version 1.2.3, Jun 06, 2012"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -125,8 +125,8 @@ Its implementation is part of program xorriso which shares no source
code with cdrtools.
@c man .SS
@node Standards, Insert, Overview, Top
@chapter ISO 9660, Rock Ridge, Joliet
@c man \fBISO 9660, Rock Ridge, Joliet:\fR
@chapter ISO 9660, Rock Ridge, Joliet, HFS+
@c man \fBISO 9660, Rock Ridge, Joliet, HFS+:\fR
@c man .br
@cindex ISO 9660, _definition
@cindex ECMA-119, _definition
@ -167,6 +167,17 @@ 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.
@*
@cindex HFS+, _definition
@strong{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.
@c man .SS
@sp 1
@c man .B Inserting files into the ISO image:
@ -873,6 +884,53 @@ 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.
@c man .TP
@item -hfsplus
@kindex -hfsplus enable production of HFS+ partition
@cindex HFS+, enables production
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.
@c man .TP
@item -hfsplus-file-creator-type creator type iso_rr_path
@kindex -hfsplus-file-creator-type HFS+ creator-type attribute
@cindex HFS+, set creator and type of file, -hfsplus-file-creator-type
Set the HFS+ creator and type attributes of a file in the emerging image.
These are two codes of 4 characters each.
@c man .TP
@item -hfsplus-bless-by blessing iso_rr_path
@kindex -hfsplus-bless HFS+ blessing ppc_bootdir
@cindex HFS+, issue blessing, -hfsplus-bless-by
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.
@c man .TP
@item -hfsplus-bless iso_rr_path
@kindex -hfsplus-bless HFS+ blessing ppc_bootdir
@cindex HFS+, issue blessing ppc_bootdir, -hfsplus-bless
Alias for -hfsplus-bless-by "ppc_bootdir" iso_rr_path
@end table
@c man .TP
@c man .B Settings for file hiding:
@ -909,6 +967,18 @@ if their disk_path matches the given shell parser pattern.
@cindex Hiding, from Joliet, -hide-joliet-list
Perform -hide-joliet using each line out of file disk_path as argument
disk_path_pattern.
@c man .TP
@item -hide-hfsplus disk_path_pattern
@kindex -hide-hfsplus keep matching files invisible in HFS+ tree
@cindex Hiding, from HFS+, -hide-hfsplus
Like option -hide but making files invisible in the directory tree of HFS+,
if their disk_path matches the given shell parser pattern.
@c man .TP
@item -hide-hfsplus-list disk_path
@kindex -hide-hfsplus-list keep matching files invisible in HFS+ tree
@cindex Hiding, from HFS+, -hide-hfsplus-list
Perform -hide-hfsplus using each line out of file disk_path as argument
disk_path_pattern.
@end table
@c man .TP
@c man .B ISO image ID strings:
@ -2154,6 +2224,7 @@ to modify this text under that same license.
@section Credits
@command{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.
@c man-ignore-lines begin