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

Updated documentation about MBR

Browse Source
This commit is contained in:
Thomas Schmitt 2010-04-18 15:46:12 +00:00
parent 83216597c2
commit 38d296423b
3 changed files with 111 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
xorriso/xorriso.1
View File

@ -378,7 +378,12 @@ xorriso is able to create or maintain an El Torito object which makes such
an image bootable. For details see option -boot_image. an image bootable. For details see option -boot_image.
.br .br
It is possible to make ISO images bootable from USB stick or other It is possible to make ISO images bootable from USB stick or other
hard-disk-like media by -boot_image argument system_area= . hard-disk-like media by -boot_image argument system_area= . This installs
a Master Boot Record which may get adjusted according to the needs
of GRUB resp. ISOLINUX.
An \fBMBR\fR contains boot code and a partition table. It does not hamper
CDROM booting. The new MBR of a follow-up session can get in effect
only on overwriteable media.
.br .br
Emulation -as mkisofs supports the example options out of the ISOLINUX wiki. Emulation -as mkisofs supports the example options out of the ISOLINUX wiki.
It also supports the options used in GRUB script grub-mkrescue. It also supports the options used in GRUB script grub-mkrescue.
@ -2245,9 +2250,6 @@ the very start of the ISO image.
This System Area is reserved for system dependent boot software, e.g. an MBR This System Area is reserved for system dependent boot software, e.g. an MBR
which can be used to boot from USB stick or hard disk. which can be used to boot from USB stick or hard disk.
.br .br
Special disk_path "/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which eventually was loaded with the ISO image.
.br
Other than a El Torito boot image, the file disk_path needs not to be added Other than a El Torito boot image, the file disk_path needs not to be added
to the ISO image. to the ISO image.
.br .br
@ -2257,13 +2259,23 @@ to the ISO image.
446 to 511 of the System Area. 446 to 511 of the System Area.
.br .br
With type "isolinux" it shows a partition that begins at byte 0 and it causes With type "isolinux" it shows a partition that begins at byte 0 and it causes
the boot image LBA to be written into the MBR. This works only if also the boot image LBA to be written into the MBR. For the first session this
"system_area=" and "bin_path=" or "dir=" is given. works only if also "system_area=" and "bin_path=" or "dir=" is given.
.br .br
With types "any" and "grub" it shows a single With types "any" and "grub" it shows a single
partiton which starts at byte 512 and ends where the ISO image ends. partiton which starts at byte 512 and ends where the ISO image ends.
This works with or without system_area= or boot image. This works with or without system_area= or boot image.
.br .br
In follow-up sessions the existing System Area is preserved by default.
If types "isolinux" or "grub" are set to "patch", then "partition_table=on"
is activated without new boot image.
In this case the existing System Area gets checked whether it bears addresses
and sizes as if it had been processed by "partition_table=on". If so,
then those parameters get updated when the new System Area is written.
.br
Special "system_area=/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which eventually was loaded with the ISO image.
.br
.TP .TP
.B Character sets: .B Character sets:
.PP .PP
@ -3131,7 +3143,7 @@ same name and hardcoded argument "on", e.g. -acl "on".
Explicit arguments are expected by --stdio_sync Explicit arguments are expected by --stdio_sync
and --scdbackup_tag. and --scdbackup_tag.
.br .br
--sort-weight gets as argument a number and an iso_rr_path. --sort-weight gets as arguments a number and an iso_rr_path.
The number becomes the LBA sorting weight of regular file iso_rr_path or The number becomes the LBA sorting weight of regular file iso_rr_path or
of all regular files underneath directory iso_rr_path. of all regular files underneath directory iso_rr_path.
(See -find -exec sort_weight). (See -find -exec sort_weight).

123
xorriso/xorriso.info
View File

@ -337,7 +337,11 @@ Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot
images. xorriso is able to create or maintain an El Torito object images. xorriso is able to create or maintain an El Torito object
which makes such an image bootable. For details see option -boot_image. which makes such an image bootable. For details see option -boot_image.
It is possible to make ISO images bootable from USB stick or other It is possible to make ISO images bootable from USB stick or other
hard-disk-like media by -boot_image argument system_area= . hard-disk-like media by -boot_image argument system_area= . This
installs a Master Boot Record which may get adjusted according to the
needs of GRUB resp. ISOLINUX. An *MBR* contains boot code and a
partition table. It does not hamper CDROM booting. The new MBR of a
follow-up session can get in effect only on overwriteable media.
Emulation -as mkisofs supports the example options out of the ISOLINUX Emulation -as mkisofs supports the example options out of the ISOLINUX
wiki. It also supports the options used in GRUB script grub-mkrescue. wiki. It also supports the options used in GRUB script grub-mkrescue.
The support for other boot image types is sparse. The support for other boot image types is sparse.
@ -2004,20 +2008,27 @@ of the existing sessions, unless one can assume overwriteable media.
disk file to the very start of the ISO image. This System Area is disk file to the very start of the ISO image. This System Area is
reserved for system dependent boot software, e.g. an MBR which can reserved for system dependent boot software, e.g. an MBR which can
be used to boot from USB stick or hard disk. be used to boot from USB stick or hard disk.
Special disk_path "/dev/zero" causes 32k of NUL-bytes. Use this
to discard an MBR which eventually was loaded with the ISO image.
Other than a El Torito boot image, the file disk_path needs not to Other than a El Torito boot image, the file disk_path needs not to
be added to the ISO image. be added to the ISO image.
-boot_image isolinux system_area= implies "partition_table=on". -boot_image isolinux system_area= implies "partition_table=on".
"partition_table=on" causes a simple partition table to be written "partition_table=on" causes a simple partition table to be written
into bytes 446 to 511 of the System Area. into bytes 446 to 511 of the System Area.
With type "isolinux" it shows a partition that begins at byte 0 With type "isolinux" it shows a partition that begins at byte 0
and it causes the boot image LBA to be written into the MBR. This and it causes the boot image LBA to be written into the MBR. For
works only if also "system_area=" and "bin_path=" or "dir=" is the first session this works only if also "system_area=" and
given. "bin_path=" or "dir=" is given.
With types "any" and "grub" it shows a single partiton which With types "any" and "grub" it shows a single partiton which
starts at byte 512 and ends where the ISO image ends. This works starts at byte 512 and ends where the ISO image ends. This works
with or without system_area= or boot image. with or without system_area= or boot image.
In follow-up sessions the existing System Area is preserved by
default. If types "isolinux" or "grub" are set to "patch", then
"partition_table=on" is activated without new boot image. In this
case the existing System Area gets checked whether it bears
addresses and sizes as if it had been processed by
"partition_table=on". If so, then those parameters get updated
when the new System Area is written.
Special "system_area=/dev/zero" causes 32k of NUL-bytes. Use this
to discard an MBR which eventually was loaded with the ISO image.
 
File: xorriso.info, Node: Charset, Next: Exception, Prev: Bootable, Up: Options File: xorriso.info, Node: Charset, Next: Exception, Prev: Bootable, Up: Options
@ -2806,7 +2817,7 @@ programs trigger comparable actions.
xorriso options with the same name and hardcoded argument "on", xorriso options with the same name and hardcoded argument "on",
e.g. -acl "on". Explicit arguments are expected by --stdio_sync e.g. -acl "on". Explicit arguments are expected by --stdio_sync
and --scdbackup_tag. and --scdbackup_tag.
--sort-weight gets as argument a number and an iso_rr_path. The --sort-weight gets as arguments a number and an iso_rr_path. The
number becomes the LBA sorting weight of regular file iso_rr_path number becomes the LBA sorting weight of regular file iso_rr_path
or of all regular files underneath directory iso_rr_path. (See or of all regular files underneath directory iso_rr_path. (See
-find -exec sort_weight). -find -exec sort_weight).
@ -3787,7 +3798,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
[index] [index]
* Menu: * Menu:
* ACL, _definiton: Extras. (line 32) * ACL, _definiton: Extras. (line 36)
* ACL, control handling, -acl: Loading. (line 128) * ACL, control handling, -acl: Loading. (line 128)
* ACL, set in ISO image, -setfacl: Manip. (line 73) * ACL, set in ISO image, -setfacl: Manip. (line 73)
* ACL, set in ISO image, -setfacl_list: Manip. (line 100) * ACL, set in ISO image, -setfacl_list: Manip. (line 100)
@ -3889,6 +3900,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Insert, piece of data file, -cut_out: Insert. (line 126) * Insert, piece of data file, -cut_out: Insert. (line 126)
* iso_rr_path, _definition: Insert. (line 7) * iso_rr_path, _definition: Insert. (line 7)
* List delimiter, _definiton: Processing. (line 8) * List delimiter, _definiton: Processing. (line 8)
* MBR, _definiton: Extras. (line 26)
* MBR, set, -boot_image system_area=: Bootable. (line 85)
* MD5, control handling, -md5: Loading. (line 141) * MD5, control handling, -md5: Loading. (line 141)
* Media, erase, -blank: Writing. (line 45) * Media, erase, -blank: Writing. (line 45)
* Media, format, -format: Writing. (line 69) * Media, format, -format: Writing. (line 69)
@ -3918,6 +3931,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Ownership, global in ISO image, -uid: SetWrite. (line 125) * Ownership, global in ISO image, -uid: SetWrite. (line 125)
* Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown: Manip. (line 42)
* Ownership, in ISO image, -chown_r: Manip. (line 47) * Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition table, _definiton: Bootable. (line 92)
* Pathspec, _definition: SetInsert. (line 120) * Pathspec, _definition: SetInsert. (line 120)
* Pattern expansion, _definition: Processing. (line 22) * Pattern expansion, _definition: Processing. (line 22)
* Pattern expansion, for disk paths, -disk_pattern: Insert. (line 31) * Pattern expansion, for disk paths, -disk_pattern: Insert. (line 31)
@ -3968,6 +3982,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Session, mount command line, -mount_cmd: Inquiry. (line 31) * Session, mount command line, -mount_cmd: Inquiry. (line 31)
* Session, mount parameters, -mount_opts: Inquiry. (line 47) * Session, mount parameters, -mount_opts: Inquiry. (line 47)
* Session, select as input, -load: Loading. (line 11) * Session, select as input, -load: Loading. (line 11)
* System area, _definiton: Bootable. (line 85)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 189) * Table-of-content, search sessions, -rom_toc_scan: Loading. (line 189)
* Table-of-content, show, -toc: Inquiry. (line 18) * Table-of-content, show, -toc: Inquiry. (line 18)
* Timestamps, set in ISO image, -alter_date: Manip. (line 146) * Timestamps, set in ISO image, -alter_date: Manip. (line 146)
@ -3997,7 +4012,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Write, predict image size, -print_size: Inquiry. (line 69) * Write, predict image size, -print_size: Inquiry. (line 69)
* Write, set speed, -speed: SetWrite. (line 145) * Write, set speed, -speed: SetWrite. (line 145)
* Write, simulation, -dummy: SetWrite. (line 185) * Write, simulation, -dummy: SetWrite. (line 185)
* xattr, _definiton: Extras. (line 46) * xattr, _definiton: Extras. (line 50)
* xattr, control handling, -xattr: Loading. (line 136) * xattr, control handling, -xattr: Loading. (line 136)
* xattr, set in ISO image, -setfattr: Manip. (line 110) * xattr, set in ISO image, -setfattr: Manip. (line 110)
* xattr, set in ISO image, -setfattr_list: Manip. (line 126) * xattr, set in ISO image, -setfattr_list: Manip. (line 126)
@ -4015,50 +4030,50 @@ Node: Media6089
Node: Methods8519 Node: Methods8519
Node: Drives11066 Node: Drives11066
Node: Extras14332 Node: Extras14332
Node: Processing17463 Node: Processing17736
Node: Dialog20959 Node: Dialog21232
Node: Options22616 Node: Options22889
Node: AqDrive24184 Node: AqDrive24457
Node: Loading27090 Node: Loading27363
Node: Insert39525 Node: Insert39798
Node: SetInsert47882 Node: SetInsert48155
Node: Manip56449 Node: Manip56722
Node: CmdFind64325 Node: CmdFind64598
Node: Filter73572 Node: Filter73845
Node: Writing77921 Node: Writing78194
Node: SetWrite84210 Node: SetWrite84483
Node: Bootable94342 Node: Bootable94615
Node: Charset99988 Node: Charset100726
Node: Exception102742 Node: Exception103480
Node: DialogCtl107257 Node: DialogCtl107995
Node: Inquiry109602 Node: Inquiry110340
Node: Navigate113742 Node: Navigate114480
Node: Verify121096 Node: Verify121834
Node: Restore129516 Node: Restore130254
Node: Emulation136172 Node: Emulation136910
Node: Scripting142858 Node: Scripting143597
Node: Frontend148420 Node: Frontend149159
Node: Examples149621 Node: Examples150360
Node: ExDevices150790 Node: ExDevices151529
Node: ExCreate151272 Node: ExCreate152011
Node: ExDialog152546 Node: ExDialog153285
Node: ExGrowing153808 Node: ExGrowing154547
Node: ExModifying154610 Node: ExModifying155349
Node: ExBootable155111 Node: ExBootable155850
Node: ExCharset155658 Node: ExCharset156397
Node: ExPseudo156486 Node: ExPseudo157225
Node: ExCdrecord157380 Node: ExCdrecord158119
Node: ExMkisofs157695 Node: ExMkisofs158434
Node: ExGrowisofs158698 Node: ExGrowisofs159437
Node: ExException159822 Node: ExException160561
Node: ExTime160276 Node: ExTime161015
Node: ExIncBackup160735 Node: ExIncBackup161474
Node: ExRestore164207 Node: ExRestore164946
Node: ExRecovery165176 Node: ExRecovery165915
Node: Files165742 Node: Files166481
Node: Seealso166780 Node: Seealso167519
Node: Legal167304 Node: Legal168043
Node: CommandIdx168226 Node: CommandIdx168965
Node: ConceptIdx181527 Node: ConceptIdx182266
 
End Tag Table End Tag Table

49
xorriso/xorriso.texi
View File

@ -505,25 +505,20 @@ Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
xorriso is able to create or maintain an El Torito object which makes such xorriso is able to create or maintain an El Torito object which makes such
an image bootable. For details see option -boot_image. an image bootable. For details see option -boot_image.
@* @*
@cindex MBR, _definiton
It is possible to make ISO images bootable from USB stick or other It is possible to make ISO images bootable from USB stick or other
hard-disk-like media by -boot_image argument system_area= . hard-disk-like media by -boot_image argument system_area= . This installs
a Master Boot Record which may get adjusted according to the needs
of GRUB resp. ISOLINUX.
An @strong{MBR} contains boot code and a partition table. It does not hamper
CDROM booting. The new MBR of a follow-up session can get in effect
only on overwriteable media.
@* @*
Emulation -as mkisofs supports the example options out of the ISOLINUX wiki. Emulation -as mkisofs supports the example options out of the ISOLINUX wiki.
It also supports the options used in GRUB script grub-mkrescue. It also supports the options used in GRUB script grub-mkrescue.
@* @*
The support for other boot image types is sparse. The support for other boot image types is sparse.
@* @*
@c
@c >>> isohybrid MBR generation has been disabled on request
@c >>> of its inventor H. Peter Anvin on 31 Mar 2010
@c
@c An MBR is generated together with the El Torito boot record if the
@c boot image bears the isohybrid signature of ISOLINUX 3.72 or later.
@c It will occupy the first 512 bytes of the emerging ISO image and
@c enable booting from media which appear as hard disk rather than
@c as CDROM. An MBR does not hamper CDROM booting. The MBR of a
@c follow-up session can get in effect only on overwriteable media.
@c
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex ACL, _definiton @cindex ACL, _definiton
@ -2700,36 +2695,40 @@ is given by "any" "bin_path=". "boot_info_table=off" disables patching.
"patch" applies boot info table patching if an existing boot image gets copied "patch" applies boot info table patching if an existing boot image gets copied
to a new location. to a new location.
@* @*
@cindex System area, _definiton
@cindex MBR, set, -boot_image system_area=
"system_area="disk_path copies at most 32768 bytes from the given disk file to "system_area="disk_path copies at most 32768 bytes from the given disk file to
the very start of the ISO image. the very start of the ISO image.
This System Area is reserved for system dependent boot software, e.g. an MBR This System Area is reserved for system dependent boot software, e.g. an MBR
which can be used to boot from USB stick or hard disk. which can be used to boot from USB stick or hard disk.
@* @*
Special disk_path "/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which eventually was loaded with the ISO image.
@*
Other than a El Torito boot image, the file disk_path needs not to be added Other than a El Torito boot image, the file disk_path needs not to be added
to the ISO image. to the ISO image.
@* @*
-boot_image isolinux system_area= implies "partition_table=on". -boot_image isolinux system_area= implies "partition_table=on".
@* @*
@cindex Partition table, _definiton
"partition_table=on" causes a simple partition table to be written into bytes "partition_table=on" causes a simple partition table to be written into bytes
446 to 511 of the System Area. 446 to 511 of the System Area.
@* @*
With type "isolinux" it shows a partition that begins at byte 0 and it causes With type "isolinux" it shows a partition that begins at byte 0 and it causes
the boot image LBA to be written into the MBR. This works only if also the boot image LBA to be written into the MBR. For the first session this
"system_area=" and "bin_path=" or "dir=" is given. works only if also "system_area=" and "bin_path=" or "dir=" is given.
@* @*
With types "any" and "grub" it shows a single With types "any" and "grub" it shows a single
partiton which starts at byte 512 and ends where the ISO image ends. partiton which starts at byte 512 and ends where the ISO image ends.
This works with or without system_area= or boot image. This works with or without system_area= or boot image.
@* @*
@c In follow-up sessions the existing System Area is preserved by default.
@c Bootspec "isohybrid=off" disables MBR generation, "isohybrid=on" If types "isolinux" or "grub" are set to "patch", then "partition_table=on"
@c prevents the write session if not the isohybrid signature is found is activated without new boot image.
@c in the bin_path file. Default is "isohybrid=auto" which silently In this case the existing System Area gets checked whether it bears addresses
@c omits the MBR if the signature is missing. and sizes as if it had been processed by "partition_table=on". If so,
@c then those parameters get updated when the new System Area is written.
@*
Special "system_area=/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which eventually was loaded with the ISO image.
@*
@end table @end table
@c man .TP @c man .TP
@c man .B Character sets: @c man .B Character sets:
@ -3765,7 +3764,7 @@ same name and hardcoded argument "on", e.g. -acl "on".
Explicit arguments are expected by @minus{}@minus{}stdio_sync Explicit arguments are expected by @minus{}@minus{}stdio_sync
and @minus{}@minus{}scdbackup_tag. and @minus{}@minus{}scdbackup_tag.
@* @*
@minus{}@minus{}sort-weight gets as argument a number and an iso_rr_path. @minus{}@minus{}sort-weight gets as arguments a number and an iso_rr_path.
The number becomes the LBA sorting weight of regular file iso_rr_path or The number becomes the LBA sorting weight of regular file iso_rr_path or
of all regular files underneath directory iso_rr_path. of all regular files underneath directory iso_rr_path.
(See -find -exec sort_weight). (See -find -exec sort_weight).
@ -3779,8 +3778,6 @@ For MBR bootable ISOLINUX images there is -isohybrid-mbr FILE, where
FILE is one of the Syslinux files mbr/isohdp[fp]x*.bin . Use this FILE is one of the Syslinux files mbr/isohdp[fp]x*.bin . Use this
instead of -G to apply the effect of -boot_image isolinux partition_table=on. instead of -G to apply the effect of -boot_image isolinux partition_table=on.
@* @*
@c Quite special is isolinux_mbr= (see -boot_image isolinux isohybrid=).
@c @*
Personalites "@strong{xorrisofs}", "@strong{genisoimage}", Personalites "@strong{xorrisofs}", "@strong{genisoimage}",
and "@strong{genisofs}" are aliases for "mkisofs". and "@strong{genisofs}" are aliases for "mkisofs".
@* @*