|
|
|
@ -4,7 +4,7 @@ xorriso.texi. |
|
|
|
|
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem |
|
|
|
|
images with Rock Ridge extensions. |
|
|
|
|
|
|
|
|
|
Copyright (C) 2007 - 2017 Thomas Schmitt |
|
|
|
|
Copyright (C) 2007 - 2019 Thomas Schmitt |
|
|
|
|
|
|
|
|
|
Permission is granted to distrubute this text freely. |
|
|
|
|
INFO-DIR-SECTION Archiving |
|
|
|
@ -638,6 +638,58 @@ acquire the drive. |
|
|
|
|
An empty address string "" gives up the current output drive |
|
|
|
|
without acquiring a new one. No writing is possible without an |
|
|
|
|
output drive. |
|
|
|
|
-drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern |
|
|
|
|
Add a drive path pattern to one of the safety lists or make those |
|
|
|
|
lists empty. There are three lists defined which get tested in the |
|
|
|
|
following sequence: |
|
|
|
|
If a drive address path matches the "harmless" list then the drive |
|
|
|
|
will be accepted. If it is not a MMC device then the prefix |
|
|
|
|
"stdio:" will be prepended automatically. This list is empty by |
|
|
|
|
default. |
|
|
|
|
Else if the path matches the "banned" list then the drive will not |
|
|
|
|
be accepted by 'xorriso' but rather lead to a FAILURE event. This |
|
|
|
|
list is empty by default. |
|
|
|
|
Else if the path matches the "caution" list and if it is not a MMC |
|
|
|
|
device, then its address must have the prefix "stdio:" or it will |
|
|
|
|
be rejected. This list has by default one entry: "/dev". |
|
|
|
|
If a drive path matches no list then it is considered "harmless". |
|
|
|
|
By default these are all paths which do not begin with directory |
|
|
|
|
"/dev". |
|
|
|
|
A path matches a list if one of its parent paths or itself matches |
|
|
|
|
a list entry. Address prefix "stdio:" or "mmc:" will be ignored |
|
|
|
|
when testing for matches. |
|
|
|
|
By pseudo-class "clear_list" and pseudo-patterns "banned", |
|
|
|
|
"caution", "harmless", or "all", the lists may be made empty. |
|
|
|
|
E.g.: -drive_class clear_list banned |
|
|
|
|
One will normally define the -drive_class lists in one of the |
|
|
|
|
'xorriso' Startup Files. |
|
|
|
|
Note: This is not a security feature but rather a bumper for the |
|
|
|
|
superuser to prevent inadverted mishaps. For reliably blocking |
|
|
|
|
access to a device file you have to deny its rw-permissions in the |
|
|
|
|
filesystem. |
|
|
|
|
-drive_access "exclusive"|"shared":"unrestricted"|"readonly" |
|
|
|
|
Control whether device file locking mechanisms shall be used when |
|
|
|
|
acquiring a drive, and whether status or content of the medium in |
|
|
|
|
the drive may be altered. Useful and most harmless are the setting |
|
|
|
|
"shared:readonly" and the default setting "exclusive:unrestricted". |
|
|
|
|
|
|
|
|
|
"exclusive" enables tests and locks when acquiring the drive. It |
|
|
|
|
depends on the operating system which locking mechanisms get |
|
|
|
|
applied, if any. On GNU/Linux it is open(O_EXCL). On FreeBSD it is |
|
|
|
|
flock(LOCK_EX). |
|
|
|
|
"shared" disables the use of these mechanisms to become able to |
|
|
|
|
acquire drives which are mounted, or opened by some process, or |
|
|
|
|
guarded by /dev/pktcdvd*. |
|
|
|
|
"unrestricted" enables all technically appropriate operations on an |
|
|
|
|
acquired drive. "shared:unrestricted" risks to get own burn runs |
|
|
|
|
spoiled by other processes or to vice versa spoil activities of |
|
|
|
|
such processes. So use "exclusive:unrestricted" unless you know |
|
|
|
|
for sure that "shared" is safe. |
|
|
|
|
"readonly" disables operations which might surprise a co-user of |
|
|
|
|
the drive. For -outdev these are formatting, blanking, writing, |
|
|
|
|
ejecting. For -indev this is ejecting. Be aware that even reading |
|
|
|
|
and drive status inquiries can disturb an ongoing burn run on |
|
|
|
|
CD-R[W] and DVD-R[W]. |
|
|
|
|
-scsi_dev_family "default"|"sr"|"scd"|"sg" |
|
|
|
|
GNU/Linux specific: |
|
|
|
|
By default, xorriso tries to map Linux drive addresses to /dev/sr* |
|
|
|
@ -744,35 +796,6 @@ activate them only after image loading. |
|
|
|
|
will have to employ a loop device instead.) |
|
|
|
|
In both cases, the ISO sessions should be self contained, i.e. not |
|
|
|
|
add-on sessions to an ISO image outside their track or partition. |
|
|
|
|
-drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern |
|
|
|
|
Add a drive path pattern to one of the safety lists or make those |
|
|
|
|
lists empty. There are three lists defined which get tested in the |
|
|
|
|
following sequence: |
|
|
|
|
If a drive address path matches the "harmless" list then the drive |
|
|
|
|
will be accepted. If it is not a MMC device then the prefix |
|
|
|
|
"stdio:" will be prepended automatically. This list is empty by |
|
|
|
|
default. |
|
|
|
|
Else if the path matches the "banned" list then the drive will not |
|
|
|
|
be accepted by 'xorriso' but rather lead to a FAILURE event. This |
|
|
|
|
list is empty by default. |
|
|
|
|
Else if the path matches the "caution" list and if it is not a MMC |
|
|
|
|
device, then its address must have the prefix "stdio:" or it will |
|
|
|
|
be rejected. This list has by default one entry: "/dev". |
|
|
|
|
If a drive path matches no list then it is considered "harmless". |
|
|
|
|
By default these are all paths which do not begin with directory |
|
|
|
|
"/dev". |
|
|
|
|
A path matches a list if one of its parent paths or itself matches |
|
|
|
|
a list entry. Address prefix "stdio:" or "mmc:" will be ignored |
|
|
|
|
when testing for matches. |
|
|
|
|
By pseudo-class "clear_list" and pseudo-patterns "banned", |
|
|
|
|
"caution", "harmless", or "all", the lists may be made empty. |
|
|
|
|
E.g.: -drive_class clear_list banned |
|
|
|
|
One will normally define the -drive_class lists in one of the |
|
|
|
|
'xorriso' Startup Files. |
|
|
|
|
Note: This is not a security feature but rather a bumper for the |
|
|
|
|
superuser to prevent inadverted mishaps. For reliably blocking |
|
|
|
|
access to a device file you have to deny its rw-permissions in the |
|
|
|
|
filesystem. |
|
|
|
|
-read_fs "any"|"norock"|"nojoliet"|"ecma119" |
|
|
|
|
Specify which kind of filesystem tree to load if present. If the |
|
|
|
|
wish cannot be fulfilled, then ECMA-119 names are loaded and |
|
|
|
@ -920,7 +943,7 @@ activate them only after image loading. |
|
|
|
|
point for timestamps of ISO 9660 nodes without a disk source file |
|
|
|
|
and as default for superblock timestamps. |
|
|
|
|
If a timestring is given, then it is used for such timestamps. For |
|
|
|
|
the formats of time strings see command *-alter_date*. |
|
|
|
|
the formats of timestrings see command *-alter_date*. |
|
|
|
|
-disk_dev_ino "on"|"ino_only"|"off" |
|
|
|
|
Enable or disable processing of recorded file identification |
|
|
|
|
numbers (dev_t and ino_t). If enabled they are stored as xattr and |
|
|
|
@ -4017,11 +4040,11 @@ The directory permissions on disk have to allow rwx. |
|
|
|
|
Option "o_excl_on" is the default unless the program was started |
|
|
|
|
with leafname "osirrox". On GNU/Linux it tries to avoid using |
|
|
|
|
drives which are mounted or in use by other libburn programs. |
|
|
|
|
Option "o_excl_off" on GNU/Linux enables access to such drives. |
|
|
|
|
Drives which get acquired while "o_excl_off" will refuse to get |
|
|
|
|
blanked, formatted, written, or ejected. But be aware that even |
|
|
|
|
harmless inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W]. |
|
|
|
|
|
|
|
|
|
Option "o_excl_off" on GNU/Linux enables access to such drives by |
|
|
|
|
the equivalent of -drive_access "shared:readonly". I.e. drives |
|
|
|
|
which get acquired while "o_excl_off" will refuse to get blanked, |
|
|
|
|
formatted, written, or ejected. But be aware that even harmless |
|
|
|
|
inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W]. |
|
|
|
|
Option "strict_acl_off" is default. It tolerates on FreeBSD the |
|
|
|
|
presence of directory "default" ACLs in the ISO image. With |
|
|
|
|
"strict_acl_on" these GNU/Linux ACLs cause on FreeBSD a FAILURE |
|
|
|
@ -5282,7 +5305,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* # starts a comment line: Scripting. (line 156) |
|
|
|
|
* -abort_on controls abort on error: Exception. (line 27) |
|
|
|
|
* -abstract_file sets abstract file name: SetWrite. (line 244) |
|
|
|
|
* -acl controls handling of ACLs: Loading. (line 173) |
|
|
|
|
* -acl controls handling of ACLs: Loading. (line 144) |
|
|
|
|
* -add inserts one or more paths: Insert. (line 44) |
|
|
|
|
* -add_plainly inserts one or more paths: Insert. (line 68) |
|
|
|
|
* -alter_date sets timestamps in ISO image: Manip. (line 139) |
|
|
|
@ -5292,14 +5315,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -application_id sets application id: SetWrite. (line 191) |
|
|
|
|
* -application_use sets application use field: SetWrite. (line 266) |
|
|
|
|
* -as emulates mkisofs or cdrecord: Emulation. (line 13) |
|
|
|
|
* -assert_volid rejects undesired images: Loading. (line 113) |
|
|
|
|
* -auto_charset learns character set from image: Loading. (line 125) |
|
|
|
|
* -assert_volid rejects undesired images: Loading. (line 84) |
|
|
|
|
* -auto_charset learns character set from image: Loading. (line 96) |
|
|
|
|
* -backslash_codes enables backslash conversion: Scripting. (line 71) |
|
|
|
|
* -ban_stdio_write demands real drive: Loading. (line 342) |
|
|
|
|
* -ban_stdio_write demands real drive: Loading. (line 313) |
|
|
|
|
* -biblio_file sets biblio file name: SetWrite. (line 250) |
|
|
|
|
* -blank erases media: Writing. (line 57) |
|
|
|
|
* -boot_image controls bootability: Bootable. (line 75) |
|
|
|
|
* -calm_drive reduces drive activity: Loading. (line 332) |
|
|
|
|
* -calm_drive reduces drive activity: Loading. (line 303) |
|
|
|
|
* -cd sets working directory in ISO: Navigate. (line 7) |
|
|
|
|
* -cdx sets working directory on disk: Navigate. (line 15) |
|
|
|
|
* -changes_pending overrides change status: Writing. (line 12) |
|
|
|
@ -5333,24 +5356,25 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -cp_rx copies file trees to disk: Restore. (line 103) |
|
|
|
|
* -cp_rx copies file trees to disk <1>: Restore. (line 111) |
|
|
|
|
* -cut_out inserts piece of data file: Insert. (line 139) |
|
|
|
|
* -data_cache_size adjusts read cache size: Loading. (line 358) |
|
|
|
|
* -data_cache_size adjusts read cache size: Loading. (line 329) |
|
|
|
|
* -dev acquires one drive for input and output: AqDrive. (line 12) |
|
|
|
|
* -devices gets list of drives: Inquiry. (line 7) |
|
|
|
|
* -device_links gets list of drives: Inquiry. (line 17) |
|
|
|
|
* -dialog enables dialog mode: DialogCtl. (line 7) |
|
|
|
|
* -disk_dev_ino fast incremental backup: Loading. (line 252) |
|
|
|
|
* -disk_dev_ino fast incremental backup: Loading. (line 223) |
|
|
|
|
* -disk_pattern controls pattern expansion: Insert. (line 34) |
|
|
|
|
* -displacement compensate altered image start address: Loading. |
|
|
|
|
(line 57) |
|
|
|
|
* -drive_class controls drive accessability: Loading. (line 75) |
|
|
|
|
* -drive_access control device file locking: AqDrive. (line 72) |
|
|
|
|
* -drive_class controls drive accessability: AqDrive. (line 43) |
|
|
|
|
* -du show directory size in ISO image: Navigate. (line 78) |
|
|
|
|
* -dummy controls write simulation: SetWrite. (line 393) |
|
|
|
|
* -dus show directory size in ISO image: Navigate. (line 81) |
|
|
|
|
* -dusx show directory size on disk: Navigate. (line 88) |
|
|
|
|
* -dux show directory size on disk: Navigate. (line 84) |
|
|
|
|
* -dvd_obs set write block size: SetWrite. (line 330) |
|
|
|
|
* -early_stdio_test classifies stdio drives: Loading. (line 346) |
|
|
|
|
* -ecma119_map names w/o Rock Ridge, Joliet: Loading. (line 234) |
|
|
|
|
* -early_stdio_test classifies stdio drives: Loading. (line 317) |
|
|
|
|
* -ecma119_map names w/o Rock Ridge, Joliet: Loading. (line 205) |
|
|
|
|
* -eject ejects drive tray: Writing. (line 50) |
|
|
|
|
* -end writes pending session and ends program: Scripting. (line 151) |
|
|
|
|
* -errfile_log logs problematic disk files: Scripting. (line 116) |
|
|
|
@ -5361,29 +5385,29 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -extract_cut copies file piece to disk: Restore. (line 80) |
|
|
|
|
* -extract_l copies files to disk: Restore. (line 76) |
|
|
|
|
* -extract_single copies file to disk: Restore. (line 73) |
|
|
|
|
* -file_name_limit curbs length of file names: Loading. (line 272) |
|
|
|
|
* -file_name_limit curbs length of file names: Loading. (line 243) |
|
|
|
|
* -file_size_limit limits data file size: SetInsert. (line 7) |
|
|
|
|
* -find traverses and alters ISO tree: CmdFind. (line 7) |
|
|
|
|
* -findx traverses disk tree: Navigate. (line 91) |
|
|
|
|
* -follow softlinks and mount points: SetInsert. (line 69) |
|
|
|
|
* -format formats media: Writing. (line 87) |
|
|
|
|
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 220) |
|
|
|
|
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 191) |
|
|
|
|
* -fs sets size of fifo: SetWrite. (line 396) |
|
|
|
|
* -getfacl shows ACL in ISO image: Navigate. (line 60) |
|
|
|
|
* -getfacl_r shows ACL in ISO image: Navigate. (line 66) |
|
|
|
|
* -getfattr shows xattr in ISO image: Navigate. (line 69) |
|
|
|
|
* -getfattr_r shows xattr in ISO image: Navigate. (line 75) |
|
|
|
|
* -gid sets global ownership: SetWrite. (line 287) |
|
|
|
|
* -grow_blindly overides next writeable address: AqDrive. (line 60) |
|
|
|
|
* -hardlinks controls handling of hard links: Loading. (line 136) |
|
|
|
|
* -grow_blindly overides next writeable address: AqDrive. (line 112) |
|
|
|
|
* -hardlinks controls handling of hard links: Loading. (line 107) |
|
|
|
|
* -help prints help text: Scripting. (line 19) |
|
|
|
|
* -hfsplus enables production of HFS+ partition: SetWrite. (line 14) |
|
|
|
|
* -hide excludes file names from directory trees: Manip. (line 177) |
|
|
|
|
* -history brings text into readline history: Scripting. (line 42) |
|
|
|
|
* -indev acquires a drive for input: AqDrive. (line 23) |
|
|
|
|
* -in_charset sets input character set: Loading. (line 120) |
|
|
|
|
* -in_charset sets input character set: Loading. (line 91) |
|
|
|
|
* -iso_nowtime fixed "now" time for ISO 9660 objects: Loading. |
|
|
|
|
(line 246) |
|
|
|
|
(line 217) |
|
|
|
|
* -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) |
|
|
|
@ -5411,7 +5435,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -map_l inserts paths from disk file: Insert. (line 96) |
|
|
|
|
* -map_single inserts path: Insert. (line 93) |
|
|
|
|
* -mark sets synchronizing message: Frontend. (line 23) |
|
|
|
|
* -md5 controls handling of MD5 sums: Loading. (line 192) |
|
|
|
|
* -md5 controls handling of MD5 sums: Loading. (line 163) |
|
|
|
|
* -mkdir creates ISO directory: Insert. (line 177) |
|
|
|
|
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 336) |
|
|
|
|
* -mount issues mount command for ISO session: Restore. (line 146) |
|
|
|
@ -5452,7 +5476,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -pwdx tells working directory on disk: Navigate. (line 21) |
|
|
|
|
* -quoted_not_list sets exclusions: SetInsert. (line 66) |
|
|
|
|
* -quoted_path_list inserts paths from disk file: Insert. (line 85) |
|
|
|
|
* -read_fs filesystem type for image loading: Loading. (line 104) |
|
|
|
|
* -read_fs filesystem type for image loading: Loading. (line 75) |
|
|
|
|
* -read_mkisofsrc searches and reads .mkisofsrc file: Emulation. |
|
|
|
|
(line 155) |
|
|
|
|
* -read_speed set read speed: Loading. (line 11) |
|
|
|
@ -5468,10 +5492,10 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
(line 51) |
|
|
|
|
* -rollback discards pending changes: Writing. (line 9) |
|
|
|
|
* -rollback_end ends program without writing: Scripting. (line 154) |
|
|
|
|
* -rom_toc_scan searches for sessions: Loading. (line 304) |
|
|
|
|
* -rom_toc_scan searches for sessions: Loading. (line 275) |
|
|
|
|
* -rr_reloc_dir sets name of relocation directory: SetWrite. (line 144) |
|
|
|
|
* -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 179) |
|
|
|
|
* -scsi_dev_family choose Linux device file type: AqDrive. (line 43) |
|
|
|
|
* -scsi_dev_family choose Linux device file type: AqDrive. (line 95) |
|
|
|
|
* -scsi_log reports SCSI commands: Scripting. (line 143) |
|
|
|
|
* -session_log logs written sessions: Scripting. (line 134) |
|
|
|
|
* -session_string composes session info line: Inquiry. (line 74) |
|
|
|
@ -5515,7 +5539,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top |
|
|
|
|
* -volume_date sets volume timestamp: SetWrite. (line 205) |
|
|
|
|
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 417) |
|
|
|
|
* -x enables automatic execution order of arguments: ArgSort. (line 16) |
|
|
|
|
* -xattr controls handling of xattr (EA): Loading. (line 180) |
|
|
|
|
* -xattr controls handling of xattr (EA): Loading. (line 151) |
|
|
|
|
* -zisofs controls zisofs production: SetWrite. (line 290) |
|
|
|
|
|
|
|
|
|
|
|
|
|
@ -5527,7 +5551,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top |
|
|
|
|
|