Updated man xorriso about -report_system_area cmd

This commit is contained in:
2015-05-16 10:36:06 +00:00
parent 0a8b9c3af4
commit 70d5101d12
3 changed files with 96 additions and 85 deletions

View File

@ -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 XORRISO 1 "Version 1.3.9, Apr 20, 2015"
.TH XORRISO 1 "Version 1.3.9, Mai 16, 2015"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -3876,42 +3876,46 @@ The timestamps get not automatically propagated from loaded image to newly
written image. The ones for new images may be set by command \-volume_date.
See there for the meaning of the particular timestamps.
.TP
\fB\-report_el_torito\fR "plain"|"help"
\fB\-report_el_torito\fR mode
.br
With parameter \fBplain\fR print a report about the information found
With mode \fBplain\fR print a report about the information found
in the El Torito boot catalog of the loaded ISO image.
.br
With parameter \fBhelp\fR print a text which explains the meaning of the
With mode \fBhelp\fR print a text which explains the meaning of the
lines put out by "plain".
.br
Parameter \fBcmd\fR tries to print the \fBxorriso\fR commands which are
necessary to produce the found El Torito equipment and System Area.
Mode \fBcmd\fR tries to print the \fBxorriso\fR commands which are
necessary to produce the found boot equipment: disk identifiers,
El Torito boot images, and System Area. Disk identifiers are strings
which the booting operating system might use to find the ISO filesystem
from where it comes. Currently known is the use of volume id and
modification date.
.br
The intended use case is modification of the filesystem by having \-indev
and \-outdev pointing to different images or drives.
The result might be insufficient, if the found equipment cannot be
produced by xorriso.
produced by xorriso. Various SORRY events may arise in this case, but
it is not guaranteed that xorriso recognizes all its insufficiencies.
.br
Parameter \fBas_mkisofs\fR tries to print the \fBxorriso \-as mkisofs\fR
Mode \fBas_mkisofs\fR tries to print the \fBxorriso \-as mkisofs\fR
options, which are necessary to produce the found equipment.
The intended use case is to use the mounted filesystem as input tree
together with the printed options. In some cases (e.g. \-isohybrid\-mbr) it
might be necessary to extract data from ISO to hard disk in order to
use the hard disk files as arguments of \-as mkisofs options.
together with the printed options.
.TP
\fB\-report_system_area\fR "plain"|"help"|"gpt_crc_of:"disk_path
With parameter \fBplain\fR print a report about the information found in
\fB\-report_system_area\fR mode
With mode \fBplain\fR print a report about the information found in
the System Area of the loaded ISO image. The report consists of zero to
many lines with a header text, a colon, and information text.
.br
With parameter \fBhelp\fR print a text which explains the meaning of the
With mode \fBhelp\fR print a text which explains the meaning of the
lines put out by "plain". You probably will have to look
for more documentation which explains the technical details of the
mentioned boot facilities.
.br
Parameters \fBcmd\fR and \fBas_mkisofs\fR work like with
Modes \fBcmd\fR and \fBas_mkisofs\fR work like with
command \-report_el_torito. See above.
.br
With parameter \fBgpt_crc_of:\fRdisk_path read up to 32 KiB from the disk
With mode \fBgpt_crc_of:\fRdisk_path read up to 32 KiB from the disk
file with the path given after the colon. Compute the GPT compliant CRC number
and print it to the result channel. The number is shown like "0x690fd979".
The special disk_path "\-" causes reading from standard input.