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

New command -launch_frontend

Browse Source
This commit is contained in:
Thomas Schmitt
2012-12-20 20:22:58 +00:00
parent fccdbab373
commit cbb658991b
16 changed files with 525 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
libisoburn/trunk/xorriso/xorriso.texi
View File

@ -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.2.5, Dec 18, 2012"
@c man .TH XORRISO 1 "Version 1.2.5, Dec 20, 2012"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -5374,6 +5374,67 @@ Print to the result channel a blank separated list of all severity names.
Sorted from low to high severity.
@*
@c man .TP
@item -launch_frontend program_with_args command_pipe reply_pipe
@kindex -launch_frontend starts frontend program at pipes
@cindex Frontend program, start at pipes, -launch_frontend
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.
@c man .TP
@item -prog text
@kindex -prog sets program name
@cindex Program, set name, -prog