New command -launch_frontend

This commit is contained in:
2012-12-20 20:22:58 +00:00
parent e560c94d98
commit 7aba2e615c
16 changed files with 525 additions and 36 deletions

View File

@ -4014,6 +4014,53 @@ File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Co
*list_sev*
Print to the result channel a blank separated list of all severity
names. Sorted from low to high severity.
-launch_frontend program_with_args command_pipe reply_pipe
Start the program that is given as first word in parameter
program_with_args. Submit the other words from that parameter as
program arguments. Enable xorriso dialog mode.
xorriso will abort when the started program ends or if it cannot
be started at all. In both cases it will return a non-zero exit
value. The exit value will be zero if the frontend sends -end or
-rollback_end before ending itself.
This command may be totaly banned at compile time. It is banned by
default if xorriso runs under setuid permissions.
The program name will not be searched in the $PATH directories.
To make this clear, it must contain at least one /-character.
Best is an absolute path. Like: /usr/bin/wish
If one of command_pipe and reply_pipe is empty, then two nameless
pipe objects are created. xorriso standard input gets connected to
the standard output of the started program. xorriso standard
output and standard error get connected to the standard input of
that program.
The frontend program should first send via its standard output:
-mark 0 -pkt_output on -msg_op start_sieve -
It should be ready to decode -pkt_output and to react on -mark
messages. Best is to increment the -mark number after each sent
command sequence and then to wait for the new number to show up in
a mark message:
some ... commands -mark <incremented_number>
Further are advised:
-report_about UPDATE -abort_on NEVER
-iso_rr_pattern off -disk_pattern off
A check of the xorriso version should be done, in order to make
sure that all desired features are present.
If command_pipe and reply_pipe are not empty, then create named
pipes with these names and use them for the connection to the
standard input and standard output of the started program. It is
not an error if the named pipes already exist.
With named pipes it is important that the frontend program opens
the command_pipe first. This is because xorriso will block at this
pipe until the frontend opens it. If the frontend would try to
open reply_pipe first, then it would block there and create a
deadlock situation.
Command -launch_frontend will only work once per xorriso run. If
all three command parameters are submitted as empty texts, then no
program will be started but nevertheless -launch_frontend will be
irrevocably disabled. If parameter program_with_args is submitted
as empty text and both pipe parameters are non-empty, then no
program will be started but the standard i/o channels of xorriso
will get connected to named pipes.
-prog text
Use text as name of this program in subsequent messages
@ -4724,6 +4771,8 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -iso_rr_pattern controls pattern expansion: Manip. (line 10)
* -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 33)
* -joliet enables production of Joliet tree: SetWrite. (line 10)
* -launch_frontend starts frontend program at pipes: Frontend.
(line 113)
* -list_arg_sorting prints sorting order of -x: ArgSort. (line 27)
* -list_delimiter replaces '--': Scripting. (line 60)
* -list_extras lists compile time extra features: Scripting.
@ -4776,8 +4825,8 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -print_info prints message text line: Scripting. (line 102)
* -print_mark prints synchronizing text line: Scripting. (line 105)
* -print_size predicts image size: Inquiry. (line 91)
* -prog sets program name: Frontend. (line 113)
* -prog_help prints help text: Frontend. (line 116)
* -prog sets program name: Frontend. (line 160)
* -prog_help prints help text: Frontend. (line 163)
* -prompt prompts for enter key: Scripting. (line 110)
* -publisher sets publisher id: SetWrite. (line 186)
* -pvd_info shows image id strings: Inquiry. (line 104)
@ -5047,7 +5096,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Program, end without writing, -rollback_end: Scripting. (line 159)
* Program, list extra features, -list_extras: Scripting. (line 26)
* Program, print help text, -help: Scripting. (line 20)
* Program, print help text, -prog_help: Frontend. (line 116)
* Program, print help text, -prog_help: Frontend. (line 163)
* Program, print message text line, -print_info: Scripting. (line 102)
* Program, print result text line, -print: Scripting. (line 99)
* Program, print synchronizing text line, -print_mark: Scripting.
@ -5055,7 +5104,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Program, print version, -version: Scripting. (line 23)
* Program, prompt for enter key, -prompt: Scripting. (line 110)
* Program, replace --, -list_delimiter: Scripting. (line 60)
* Program, set name, -prog: Frontend. (line 113)
* Program, set name, -prog: Frontend. (line 160)
* Program, show current settings, -status: Scripting. (line 47)
* Program, status history, -status_history_max: Scripting. (line 56)
* Program, wait a time span, -sleep: Scripting. (line 114)
@ -5161,28 +5210,28 @@ Node: Restore174782
Node: Emulation181692
Node: Scripting191504
Node: Frontend198665
Node: Examples204596
Node: ExDevices205774
Node: ExCreate206433
Node: ExDialog207718
Node: ExGrowing208983
Node: ExModifying209788
Node: ExBootable210292
Node: ExCharset210844
Node: ExPseudo211665
Node: ExCdrecord212563
Node: ExMkisofs212880
Node: ExGrowisofs214220
Node: ExException215355
Node: ExTime215809
Node: ExIncBackup216268
Node: ExRestore220260
Node: ExRecovery221220
Node: Files221790
Node: Seealso223089
Node: Bugreport223812
Node: Legal224393
Node: CommandIdx225404
Node: ConceptIdx241495
Node: Examples207358
Node: ExDevices208536
Node: ExCreate209195
Node: ExDialog210480
Node: ExGrowing211745
Node: ExModifying212550
Node: ExBootable213054
Node: ExCharset213606
Node: ExPseudo214427
Node: ExCdrecord215325
Node: ExMkisofs215642
Node: ExGrowisofs216982
Node: ExException218117
Node: ExTime218571
Node: ExIncBackup219030
Node: ExRestore223022
Node: ExRecovery223982
Node: Files224552
Node: Seealso225851
Node: Bugreport226574
Node: Legal227155
Node: CommandIdx228166
Node: ConceptIdx244395

End Tag Table