From 7ffce06b8c11f98e3760e7cf1e5be6b03fc1da40 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Thu, 29 Jan 2015 09:13:18 +0000 Subject: [PATCH] Mentioned -report_el_torito parameters cmd and as_mkisofs --- xorriso/xorriso.1 | 19 ++++++++++- xorriso/xorriso.info | 77 ++++++++++++++++++++++++++------------------ xorriso/xorriso.texi | 19 ++++++++++- 3 files changed, 82 insertions(+), 33 deletions(-) diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index db26339d..1449f929 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -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, Nov 04, 2014" +.TH XORRISO 1 "Version 1.3.9, Jan 29, 2015" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -3803,6 +3803,20 @@ 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 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. +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. +.br +Parameter \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. .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 @@ -3814,6 +3828,9 @@ 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 +command \-report_el_torito. See above. +.br With parameter \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". diff --git a/xorriso/xorriso.info b/xorriso/xorriso.info index 7a789781..56d51187 100644 --- a/xorriso/xorriso.info +++ b/xorriso/xorriso.info @@ -3319,6 +3319,19 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm in the El Torito boot catalog of the loaded ISO image. With parameter *help* print a text which explains the meaning of the lines put out by "plain". + Parameter *cmd* tries to print the *xorriso* commands which are + necessary to produce the found El Torito equipment and System Area. + 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. + Parameter *as_mkisofs* tries to print the *xorriso -as mkisofs* + 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. -report_system_area "plain"|"help"|"gpt_crc_of:"disk_path With parameter *plain* print a report about the information found @@ -3329,6 +3342,8 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm 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. + Parameters *cmd* and *as_mkisofs* work like with command + -report_el_torito. See above. With parameter *gpt_crc_of:*disk_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 @@ -5199,7 +5214,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -reassure enables confirmation question: DialogCtl. (line 32) * -report_about controls verbosity: Exception. (line 55) * -report_el_torito shows Boot Catalog: Inquiry. (line 124) -* -report_system_area shows MBR, GPT, and alike: Inquiry. (line 130) +* -report_system_area shows MBR, GPT, and alike: Inquiry. (line 143) * -return_with controls exit value: Exception. (line 39) * -rm deletes files from ISO image: Manip. (line 21) * -rm_r deletes trees from ISO image: Manip. (line 28) @@ -5380,7 +5395,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Image, set volume timestamp, -volume_date: SetWrite. (line 212) * Image, show Boot Catalog: Inquiry. (line 124) * Image, show id strings, -pvd_info: Inquiry. (line 115) -* Image, show MBR, GPT, and alike, -pvd_info: Inquiry. (line 130) +* Image, show MBR, GPT, and alike, -pvd_info: Inquiry. (line 143) * Input Character Set, _definition: Charset. (line 25) * Insert, enable overwriting, -overwrite: SetInsert. (line 131) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 55) @@ -5586,34 +5601,34 @@ Node: Charset152951 Node: Exception156266 Node: DialogCtl162386 Node: Inquiry164984 -Node: Navigate172415 -Node: Verify180713 -Node: Restore190540 -Node: Emulation199144 -Node: Scripting209532 -Node: Frontend217303 -Node: Examples226910 -Node: ExDevices228088 -Node: ExCreate228754 -Node: ExDialog230039 -Node: ExGrowing231304 -Node: ExModifying232109 -Node: ExBootable232613 -Node: ExCharset233165 -Node: ExPseudo234057 -Node: ExCdrecord234955 -Node: ExMkisofs235272 -Node: ExGrowisofs236612 -Node: ExException237747 -Node: ExTime238201 -Node: ExIncBackup238660 -Node: ExRestore242650 -Node: ExRecovery243583 -Node: Files244153 -Node: Seealso245452 -Node: Bugreport246175 -Node: Legal246756 -Node: CommandIdx247767 -Node: ConceptIdx264648 +Node: Navigate173322 +Node: Verify181620 +Node: Restore191447 +Node: Emulation200051 +Node: Scripting210439 +Node: Frontend218210 +Node: Examples227817 +Node: ExDevices228995 +Node: ExCreate229661 +Node: ExDialog230946 +Node: ExGrowing232211 +Node: ExModifying233016 +Node: ExBootable233520 +Node: ExCharset234072 +Node: ExPseudo234964 +Node: ExCdrecord235862 +Node: ExMkisofs236179 +Node: ExGrowisofs237519 +Node: ExException238654 +Node: ExTime239108 +Node: ExIncBackup239567 +Node: ExRestore243557 +Node: ExRecovery244490 +Node: Files245060 +Node: Seealso246359 +Node: Bugreport247082 +Node: Legal247663 +Node: CommandIdx248674 +Node: ConceptIdx265555  End Tag Table diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index b30b873b..cc65fb21 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -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 XORRISO 1 "Version 1.3.9, Nov 04, 2014" +@c man .TH XORRISO 1 "Version 1.3.9, Jan 29, 2015" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -4419,6 +4419,20 @@ in the El Torito boot catalog of the loaded ISO image. @* With parameter @strong{help} print a text which explains the meaning of the lines put out by "plain". +@* +Parameter @strong{cmd} tries to print the @strong{xorriso} commands which are +necessary to produce the found El Torito equipment and System Area. +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. +@* +Parameter @strong{as_mkisofs} tries to print the @strong{xorriso -as mkisofs} +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. @c man .TP @item -report_system_area "plain"|"help"|"gpt_crc_of:"disk_path @kindex -report_system_area shows MBR, GPT, and alike @@ -4432,6 +4446,9 @@ lines put out by "plain". You probably will have to look for more documentation which explains the technical details of the mentioned boot facilities. @* +Parameters @strong{cmd} and @strong{as_mkisofs} work like with +command -report_el_torito. See above. +@* With parameter @strong{gpt_crc_of:}disk_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".