|
|
|
@ -24,16 +24,38 @@ See man xorriso for a documentation of xorriso concepts and commands.
|
|
|
|
|
See man xorrecord for details of the burn image file feature. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Quick start: |
|
|
|
|
Quick start |
|
|
|
|
|
|
|
|
|
xorriso -launch_frontend $(which xorriso-tcltk) --stdio -- |
|
|
|
|
In the xorriso build directory, without installation of xorriso: |
|
|
|
|
|
|
|
|
|
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. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Program start options |
|
|
|
|
|
|
|
|
|
The Tcl shell "wish" is allergic to options which start by "-h". |
|
|
|
|
So here is the output of xorriso-tcltk --help : |
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
|
Usage: |
|
|
|
|
xorriso-tcltk [options] |
|
|
|
|
frontend/xorriso-tcltk [options] |
|
|
|
|
Options: |
|
|
|
|
All options must be given with two dashes ("--option") in |
|
|
|
|
order to distinguish them from any options of the Tcl shell. |
|
|
|
@ -51,6 +73,9 @@ Options:
|
|
|
|
|
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. |
|
|
|
|
--silent_start |
|
|
|
|
Do not issue the start message xorriso-tcltk-version. |
|
|
|
|
This works only if --silent_start is the first argument. |
|
|
|
|
--geometry {+|-}X{+|-}Y |
|
|
|
|
Sets the position of the main window. |
|
|
|
|
--click_to_focus |
|
|
|
@ -63,229 +88,12 @@ Options:
|
|
|
|
|
Set a file address for logging of xorriso commands and |
|
|
|
|
reply messages. The log lines will be appended. |
|
|
|
|
|
|
|
|
|
Either --stdio or --named_pipes must be given for a program run. |
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Overview of GUI elements |
|
|
|
|
|
|
|
|
|
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. |
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
|
Connection to xorriso |
|
|
|
|
|
|
|
|
|
The "End" button leads to the end of frontend and xorriso process. |
|
|
|
|
|
|
|
|
|
The ready/busy field indicates whether a xorriso command is being executed |
|
|
|
|
and the frontend is still waiting for its reply messages. |
|
|
|
|
|
|
|
|
|
The "Command:" field can be used to send commands to xorriso. |
|
|
|
|
|
|
|
|
|
The "Refresh state display" button causes the other two main areas to update |
|
|
|
|
their display after manually transmitted commands may have changed the state |
|
|
|
|
of drives or ISO model. |
|
|
|
|
|
|
|
|
|
The "Log pipes" switch controls whether all xorriso commands and replies |
|
|
|
|
shall be logged to standard error resp. to the file that has been iven |
|
|
|
|
with program argumen --log_file. Caution: This log is verbous. |
|
|
|
|
|
|
|
|
|
The message box displays commands sent to xorriso and messages recieved |
|
|
|
|
from xorriso. |
|
|
|
|
Many commands which are emitted by the GUI will hide themselves and their |
|
|
|
|
replies from this display. |
|
|
|
|
All event messages with severity WARNING or higher will show up, nevertheless. |
|
|
|
|
|
|
|
|
|
The "Recent problem:" field shows the most severe event message that occured |
|
|
|
|
during the execution of the most recent command. It also displays the most |
|
|
|
|
recent problem message from the frontend program itself. |
|
|
|
|
Several commands emitted by the GUI will not clear this display. But any |
|
|
|
|
manually transmitted command and the major GUI gestures will do. |
|
|
|
|
|
|
|
|
|
The "Worst problem:" field shows the most severe event message that occured |
|
|
|
|
since last time the "Clear" button was hit. It will not clear automatically. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
|
Management of drives and image files |
|
|
|
|
|
|
|
|
|
The "Scan for drives" button executes command -devices and puts the list |
|
|
|
|
of found optical drives into the box underneath the button. |
|
|
|
|
|
|
|
|
|
The "Pick input drive" button executes command -indev and obtains some |
|
|
|
|
information about the medium status. This info is displayed in the |
|
|
|
|
"Input drive or image" line. |
|
|
|
|
Further it causes the display of the ISO image model to be updated. |
|
|
|
|
|
|
|
|
|
The "Pick output drive" button executes command -outdev and displays the |
|
|
|
|
related info in the "Output drive or image" line. |
|
|
|
|
|
|
|
|
|
The "Pick drive for both roles" button executes command -dev and displays |
|
|
|
|
info in both "... drive or image" lines. |
|
|
|
|
|
|
|
|
|
The "Give up drives" executes commands -indev "" -outdev "" and clears |
|
|
|
|
both "... drive or image" lines, as well as the ISO model. |
|
|
|
|
|
|
|
|
|
The "Calm drives" button executes command -calm_drives which tells the |
|
|
|
|
aquired optical drives to stop spinning until the next drive activity |
|
|
|
|
gets triggered. |
|
|
|
|
|
|
|
|
|
The "Rollback" button excutes command -rollbackwhich drops all pending |
|
|
|
|
changes of the ISO model and reloads it from the input drive, if one is |
|
|
|
|
aquired. |
|
|
|
|
|
|
|
|
|
The box underneath these buttons shows the optical drives found by the |
|
|
|
|
"Can for drives" button. |
|
|
|
|
A double-click on a drive item has the same effect as button "Pick drive |
|
|
|
|
for both roles". |
|
|
|
|
|
|
|
|
|
The line "Input drive or image" displays address and medium status of |
|
|
|
|
the input drive. |
|
|
|
|
Its "Eject" button excutes command -eject "in". |
|
|
|
|
Editing the drive address and pressing the Return key causes the execution |
|
|
|
|
of command -indev with the field content as drive address. Use this to |
|
|
|
|
load the model from ISO image data files on hard disk. |
|
|
|
|
|
|
|
|
|
The line "Output drive or image" does about the same for the output drive. |
|
|
|
|
The text input field can be used to address an existing ISO image data |
|
|
|
|
file or to address a data file that does not yet exist. In the latter |
|
|
|
|
case, the ,edium status will be blank. |
|
|
|
|
|
|
|
|
|
The "Blank" button executes command -blank "as_needed" on the output drive. |
|
|
|
|
This also applies to ISO image data files, which will get invalidated by |
|
|
|
|
a small write operation. |
|
|
|
|
|
|
|
|
|
The "Format" button executes -format "as_needed". |
|
|
|
|
This only applies to real optical drives and s of interest only with DVD-RW |
|
|
|
|
or BD-R media, which both can be used formatted and unformatted. Other media |
|
|
|
|
types which mandatorily need formatting will be formatted by the write |
|
|
|
|
commands. |
|
|
|
|
|
|
|
|
|
The "Write ISO session" executes command -commit, which writes a session |
|
|
|
|
with all pending changes to the output drive. The output drive must be |
|
|
|
|
either blank or it must be the same as the input drive. |
|
|
|
|
|
|
|
|
|
The "Close" switch controls whether command -close "on" is emitted with |
|
|
|
|
"Write ISO session" or whether -as cdrecord option -multi is omitted with |
|
|
|
|
"Burn image file:". |
|
|
|
|
|
|
|
|
|
The "TAO" switch controls whether an incremental write type shall be |
|
|
|
|
enforced with write commands. Normally xorriso will decide by medium status |
|
|
|
|
and job parameters which write type to choose. |
|
|
|
|
|
|
|
|
|
The "Defect Mgt" switch controls whether slow and error-prone drive internal |
|
|
|
|
check reading shall be enabled with formatted BD-R or with BD-RE. |
|
|
|
|
|
|
|
|
|
The "Burn image file:" button executes command -as "cdrecord" with the |
|
|
|
|
content of its text field as disk file address of a data file that is |
|
|
|
|
to be written to the output drive. |
|
|
|
|
The medium in the drive may be blank or appendable. |
|
|
|
|
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. |
|
|
|
|
|
|
|
|
|
In the running GUI, click with the rightmost mouse button on |
|
|
|
|
any GUI element to get its particular help text. |
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
|
Inspection, manipulation, and exploitation of xorriso ISO image model |
|
|
|
|
|
|
|
|
|
The "Extract to disk:" button executes command -extract with the whole |
|
|
|
|
tree of the current ISO directory or with the selected items of the box |
|
|
|
|
underneath "ISO directory:". |
|
|
|
|
This copies the selected files or directory trees from the input drive |
|
|
|
|
to the address on hard disk which is given by the text filed right of |
|
|
|
|
the button. |
|
|
|
|
|
|
|
|
|
The "Underneath" switch controls the effective hard disk address of an item |
|
|
|
|
if the address in the text field points to a directory. If "Underneath" |
|
|
|
|
is enabled, then the file object from the ISO filesystem will be copied to its |
|
|
|
|
name underneath the hard disk directory. |
|
|
|
|
If "Underneath" is disabled then an ISO directory tree item will be merged |
|
|
|
|
with the disk directory tree at the given address. |
|
|
|
|
Example: |
|
|
|
|
Selected are "/iso_dir" and "/iso_file". |
|
|
|
|
Address for hard disk is "/tmp/from_iso". Switch "Selected" is enabled. |
|
|
|
|
"Underneath" enabled causes commands: |
|
|
|
|
-extract /iso_dir /tmp/from_iso/iso_dir |
|
|
|
|
-extract /iso_file /tmp/from_iso/iso_file |
|
|
|
|
"Underneath" disabled: |
|
|
|
|
-extract /iso_dir /tmp/from_iso |
|
|
|
|
-extract /iso_file /tmp/from_iso |
|
|
|
|
The last command will fail because /tmp/from_iso already exists as directory. |
|
|
|
|
|
|
|
|
|
The "Selected" switch controls whether the whole current ISO directory, |
|
|
|
|
or only the selected items shall be copied to to hard disk. |
|
|
|
|
|
|
|
|
|
The "Overwrite files" switch controls whether existing files may be |
|
|
|
|
overwritten in the ISO image or by extraction on hard disk. |
|
|
|
|
The frontend program will only detect the most obvious name collisions, |
|
|
|
|
but xorriso will reliably refuse to overwrite files if this is banned. |
|
|
|
|
|
|
|
|
|
The "Overwrite ISO dirs" switch controls whether it is allowed to replace |
|
|
|
|
an ISO directory by a non-directory file. |
|
|
|
|
If a directory is copied to a directory, then both directory trees will |
|
|
|
|
be merged. So this switch applies only to situations where non-directories |
|
|
|
|
hit directories. |
|
|
|
|
|
|
|
|
|
The "Enforce disk dir write access" switch enables the options "auto_chmod_on" |
|
|
|
|
and "sort_lba_on". "auto_chmod_on" allows xorriso to give itself temporariy |
|
|
|
|
w-permission to all disk directories which are owned by the xorriso user. |
|
|
|
|
This is not without dangers, of course, but comes in handy with restoring of |
|
|
|
|
backups. |
|
|
|
|
Option "sort_lba_on" reduces head-moves of optical drives and thus can |
|
|
|
|
speed up extraction substantially. It is bound to "auto_chmod_on" because |
|
|
|
|
else it might get in trouble when restoring ISO directories which offer |
|
|
|
|
no w-permission. |
|
|
|
|
|
|
|
|
|
The "Refresh avail:" button triggers a time consuming exact prediction |
|
|
|
|
of the free space on the medium in the output drive. For this purpose, |
|
|
|
|
the size of an ISO session with the pending changes is computed. |
|
|
|
|
With image files rather than real optical drives, the free space of |
|
|
|
|
the hosting filesystem is displayed. |
|
|
|
|
|
|
|
|
|
The "Insert from disk:" button executes command -map with the disk file |
|
|
|
|
address that is given by the text field right to the button. |
|
|
|
|
|
|
|
|
|
The switch "Underneath" has the same effect as with file extraction: |
|
|
|
|
If enabled, a directory from disk will not be unpacked to its single files |
|
|
|
|
but put underneath the target address by its own leaf name. |
|
|
|
|
If the switch "Selected" is enabled, then the given disk file or tree will |
|
|
|
|
be inserted at or underneath the only selected item in the box inderneath |
|
|
|
|
"ISO directory:". |
|
|
|
|
|
|
|
|
|
The text field in the "ISO directory:" line displays the current ISO |
|
|
|
|
directory and can be used to toggle its path directly. Hitting the |
|
|
|
|
Return key causes the current directory to change and the display in |
|
|
|
|
the box underneath to be refreshed. |
|
|
|
|
|
|
|
|
|
The "Up" buttons move the current ISO directory one directory level up. |
|
|
|
|
|
|
|
|
|
The "Verify" button executes -md5_check_r "SORRY" with the current ISO |
|
|
|
|
directory. ISO images bear MD5s for each data file if they were produced |
|
|
|
|
by xorriso with -md5 "on" resp. -for_backup. This frontend enables this |
|
|
|
|
feature on startup. |
|
|
|
|
|
|
|
|
|
The list box underneath the "ISO directory:" line displays the files in |
|
|
|
|
the current ISO directory. One or more item can be selected and play a |
|
|
|
|
role with extraction or insertion of files. |
|
|
|
|
Most of the buttons underneath the box operate on the selected items |
|
|
|
|
unconditionally. |
|
|
|
|
|
|
|
|
|
The "Verify" button in the "ISO selection:" line executes command |
|
|
|
|
-md5_check_r "SORRY" with each of the selected items. |
|
|
|
|
|
|
|
|
|
The "Delete" button executes command -rm_r with each of the selected items. |
|
|
|
|
|
|
|
|
|
The "Rename to:" button iuses command -mv to move each of the selected |
|
|
|
|
items to the address that is given by the text field right to the button. |
|
|
|
|
If this address points to an existing ISO directory, then the items will |
|
|
|
|
be moved underneath that directory and keep their leaf names. |
|
|
|
|
Else there may be only one selected item which will be renamed to the |
|
|
|
|
given address. |
|
|
|
|
|
|
|
|
|
The "Make dir" button executes command -mkdir with the address in the |
|
|
|
|
text field to its left (the same as used by "Rename to:"). Useful to |
|
|
|
|
create a target directory before moving the selection. |
|
|
|
|
|
|
|
|
|