New command -msg_op
This commit is contained in:
@ -3920,6 +3920,65 @@ File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Co
|
||||
`xorriso' is ready for the next dialog line or before `xorriso'
|
||||
performs a command that was entered to the pager prompt.
|
||||
|
||||
-msg_op opcode parameter_text
|
||||
This command shall facilitate extraction of particular information
|
||||
from the message output of other commands. It gives access to the
|
||||
C API function Xorriso_parse_line and to the message sieve that is
|
||||
provided by the C API. Please refer to their description in file
|
||||
xorriso.h.
|
||||
Intended users are frontend programs which operate xorriso in
|
||||
dialog mode.
|
||||
The result output of this command is not caught by the message
|
||||
sieve.
|
||||
The following opcodes are defined:
|
||||
*start_sieve*
|
||||
Install the message sieve as of Xorriso_sieve_big() and start
|
||||
watching program messages. The parameter_text has no meaning.
|
||||
*show_sieve*
|
||||
Show a list of filter rule names. The parameter_text has no
|
||||
meaning. The list begins by a line with the return value of
|
||||
Xorriso_sieve_get_result() with flag bit3. If this value is larger
|
||||
than 0, then the next line tells the number of names. The
|
||||
following lines show one name each.
|
||||
*read_sieve*
|
||||
Use the parameter_text as name of a filter rule and inquire its
|
||||
next recorded result. See Xorriso_sieve_big() for a list of names
|
||||
and reply strings.
|
||||
The recorded strings are put out on result channel. They get
|
||||
wrapped into lines which tell their structure. The first line
|
||||
tells the return value of Xorriso_sieve_get_result(). The next
|
||||
line tells the number of strings. Each string begins by a line that
|
||||
tells the number of lines of the string. Then follow these lines.
|
||||
They are to be concatenated with a newline character inbetween
|
||||
each of them. Finally the number of still available recorded
|
||||
results of the given name is put out.
|
||||
*clear_sieve*
|
||||
Dispose all recorded strings and continue watching program
|
||||
messages. The parameter_text has no meaning.
|
||||
*end_sieve*
|
||||
Dispose the sieve with its filter rules and stop watching program
|
||||
messages. The parameter_text has no meaning.
|
||||
*parse*
|
||||
Read a text from dialog input and submit it to
|
||||
Xorriso_parse_line(). The parameter_text word shall consist of
|
||||
several words separated by blanks. It will be necessary to use
|
||||
both kinds of quotation marks.
|
||||
E.g. "'ISO session :' " 0 0 1"
|
||||
The five parameter words are: prefix, separators, max_words, flag,
|
||||
number_of_input_lines. The former four are handed over to
|
||||
Xorriso_parse_line(). The number of input lines minus one tells
|
||||
xorriso how many newline characters are part of the input text.
|
||||
The announced number of text lines will be read from dialog input,
|
||||
concatenated with a newline character inbetween each of them, and
|
||||
submitted to Xorriso_parse_line() as parameter line. Note that
|
||||
newlines outside of quotation marks are interpreted as separators
|
||||
if the separators parameter is empty.
|
||||
The parsed strings are put out on result channel. They get wrapped
|
||||
into lines which tell their structure. The first line tells the
|
||||
return value of Xorriso_parse_line(). The next line tells the
|
||||
number of strings. Each string begins by a line that tells the
|
||||
number of lines of the string. Then follow these lines. They are to
|
||||
be concatenated with a newline character inbetween each of them.
|
||||
-prog text
|
||||
Use text as name of this program in subsequent messages
|
||||
|
||||
@ -4658,6 +4717,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
* -mount issues mount command for ISO session: Restore. (line 126)
|
||||
* -mount_cmd composes mount command line: Inquiry. (line 41)
|
||||
* -mount_cmd controls mount command: Inquiry. (line 57)
|
||||
* -msg_op perform operations on program messages: Frontend. (line 30)
|
||||
* -mv renames file in ISO image: Manip. (line 35)
|
||||
* -no_rc disables startup files: Scripting. (line 7)
|
||||
* -not_leaf sets exclusion pattern: SetInsert. (line 62)
|
||||
@ -4681,8 +4741,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 80)
|
||||
* -prog sets program name: Frontend. (line 30)
|
||||
* -prog_help prints help text: Frontend. (line 33)
|
||||
* -prog sets program name: Frontend. (line 89)
|
||||
* -prog_help prints help text: Frontend. (line 92)
|
||||
* -prompt prompts for enter key: Scripting. (line 110)
|
||||
* -publisher sets publisher id: SetWrite. (line 186)
|
||||
* -pvd_info shows image id strings: Inquiry. (line 93)
|
||||
@ -4944,13 +5004,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* Process, log output channels to file, -logfile: Frontend. (line 20)
|
||||
* Process, read command file, -options_from_file: Scripting. (line 12)
|
||||
* Process, set synchronizing message, -mark: Frontend. (line 25)
|
||||
* Program messages, perform operations, -msg_op: Frontend. (line 30)
|
||||
* Program, backslash conversion, -backslash_codes: Scripting. (line 67)
|
||||
* Program, curb memory, -temp_mem_limit: Scripting. (line 92)
|
||||
* Program, end and write, -end: Scripting. (line 156)
|
||||
* 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 33)
|
||||
* Program, print help text, -prog_help: Frontend. (line 92)
|
||||
* 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.
|
||||
@ -4958,7 +5019,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 30)
|
||||
* Program, set name, -prog: Frontend. (line 89)
|
||||
* 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)
|
||||
@ -5064,28 +5125,28 @@ Node: Restore174189
|
||||
Node: Emulation181099
|
||||
Node: Scripting190911
|
||||
Node: Frontend198072
|
||||
Node: Examples199373
|
||||
Node: ExDevices200551
|
||||
Node: ExCreate201210
|
||||
Node: ExDialog202495
|
||||
Node: ExGrowing203760
|
||||
Node: ExModifying204565
|
||||
Node: ExBootable205069
|
||||
Node: ExCharset205621
|
||||
Node: ExPseudo206442
|
||||
Node: ExCdrecord207340
|
||||
Node: ExMkisofs207657
|
||||
Node: ExGrowisofs208997
|
||||
Node: ExException210132
|
||||
Node: ExTime210586
|
||||
Node: ExIncBackup211045
|
||||
Node: ExRestore215037
|
||||
Node: ExRecovery215997
|
||||
Node: Files216567
|
||||
Node: Seealso217866
|
||||
Node: Bugreport218589
|
||||
Node: Legal219170
|
||||
Node: CommandIdx220181
|
||||
Node: ConceptIdx236126
|
||||
Node: Examples202666
|
||||
Node: ExDevices203844
|
||||
Node: ExCreate204503
|
||||
Node: ExDialog205788
|
||||
Node: ExGrowing207053
|
||||
Node: ExModifying207858
|
||||
Node: ExBootable208362
|
||||
Node: ExCharset208914
|
||||
Node: ExPseudo209735
|
||||
Node: ExCdrecord210633
|
||||
Node: ExMkisofs210950
|
||||
Node: ExGrowisofs212290
|
||||
Node: ExException213425
|
||||
Node: ExTime213879
|
||||
Node: ExIncBackup214338
|
||||
Node: ExRestore218330
|
||||
Node: ExRecovery219290
|
||||
Node: Files219860
|
||||
Node: Seealso221159
|
||||
Node: Bugreport221882
|
||||
Node: Legal222463
|
||||
Node: CommandIdx223474
|
||||
Node: ConceptIdx239492
|
||||
|
||||
End Tag Table
|
||||
|
||||
Reference in New Issue
Block a user