2012-12-27 09:53:59 +00:00
|
|
|
------------------------------------------------------------------------------
|
|
|
|
xorriso-tcltk
|
|
|
|
------------------------------------------------------------------------------
|
2013-01-03 10:18:30 +00:00
|
|
|
Copyright (C) 2012 - 2013
|
|
|
|
Thomas Schmitt <scdbackup@gmx.net>, libburnia-project.org
|
|
|
|
Provided under BSD license: Use, modify, and distribute as you like.
|
2012-12-27 09:53:59 +00:00
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
xorriso-tcltk is mainly a proof of concept for a frontend that operates
|
|
|
|
xorriso in dialog mode.
|
|
|
|
|
2012-12-30 11:53:56 +00:00
|
|
|
Dependencies:
|
|
|
|
- xorriso ISO 9660 Rock Ridge filesystem manipulator and CD/DVD/BD burn program
|
|
|
|
- Tcl programming language
|
|
|
|
- Tk widget toolkit
|
|
|
|
- optionally the Tcl/Tk package BWidget
|
|
|
|
|
2012-12-27 09:53:59 +00:00
|
|
|
It exercises several fundamental gestures of communication:
|
|
|
|
- connecting via two pipes
|
|
|
|
- sending commands
|
|
|
|
- receiving replies
|
|
|
|
- inquiring the xorriso message sieve
|
|
|
|
- using the xorriso parsing service
|
|
|
|
|
|
|
|
Note that any other language than Tcl/Tk could be used, if it only can
|
|
|
|
do i/o via standard input and standard output or via named pipes.
|
|
|
|
Further it has to perform integer arithmetics and string manipulations.
|
|
|
|
And, well, a graphical widget set would be nice.
|
|
|
|
|
|
|
|
See man xorriso for a documentation of xorriso concepts and commands.
|
|
|
|
See man xorrecord for details of the burn image file feature.
|
|
|
|
|
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
Quick start
|
2012-12-27 09:53:59 +00:00
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
In the xorriso build directory, without installation of xorriso:
|
2012-12-27 09:53:59 +00:00
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
xorriso/xorriso -launch_frontend frontend/xorriso-tcltk --stdio --
|
|
|
|
|
|
|
|
After installation of xorriso by make install:
|
|
|
|
|
|
|
|
xorriso-tcltk
|
|
|
|
|
|
|
|
|
|
|
|
Overview of GUI
|
|
|
|
|
|
|
|
The window is separated into three main areas:
|
|
|
|
- Connection to xorriso.
|
|
|
|
- Management of drives and image files.
|
|
|
|
- Inspection, manipulation, and exploitation of xorriso ISO image model.
|
|
|
|
|
|
|
|
Click the rightmost mouse button while being over any of the GUI elements
|
|
|
|
in order to get the particular help text for that element.
|
|
|
|
There is no need to close the help window. Just click another element to
|
|
|
|
get another help text.
|
|
|
|
|
2012-12-30 11:53:56 +00:00
|
|
|
The "Help" button in the upper right corner gives a short overview and
|
|
|
|
instructions for several common use cases.
|
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
|
|
|
|
Program start options
|
2012-12-27 09:53:59 +00:00
|
|
|
|
|
|
|
The Tcl shell "wish" is allergic to options which start by "-h".
|
|
|
|
So here is the output of xorriso-tcltk --help :
|
|
|
|
------------------------------------------------------------------------
|
2012-12-28 08:51:21 +00:00
|
|
|
|
2012-12-27 09:53:59 +00:00
|
|
|
Usage:
|
2013-01-15 10:49:00 +00:00
|
|
|
frontend/xorriso-tcltk [options]
|
2012-12-27 09:53:59 +00:00
|
|
|
Options:
|
|
|
|
All options must be given with two dashes ("--option") in
|
|
|
|
order to distinguish them from any options of the Tcl shell.
|
|
|
|
--help
|
|
|
|
Print this text and exit.
|
|
|
|
--stdio
|
2013-01-05 22:10:27 +00:00
|
|
|
Establish connection to xorriso via stdin and stdout.
|
2012-12-27 09:53:59 +00:00
|
|
|
E.g. when letting xorriso start this frontend program:
|
|
|
|
xorriso -launch_frontend $(which xorriso-tcltk) --stdio --
|
|
|
|
--named_pipes cmd_fifo reply_fifo
|
2013-01-05 22:10:27 +00:00
|
|
|
Establish connection to a xorriso process started by:
|
2012-12-27 09:53:59 +00:00
|
|
|
xorriso -dialog on <cmd_fifo >reply_fifo
|
|
|
|
which is then ready for a run of:
|
|
|
|
xorriso-tcltk --named_pipes cmd_fifo reply_fifo
|
|
|
|
It is important that the parent of xorriso and of this
|
|
|
|
tcl/tk frontend opens the named pipe for commands before
|
|
|
|
it opens the named pipe for replies. This avoids deadlock.
|
2012-12-28 08:51:21 +00:00
|
|
|
--silent_start
|
|
|
|
Do not issue the start message xorriso-tcltk-version.
|
|
|
|
This works only if --silent_start is the first argument.
|
2013-01-06 10:00:46 +00:00
|
|
|
--no_extract
|
|
|
|
Do not allow extraction of files from ISO filesystem to
|
|
|
|
hard disk. This is not revokable during the program run.
|
2012-12-30 11:53:56 +00:00
|
|
|
--no_bwidget
|
|
|
|
Do not try to load the Tcl/Tk package BWidget which is
|
|
|
|
a prerequisite for the "/" file browser buttons.
|
2012-12-27 09:53:59 +00:00
|
|
|
--geometry {+|-}X{+|-}Y
|
|
|
|
Sets the position of the main window.
|
|
|
|
--click_to_focus
|
|
|
|
Chooses that input fields and list boxes get the keyboard
|
2013-01-05 22:10:27 +00:00
|
|
|
focus only when being clicked by the mouse. (Default)
|
2012-12-27 09:53:59 +00:00
|
|
|
--auto_focus
|
|
|
|
Chooses that the keyboard focus is where the mouse
|
2013-01-05 22:10:27 +00:00
|
|
|
pointer is.
|
|
|
|
--pipe_log_file path
|
2012-12-27 09:53:59 +00:00
|
|
|
Set a file address for logging of xorriso commands and
|
2013-01-05 22:10:27 +00:00
|
|
|
reply messages and enable this logging.
|
|
|
|
The log lines will be appended. Path "-" means stderr.
|
|
|
|
--script_log_file path
|
2013-01-15 10:49:00 +00:00
|
|
|
Set a file address for logging of essential xorriso
|
|
|
|
commands and enable this logging.
|
2013-01-05 22:10:27 +00:00
|
|
|
The log lines will be appended. Path "-" means stderr.
|
2013-01-15 10:49:00 +00:00
|
|
|
--script_log_all_commands
|
|
|
|
With logging of commands log non-essential commands too.
|
2013-03-18 09:51:29 +00:00
|
|
|
--use_command_move
|
|
|
|
Use xorriso command -move for the "Move to: button
|
|
|
|
if xorriso version is >= 1.2.8
|
|
|
|
--use_command_mv
|
|
|
|
Use xorriso command -mv for the "Move to:" button.
|
2012-12-27 09:53:59 +00:00
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
If neither --stdio nor --named_pipes is given, then this script
|
|
|
|
will try to locate itself in the filesystem and start a xorriso
|
|
|
|
run that launches it again.
|
2012-12-27 09:53:59 +00:00
|
|
|
|
2012-12-28 08:51:21 +00:00
|
|
|
In the running GUI, click with the rightmost mouse button on
|
|
|
|
any GUI element to get its particular help text.
|
2012-12-27 09:53:59 +00:00
|
|
|
|
|
|
|
------------------------------------------------------------------------
|
|
|
|
|