"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "xorriso/xorrisofs.texi" between
xorriso-1.4.6.tar.gz and xorriso-1.4.8.tar.gz

About: GNU xorriso creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions. It is suitable for incremental data backup and for production of bootable ISO 9660 images. GNU xorriso is a statical compilation of the libraries libburn, libisofs, libisoburn, and libjte.

xorrisofs.texi  (xorriso-1.4.6):xorrisofs.texi  (xorriso-1.4.8)
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c %**start of header @c %**start of header
@setfilename xorrisofs.info @setfilename xorrisofs.info
@settitle GNU xorrisofs 1.4.6 @settitle GNU xorrisofs 1.4.8
@c %**end of header @c %**end of header
@c @c
@c man-ignore-lines begin @c man-ignore-lines begin
@dircategory Archiving @dircategory Archiving
@direntry @direntry
* Xorrisofs: (xorrisofs). Emulates ISO 9660 program mkisofs * Xorrisofs: (xorrisofs). Emulates ISO 9660 program mkisofs
@end direntry @end direntry
@c man-ignore-lines end @c man-ignore-lines end
@c @c
@c Notes about embedded man page: @c Notes about embedded man page:
skipping to change at line 53 skipping to change at line 53
@c man .\" @c man .\"
@c man .\" IMPORTANT NOTE: @c man .\" IMPORTANT NOTE:
@c man .\" @c man .\"
@c man .\" The original of this file is kept in xorriso/xorrisofs.texi @c man .\" The original of this file is kept in xorriso/xorrisofs.texi
@c man .\" This here was generated by program xorriso/make_xorriso_1 @c man .\" This here was generated by program xorriso/make_xorriso_1
@c man .\" @c man .\"
@c man .\" @c man .\"
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.4.6, Sep 16, 2016" @c man .TH XORRISOFS 1 "Version 1.4.8, Sep 12, 2017"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@c man .\" .nh disable hyphenation @c man .\" .nh disable hyphenation
@c man .\" .hy enable hyphenation @c man .\" .hy enable hyphenation
@c man .\" .ad l left justify @c man .\" .ad l left justify
@c man .\" .ad b justify to both left and right margins @c man .\" .ad b justify to both left and right margins
@c man .\" .nf disable filling @c man .\" .nf disable filling
@c man .\" .fi enable filling @c man .\" .fi enable filling
@c man .\" .br insert line break @c man .\" .br insert line break
@c man .\" .sp <n> insert n+1 empty lines @c man .\" .sp <n> insert n+1 empty lines
@c man .\" for manpage-specific macros, see man(7) @c man .\" for manpage-specific macros, see man(7)
@c man .nh @c man .nh
@c man-ignore-lines begin @c man-ignore-lines begin
@copying @copying
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
Copyright @copyright{} 2011 - 2016 Thomas Schmitt Copyright @copyright{} 2011 - 2017 Thomas Schmitt
@quotation @quotation
Permission is granted to distrubute this text freely. Permission is granted to distrubute this text freely.
@end quotation @end quotation
@end copying @end copying
@c man-ignore-lines end @c man-ignore-lines end
@titlepage @titlepage
@title Manual of GNU xorriso personality xorrisofs 1.4.6 @title Manual of GNU xorriso personality xorrisofs 1.4.8
@author Thomas Schmitt @author Thomas Schmitt
@page @page
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
@insertcopying @insertcopying
@end titlepage @end titlepage
@contents @contents
@ifnottex @ifnottex
@node Top @node Top
@top xorrisofs 1.4.6 @top xorrisofs 1.4.8
@c man-ignore-lines 1 @c man-ignore-lines 1
@c man .SH NAME @c man .SH NAME
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
@end ifnottex @end ifnottex
@menu @menu
* Overview:: Overview * Overview:: Overview
* Standards:: ISO 9660, Rock Ridge, Joliet * Standards:: ISO 9660, Rock Ridge, Joliet
* Insert:: Inserting files into the ISO image * Insert:: Inserting files into the ISO image
* Xorriso:: Relation to program xorriso * Xorriso:: Relation to program xorriso
skipping to change at line 1273 skipping to change at line 1273
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex El Torito, _definition @cindex El Torito, _definition
An @strong{El Torito} An @strong{El Torito}
boot record points the bootstrapping facility to a boot catalog boot record points the bootstrapping facility to a boot catalog
with one or more boot images, which are binary program files stored in with one or more boot images, which are binary program files stored in
the ISO image. the ISO image.
The content of the boot image files is not in the scope of El Torito. The content of the boot image files is not in the scope of El Torito.
@* @*
xorriso composes the boot catalog according to the boot image xorriso composes the boot catalog according to the boot image
files given and structured by options -b, -e, -el-torito-alt-boot, files given and structured by options -b, -e, -eltorito-alt-boot,
and @minus{}@minus{}efi-boot. Often it contains only one entry. and @minus{}@minus{}efi-boot. Often it contains only one entry.
@* @*
Normally the boot images are data files inside the ISO filesystem. By Normally the boot images are data files inside the ISO filesystem. By
special path "--interval:appended_partition_NNN:all::" it is possible to special path "--interval:appended_partition_NNN:all::" it is possible to
refer to an appended partition. The number NNN gives the partition number refer to an appended partition. The number NNN gives the partition number
as used with the corresponding option -append_partition. as used with the corresponding option -append_partition.
E.g.: E.g.:
@* @*
-append_partition 2 0xef /tmp/efi.img -append_partition 2 0xef /tmp/efi.img
@* @*
skipping to change at line 1342 skipping to change at line 1342
Option -e should be followed by option -no-emul-boot and no other El Torito Option -e should be followed by option -no-emul-boot and no other El Torito
options before an eventual -eltorito-alt-boot. options before an eventual -eltorito-alt-boot.
@c man .TP @c man .TP
@item @minus{}@minus{}efi-boot iso_rr_path @item @minus{}@minus{}efi-boot iso_rr_path
@kindex @minus{}@minus{}efi-boot El Torito EFI boot image @kindex @minus{}@minus{}efi-boot El Torito EFI boot image
@cindex Bootability, control, @minus{}@minus{}efi-boot @cindex Bootability, control, @minus{}@minus{}efi-boot
Perform -eltorito-alt-boot, option -e with the given Perform -eltorito-alt-boot, option -e with the given
iso_rr_path, -no-emul-boot, and again -eltorito-alt-boot. This gesture is iso_rr_path, -no-emul-boot, and again -eltorito-alt-boot. This gesture is
used for achieving EFI-bootability of the GRUB2 rescue CD. used for achieving EFI-bootability of the GRUB2 rescue CD.
@c man .TP @c man .TP
@item -boot-load-size number @item -eltorito-platform "x86"|"PPC"|"Mac"|"efi"|0xnn|nnn
@kindex -eltorito-platform El Torito Platform Id
@cindex Bootability, control, -eltorito-platform
Set the Platform Id number for the next option -b or -eltorito-boot.
The number may be chosen by a platform name or by a number between
0 and 255 (0x00 and 0xFF). "x86" = 0 is for PC-BIOS,
"PPC" = 1 for some PowerPC systems, "Mac" = 2 for some MacIntosh systems,
"efi" = 0xEF for EFI on modern PCs with x86 compatible CPUs or others.
@*
If the new platform id differs from the previous one, -eltorito-alt-boot
gets performed.
@c man .TP
@item -boot-load-size number|"full"
@kindex -boot-load-size El Torito boot image load size @kindex -boot-load-size El Torito boot image load size
@cindex Bootability, boot image load size, -boot-load-size @cindex Bootability, boot image load size, -boot-load-size
Set the number of 512-byte blocks to be loaded at boot time Set the number of 512-byte blocks to be loaded at boot time
from the boot image in the current catalog entry. from the boot image in the current catalog entry.
@*
Non-emulating BIOS bootimages usually need a load size of 4. Non-emulating BIOS bootimages usually need a load size of 4.
Nevertheless the default setting of mkisofs is to use the full size of the
boot image rounded up to a multiple of 4 512-byte blocks. This default
may be explicitely enforced by the word "full" instead of a number.
@*
EFI boot images usually get set the number of blocks occupied EFI boot images usually get set the number of blocks occupied
by the boot image file. by the boot image file.
@* @*
El Torito cannot represent load sizes higher than 65535. El Torito cannot represent load sizes higher than 65535.
@c man .TP @c man .TP
@item -hard-disk-boot @item -hard-disk-boot
@kindex -hard-disk-boot El Torito boot image emulation @kindex -hard-disk-boot El Torito boot image emulation
@cindex Bootability, boot image emulation, -hard-disk-boot @cindex Bootability, boot image emulation, -hard-disk-boot
Mark the boot image in the current catalog entry as emulated hard disk. Mark the boot image in the current catalog entry as emulated hard disk.
(Not suitable for any known boot loader.) (Not suitable for any known boot loader.)
skipping to change at line 1604 skipping to change at line 1621
@c man .TP @c man .TP
@item -part_like_isohybrid @item -part_like_isohybrid
@kindex -part_like_isohybrid Mark partitions like with isohybrid @kindex -part_like_isohybrid Mark partitions like with isohybrid
@cindex Bootability, partitions like with isohybrid, -part_like_isohybrid @cindex Bootability, partitions like with isohybrid, -part_like_isohybrid
Control whether -isohybrid-gpt-basdat, -isohybrid-gpt-hfsplus, and Control whether -isohybrid-gpt-basdat, -isohybrid-gpt-hfsplus, and
-isohybrid-apm-hfsplus apply even if not -isohybrid-mbr is present. -isohybrid-apm-hfsplus apply even if not -isohybrid-mbr is present.
No MBR partition of type 0xee emerges, even if GPT gets produced. No MBR partition of type 0xee emerges, even if GPT gets produced.
Gaps between GPT and APM partitions will not be filled by more partitions. Gaps between GPT and APM partitions will not be filled by more partitions.
Appended partitions get mentioned in APM if other APM partitions emerge. Appended partitions get mentioned in APM if other APM partitions emerge.
@c man .TP @c man .TP
@item -iso_mbr_part_type "default"|number
@kindex -iso_mbr_part_type Set type of ISO MBR partition
@cindex Bootability, type of ISO MBR partition, -iso_mbr_part_type
Set the partition type
of the MBR partition which represents the ISO or at least protects it.
Number may be 0x00 to 0xff. The text "default" re-enables the default types
of the various occasions to create an ISO MBR partition.
@*
This is without effect if no such partition emerges by other settings or
if the partition type is prescribed mandatorily like 0xee for GPT protective
MBR or 0x96 for CHRP.
@c man .TP
@item @minus{}@minus{}protective-msdos-label @item @minus{}@minus{}protective-msdos-label
@kindex @minus{}@minus{}protective-msdos-label Patch System Area partition tab le @kindex @minus{}@minus{}protective-msdos-label Patch System Area partition tab le
@cindex Bootability, patch System Area partition table, @minus{}@minus{}protecti ve-msdos-label @cindex Bootability, patch System Area partition table, @minus{}@minus{}protecti ve-msdos-label
Patch the System Area by a simple PC-DOS partition table where partition 1 Patch the System Area by a simple PC-DOS partition table where partition 1
claims the range of the ISO image but leaves the first block unclaimed. claims the range of the ISO image but leaves the first block unclaimed.
@c man .TP @c man .TP
@item @minus{}@minus{}mbr-force-bootable @item @minus{}@minus{}mbr-force-bootable
@kindex @minus{}@minus{}mbr-force-bootable Enforce MBR bootable/active flag @kindex @minus{}@minus{}mbr-force-bootable Enforce MBR bootable/active flag
@cindex Bootability, bootable MBR partition, @minus{}@minus{}mbr-force-bootable @cindex Bootability, bootable MBR partition, @minus{}@minus{}mbr-force-bootable
Enforce an MBR partition with "bootable/active" flag if options like Enforce an MBR partition with "bootable/active" flag if options like
@minus{}@minus{}protective-msdos-label or @minus{}@minus{}grub2-mbr are given. @minus{}@minus{}protective-msdos-label or @minus{}@minus{}grub2-mbr are given.
These options normally cause the flag to be set if there is an These options normally cause the flag to be set if there is an
MBR partition of type other than 0xee or 0xef. MBR partition of type other than 0xee or 0xef.
If no such partition exists, then no bootflag is set, unless If no such partition exists, then no bootflag is set, unless
@minus{}@minus{}mbr-force-bootable forces creation of a dummy partition @minus{}@minus{}mbr-force-bootable forces creation of a dummy partition
of type 0x00 which covers only the first block of the ISO image. of type 0x00 which covers only the first block of the ISO image.
@*
If no bootable MBR is indicated by other options and a partition gets created
by -append_partition, then @minus{}@minus{}mbr-force-bootable causes a
bootflag like it would do with e.g. @minus{}@minus{}protective-msdos-label.
@c man .TP @c man .TP
@item -partition_offset 2kb_block_adr @item -partition_offset 2kb_block_adr
@kindex -partition_offset Make mountable by partition 1 @kindex -partition_offset Make mountable by partition 1
@cindex Mountability, by non-trivial partition 1, -partition_offset @cindex Mountability, by non-trivial partition 1, -partition_offset
Cause a partition table with a single partition that begins at the Cause a partition table with a single partition that begins at the
given block address. This is counted in 2048 byte given block address. This is counted in 2048 byte
blocks, not in 512 byte blocks. If the block address is non-zero then it must blocks, not in 512 byte blocks. If the block address is non-zero then it must
be at least 16. Values larger than 16 are hardly of use. be at least 16. Values larger than 16 are hardly of use.
A non-zero partition offset causes two superblocks to be A non-zero partition offset causes two superblocks to be
generated and two sets of directory trees. The image is then mountable from its generated and two sets of directory trees. The image is then mountable from its
skipping to change at line 2765 skipping to change at line 2798
Expect to get asked more questions before solutions can be proposed. Expect to get asked more questions before solutions can be proposed.
@c man .SH AUTHOR @c man .SH AUTHOR
@node Legal, CommandIdx, Bugreport, Top @node Legal, CommandIdx, Bugreport, Top
@chapter Author, Copyright, Credits @chapter Author, Copyright, Credits
@section Author @section Author
Thomas Schmitt <scdbackup@@gmx.net> Thomas Schmitt <scdbackup@@gmx.net>
@* @*
for libburnia-project.org for libburnia-project.org
@c man .SH COPYRIGHT @c man .SH COPYRIGHT
@section Copyright @section Copyright
Copyright (c) 2011 - 2016 Thomas Schmitt Copyright (c) 2011 - 2017 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of xorriso. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of xorriso then you are entitled
to modify this text under that same license. to modify this text under that same license.
@c man .SH CREDITS @c man .SH CREDITS
@section Credits @section Credits
@command{xorrisofs} is in part based on work by Vreixo Formoso who provides @command{xorrisofs} is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team. libisofs together with Mario Danic who also leads the libburnia team.
Vladimir Serbinenko contributed the HFS+ filesystem code and related knowledge. Vladimir Serbinenko contributed the HFS+ filesystem code and related knowledge.
 End of changes. 12 change blocks. 
8 lines changed or deleted 41 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)