usage: xorriso [settings|actions] This program creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions. Write targets can be drives with optical media or local filesystem objects. Preparation options: Drive addresses are either /dev/... as listed with option -devices or disk files with prefix "stdio:", e.g. stdio:/tmp/pseudo_drive . -dev address Set input and output drive and load eventual ISO image. Set the image expansion method to growing. -indev address Set input drive and load eventual ISO image. Use expansion methods modifying or blind growing. -outdev address Set output drive and use modifying or blind growing. -grow_blindly "off"|predicted_nwa Switch between modifying and blind growing. -load "session"|"track"|"lba"|"sbsector"|"volid"|"auto" id Load a particular (outdated) ISO image from a -dev or -indev which hosts more than one session. -rom_toc_scan "on"|"off" Enable scanning for ISO sessions on read-only drives/media. -ban_stdio_write Allow for writing only the usage of optical drives. -blank "fast"|"all"|"deformat"|"deformat_quickest" Blank media resp. invalidate ISO image on media. -format "as_needed"|"full"|"fast"|"by_index_#"|"fast_by_index_#" Format BD-RE, DVD-RAM, DVD-RW, DVD+RW. -volid volume_id Specifies the volume ID text. (32 chars out of [A-Z0-9_]) -publisher name Specifies the publisher name. (128 chars) -joliet "on"|"off" Generate Joliet info additional to Rock Ridge info. -bootimage "any"|"isolinux" "discard"|"keep"|"patch" Whether to discard or keep an exiting El-Torito boot image. -uid uid User id to be used for the whole multi-session ISO image. -gid gid Group id for the same purpose. -devices Show list of available optical drives and their addresses. -toc Show media specific table of content (sessions). -list_formats Show media specific list of format descriptors. -print_size Print the foreseeable consumption by next -commit. -tell_media_space Print foreseeable available space on output media Manipulation options: disk_path is a path to an object in the local filesystem tree. iso_rr_path is the Rock Ridge name of a file object in the ISO image. pathspec is either a disk_path or (if allowed) a pair: iso_rr_path=disk_path Options with variable length path list [...] need "--" as end mark if they are followed by another option. In dialog and with options read from files, the line end serves as such a mark. With program arguments this mark can be omitted only with the last option in the list of arguments. Options marked by [***] have variable argument length and perform pattern expansion if enabled by -iso_rr_pattern resp. -disk_pattern. -pathspecs "on"|"off" Allow or disallow pathspecs of form iso_rr_path=disk_path . Only "off" allows eventual -disk_pattern expansion. -add pathspec [...] | disk_path [***] Insert the given files or directory trees from filesystem into the ISO image. Much like mkisofs. -add_plainly "none"|"unknown"|"dashed"|"any" Whether to add lonely arguments as pathspec resp. disk_path. -path_list disk_path Like -add but read the pathspecs from file disk_path. -map disk_path iso_rr_path Insert disk file object at the given iso_rr_path. -map_single disk_path iso_rr_path Like -map but with directory do not insert its sub tree. -map_l disk_prefix iso_rr_prefix disk_path [***] Performs -map with each disk_path. -update disk_path iso_rr_path Compare both file objects and do what is necessary to make iso_rr_path a matching copy of disk_path. -update_r disk_path iso_rr_path Like -update but affecting all files below directories. -update_l disk_prefix iso_rr_prefix disk_path [***] Performs -update_r with each disk_path. -cut_out disk_path byte_offset byte_count iso_rr_path Map a byte interval of a regular disk file into a regular file in the ISO image. -cpr disk_path [***] iso_rr_path Insert the given files or directory trees from filesystem into the ISO image, according to the rules of cp -r. -rm iso_rr_path [***] Delete the given files from the ISO image. -rm_r iso_rr_path [***] Delete the given directory trees from ISO image. -mv iso_rr_path [***] iso_rr_path Rename the given file objects in the ISO tree to the last argument in the list. -chown uid iso_rr_path [***] Equivalent to chown in the ISO image. -chown_r uid iso_rr_path [***] Like -chown but affecting all files below directories. -chgrp gid iso_rr_path [***] Equivalent to chgrp in the ISO image. -chgrp_r gid iso_rr_path [***] Like -chgrp but affecting all files below directories. -chmod mode iso_rr_path [***] Equivalent to chmod in the ISO image. -chmod_r mode iso_rr_path [***] Like -chmod but affecting all files below directories. -alter_date type timestring iso_rr_path [***] Alter the date entries of a file in the ISO image. type is one of "a", "m", "b" for: access time, modification time, both times. -alter_date_r type timestring iso_rr_path [***] Like -alter_date but affecting all files below directories. -find iso_rr_path [test [test ...]] [-exec action [params]] performs an action on files below the current working directory in the ISO image. If -name pattern is given then only files with matching leaf names are processed. If -type is given then only files with matching type are processed. Types: block,char,dir,pipe,file,link,socket. Further tests: -damaged, -undamaged, -lba_range start count action may be one of: echo, chown, chown_r, chgrp, chgrp_r chmod, chmod_r, alter_date, alter_date_r, lsdl, compare, rm, rm_r, compare, update, report_damage, find. params are their arguments except iso_rr_path. echo, lsdl, rm, rm_r, report_damage have no params at all. -mkdir iso_rr_path [...] Create empty directories if they do not exist yet. -rmdir iso_rr_path [***] Delete empty directories. -- Mark end of particular action argument list. -not_paths disk_path [***] Add the given paths to the list of excluded absolute paths. -not_leaf pattern Add the given pattern to the list of leafname exclusions. -not_list disk_path Read lines from disk_path and use as -not_paths (with "/") or as -not_leaf (without "/"). -not_mgt "reset"|"on"|"off"|"param_on"|"subtree_on"|"ignore_on" Control effect of exclusion lists. -follow "on"|"pattern:param:link:mount:limit=#"|"default"|"off" Follow symbolic links and mount points within disk_path. -overwrite "on"|"nondir"|"off" Allow or disallow to overwrite existing files in ISO image. -split_size number["k"|"m"] Set the threshold for automatic splitting of regular files. -reassure "on"|"tree"|"off" If "on" then ask the user for "y" or "n" with any file before deleting or overwriting it in the ISO image. Write-to-media options: -rollback Discard the manipulated ISO image and reload it. -commit Perform the write operation and then perform -dev outdrive. Hint: To perform a final write operation with no new -dev and no new loading of image, execute option -end. -commit_eject "in"|"out"|"all"|"none" Like -commit but rather eject than load image from outdrive. Give up any unejected drive afterwards. -close "on"|"off" If "on" then mark the written media as not appendable. -padding number["k"|"m"] Append extra bytes to image stream. (Default is 300k) -dummy "on"|"off" If "on" simulate burning. Refuse if media cannot simulate. -speed number["k/s"|"m/s"|"[x]CD"|"[x]DVD"|"[x]BD"] Set the burn speed. Default is 0 = maximum speed. -stream_recording "on"|"off" Try to circumvent slow checkread on DVD-RAM and BD-RE. -fs number["k"|"m"] Set the size of the fifo buffer. (Default is 4m) -eject "in"|"out"|"all" Immediately eject the media in -indev, resp. -outdev, resp. both. Navigation options: -cd iso_rr_path Change working directory in the ISO image. iso_rr_paths which do not begin with '/' will be inserted beginning at the path given with -cd. -ls patterns will eventually looked up at this path. -cdi disk_path Same as -cd disk_path -cdx disk_path Change the current working directory in the local filesystem. disk_paths which do not begin with '/' will be looked up beginning at the path given with -cdx. -lsx patterns will eventually be looked up at this path. -pwd tells the current working directory in the ISO image. -pwdi same as -pwd. -pwdx tells the current working directory in the local filesystem. -iso_rr_pattern "on"|"ls"|"off" Enable or disable pattern expansions for ISO image commands marked by [***]. "ls" restricts it to -ls and -du. -disk_pattern "on"|"ls"|"off" Enable or disable pattern expansions for local filesystem commands marked by [***]. "ls" restricts to -ls*x and -du*x. -ls pattern [***] lists files of the ISO image which match one of the given shell parser patterns. (I.e. wildcards '*' '?'). Directories are listed by their content. -lsd pattern [***] like -ls but listing directories as single items. -lsl pattern [***] like -ls but also telling some file attributes. -lsdl pattern [***] like -lsd but also telling some file attributes. -lsx pattern [***] lists files of the local filesystem which match one of the patterns. Directories are listed by their content. -lsdx pattern [***] like -lsx but listing directories as single items. -lslx pattern [***] like -lsx but also telling some file attributes. -lsdlx pattern [***] like -lsdx but also telling some file attributes. -du pattern [***] recursively lists sizes of files or directories in the ISO image which match one of the shell parser patterns. -dux pattern [***] recursively lists sizes of files or directories in the local filesystem which match one of the shell parser patterns. -dus pattern [***] like -du but summing up subdirectories without listing them explicitely. -dusx pattern [***] like -dux but summing up subdirectories without listing them explicitely. -findx disk_path [-name pattern] [-type t] [-exec action [params]] Like -find but operating on local filesystem. Most -exec actions are defaulted to action is always echo. Supported actions are: in_iso, not_in_iso, is_full_in_iso, add_missing, empty_iso_dir. -compare disk_path iso_rr_path compare attributes and in case of regular data files the content of filesystem object and ISO object. -compare_r disk_path iso_rr_path Like -compare but affecting all files below directories. -compare_l disk_prefix iso_rr_prefix disk_path [***] Performs -compare_r with each disk_path. Restore options which copy file objects from ISO image to disk filesystem: -osirrox "on"|"device_files"|"off":"concat_split_on"|"concat_split_off" By default "off" the inverse operation of xorriso from ISO image to disk filesystem is disabled. "on" allows xorriso to create, overwrite, delete files in the disk filesystem. -extract iso_rr_path disk_path Copy tree under iso_rr_path onto disk address disk_path. This avoids the pitfalls of cp -r addressing rules. -extract_l iso_rr_prefix disk_prefix iso_rr_path [***] Perform -extract_r with each iso_rr_path. -extract_single iso_rr_path disk_path Like -extract but with directory do not restore sub tree. -cpx iso_rr_path [***] disk_path Copy leaf file objects from ISO image to disk filesystem. -cpax iso_rr_path [***] disk_path Like -cpx but trying to restore timestamps and ownership. -cp_rx iso_rr_path [***] disk_path Copy directory trees from ISO image to disk filesystem. -cp_rax iso_rr_path [***] disk_path Like -cp_rx but trying to restore timestamps and ownership. -paste_in iso_rr_path disk_path byte_offset byte_count Copy ISO file content into a byte interval of a disk file. Evaluation of readability: -check_media [options] -- Try to read data blocks from media and report about the outcome. Several options modify the behavior: use=indev|outdev , what=track|session , min_lba=blockadr , max_lba=blockadr , abort_file=path , time_limit=seconds , item_limit=number , retry=on|off|default , data_to=filepath , sector_map=filepath , map_with_volid=on|off Compatibility emulation (argument list may be ended by --): -as mkisofs [-help|-version|-o|-R|-J|-V|-P|-f|-m|-exclude-list|-no-pad| -M|-C|-graft-points|-path-list|pathspecs] Perform some mkisofs gestures, understand pathspecs as mkisofs does. Commit happens outside emulation at usual occasions. -as cdrecord [-help|-v|dev=|speed=|blank=|fs=|-eject|-atip|padsize=|path|-] Perform some cdrecord gestures, eventually write at most one data track to blank or overwriteable media. -pacifier "xorriso"|"cdrecord"|"mkisofs" Choose format of UPDATE pacifier during write operations. General options: -help Print this text -abort_on severity Set the threshhold for events to abort the program. Useful severities: NEVER, ABORT, FATAL, FAILURE, SORRY, WARNING -return_with severity exit_value Set the threshhold for events to return at program end the given exit_value even if not aborted. exit_value may be 0 or 32 to 63. -report_about severity Set the threshhold for events to be reported. Use -abort_on severities or: HINT, NOTE, UPDATE, DEBUG, ALL -dialog After all arguments are processed, enter dialog mode. In this mode you may enter searchtexts or any of the options described here. One per line. -dialog_reset Revoke -dialog (works only if given as argument) -page len width Prompt user after len output lines (0=no prompt). width (default 80) can adjust line number computation to the output terminal's line width. -use_stdin Use raw standard input even if libreadline is available -use_readline Use libreadline for dialog if available -history text Copy text into libreadline history. This command itself is not copied to the history list. -pkt_output "on"|"off" Direct output to stdout and prefix each line by a short header which tells channel id and a mode number. Each such output packet is finalized by a newline. Channel ids are 'R:' for result lines, 'I:' for notes and error messages, 'M:' for -mark texts. Bit 0 of the mode number tells whether the newline is also part of the packet payload. Example of a info message with newline: I:1: enter option text : -pkt_output:on is intended for use by frontend programs. -logfile channel fileaddress Copy output of a channel to the given file. channel may be 'R','I','M' as with -pkt_output or '.' for the consolidated -pkt_output stream. -mark text If text is not empty it will get put out each time an option is completed. -temp_mem_limit number["k"|"m"] Set the maximum size for pattern expansion. (Default is 16m) -prog text Use text as this program's name in subsequent messages -prog_help text Use text as this program's name and perform -help -status mode|filter Report the current settings of persistent options. Modes: short... print only important or altered options long ... print options even if they have default settings long_history like long plus -history: lines Filters begin with '-' and are compared literally against the output lines of -status long_history. A line is put out only if its start matches the filter. -status_history_max number Maximum number of history lines to be reported with -status:long_history -options_from_file fileaddress Reads lines from the given file and executes them as program options. -no_rc Only if used as first command line argument this option prevents reading and interpretation of startup files. -print text Print a text to result channel. -prompt text Wait for Enter key resp. for a line of input at stdin. -errfile_log mode path|channel Log disk paths of files involved in problem events. -session_log path Set path of a file where a log record gets appended after each session. Form: timestamp start_lba size volume-id # any text Is ignored. In dialog mode the input line will be stored in the eventual readline history, nevertheless. -version Tell program and version number -end End program. Commit eventual pending changes. -rollback_end End program. Discard pending changes. Option -page causes a user prompt after the given number of result lines. Empty input resumes output until the next prompt. Other input may be: @ suppresses paging until the current action is done @@ suppresses further result output but continues the action @@@ aborts the current action other aborts the current action and executes input as new option