xorriso

Purpose:

Hardware requirements:

Software requirements :

Linux with kernel 2.4 or higher (and libc, of course) :

With kernel 2.4 an ATA drive has to be under ide-scsi emulation.

With kernel 2.6 the drive should not be under ide-scsi.

libpthread

is supposed to be a standard system component.

libreadline and libreadline-dev

are optional and eventually make dialog more convenient.

GPL software included:

libburn-0.5.3

reads and writes data from and to CD, DVD, BD-RE.

(founded by Derek Foreman and Ben Jansens, furthered since August 2006 by Thomas Schmitt from team of libburnia-project.org)

libisofs-0.6.7

operates on ISO 9660 filesystem images.

(By Vreixo Formoso and Mario Danic from team of libburnia-project.org)

libisoburn-0.2.4

coordinates libburn and libisofs, emulates multi-session where needed.

(By Vreixo Formoso and Thomas Schmitt from team of libburnia-project.org)

This program system has been tested on Intel/AMD Linux systems only.
For ports to other usable systems contact us.

Special features:

• ISO 9660 formatter and burner for CD, DVD, BD-RE are fixely integrated.
• Operates on an existing ISO image or creates a new one.
• Copies files from filesystem into the ISO image.
• Changes file properties, renames or deletes file objects in the ISO image.
• Updates ISO subtrees incrementally to match given disk subtrees.
• Writes result as completely new image or as add-on session to optical media or filesystem objects.
• Can perform multi-session tasks as emulation of mkisofs and cdrecord.
• Can restore single files and whole trees from ISO image to disk filesystem.
• Can check media for damages and copy readable blocks to disk.
• Scans for optical drives, blanks re-useable optical media, formats media.
• Suitable for: CD-R, CD-RW, DVD-R, DVD-RW, DVD+R, DVD+R DL, DVD+RW, DVD-RAM, BD-RE.
• Reads its instructions from command line arguments, dialog, and batch files.
• Provides navigation commands for interactive ISO image manipulation.
• Adjustable thresholds for abort, exit value, and problem reporting.

Command Examples:

Get an overview of drives and their addresses

# xorriso -devices

Being superuser avoids permission problems with /dev/srN resp. /dev/hdX .

Ordinary users should then get granted rw access to the /dev files as listed by option -devices.

 

Options are either performed as program arguments or as dialog input. Some options have a parameter list of variable length. This list has to be terminated by word '--' or by the end of the input line. Option -add may accept pathspecs of form target=source as known from program mkisofs.

---

Get info about a particular drive and loaded media:

$ xorriso -indev /dev/sr0 -du / -- -toc 2>&1 | less

Make re-usable media writable again, delete any ISO 9660 image, eventually prepare yet unused BD-RE:

$ xorriso -outdev /dev/sr0 -blank as_needed -eject all

---

Write some directories into a new or existing ISO 9660 image:

$ xorriso -dev /dev/sr0 -add /home/me/sounds /home/me/pictures

Check the result:

$ xorriso -indev /dev/sr0 -du / -- -toc 2>&1 | less

---

Create new ISO-9660 filesystem image, compose content, adjust permissions to make it publicly read-only, write it to media and immediately eject media without previously reloading the written image.

$ cd /home/me

$ xorriso -outdev /dev/sr0 -blank as_needed \

  -map /home/me/sounds /sounds \

  -map /home/me/pictures /pictures \

  -rm_r /sounds/indecent '/pictures/*private*' -- \

  -cd / \

  -add pictures/private/horses* -- \

  -chmod_r a+r,a-w / -- \

  -find / -type d -exec chmod a+x -- \

  -volid SOUNDS_PICS_2008_01_16 \

  -commit_eject all

---

Load the previous session from media, remove (i.e. hide) directory /sounds, rename /pictures/private/horses, add new directory trees /sounds and /movies, disallow any access for group and others. Finally write as additional session to media and eject:

$ xorriso -dev /dev/sr0 \

  -rm_r /sounds -- \

  -mv /pictures/private/horses /horse_show -- \

  -map /home/me/prepared_for_dvd/sounds_dummy /sounds \

  -map /home/me/prepared_for_dvd/movies /movies \

  -chmod_r go-rwx / -- \

  -volid SOUNDS_PICS_2008_01_17 \

  -commit_eject all

---

Merge the various sessions from old readable media into a single session on new writeable media, cleaning out all invalidated files and session overhead. Touch / in order to mark the image as worth to be written.
Important: -indev and -outdev have to be different drives.

$ xorriso -indev /dev/dvd \

  -alter_date a +0 / -- \

  -outdev /dev/sr0 -blank fast \

  -commit_eject all

---

Dialog mode accepts one or more options per line. An option and all its arguments have to be given in one single line. Command -end stops the program run. It will write eventually pending changes to media, if that has not already been done by a previous -commit.

$ xorriso -dialog on

enter option and arguments :

-dev /dev/sr0

enter option and arguments :

-map /home/me/prepared_for_dvd/sounds_dummy /sounds

enter option and arguments :

-map /home/me/prepared_for_dvd/movies /movies

Available navigation commands: -cd, -ls, -du, -find

enter option and arguments :

-commit

... perform further commands and finally do:

enter option and arguments :

-end

---

The following command can be run on blank media to create a copy of the mentioned disk directory trees, and it can be run on appendable media to perform a minimal set of change operations which update the old ISO copies to match the new disk trees. Older states can be retrieved by help of mount option "session=" from CD-R[W], by help of "sbsector=" from other media. So this constitutes true incremental backup.
The copies will be complete, except all file names ending with ".o" or ".swp" which are excluded by options -not_leaf.

$ xorriso -dev /dev/sr0 \

   -volid PROJECTS_MAIL_"$(date '+%Y_%m_%d_%H%M%S')" \

   -not_leaf '*.o' -not_leaf '*.swp' \

   -update_r /home/thomas/open_source_projects /open_source_projects \

   -update_r /home/thomas/personal_mail /personal_mail \

   -commit -toc -eject all

---

In batch mode it is possible to operate xorriso in a pipeline with an external consumer of the generated ISO image. Any message output will be redirected to stderr in this case.

$ xorriso -outdev - ...other.options... | consumer

---

Let xorriso serve underneath growisofs via its alias name "xorrisofs" which enables mkisofs emulation:

$ export MKISOFS="xorrisofs"

$ growisofs -Z /dev/dvd /some/files

$ growisofs -M /dev/dvd /more/files

One may switch from mkisofs emulation to xorriso's own command mode:

$ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files

---

Enable reverse operation of xorriso and copy some files and a tree to disk:

$ xorriso -indev /dev/sr0 \

   -osirrox on \

   -cpx /pictures/private/horses*/*buttercup* \

       /home/her/buttercup_dir -- \

   -extract /sounds /home/her/sounds_from_me

---

Get overview of the options:

$ xorriso -help

Read the detailed manual page:

$ man xorriso

Download as source code (see README):

xorriso-0.2.4.pl00.tar.gz (1040 KB).

Documentation:

README about installation and drive setup

xorriso -help gives an overview of options

man xorriso is the manual page

Contact:

Thomas Schmitt, scdbackup@gmx.net

libburn development mailing list, libburn-hackers@pykix.org

License:

GPL version 2, an Open Source approved license

 

Bug fixes towards xorriso-0.2.2.pl01:

• - none -

Enhancements towards previous stable version xorriso-0.2.2.pl01:

• Included libburn has enhanced Linux drive access and listing code
• New option -check_media
• New -find test -damaged, new -find actions "report_damage", "report_lba"
• New -error_behavior occasion "file_extraction"

Development snapshot, version 0.2.5 :

Bug fixes towards xorriso-0.2.4.pl00:

• - none yet -

Enhancements towards stable version 0.2.4.pl00:

• Capability to insert and extract files far larger than 4 GB
• New option -file_size_limit, -as mkisofs now supports -iso-level 1 to 3
• New option -extract_cut to retrieve data from oversized files
• New option -check_media_defaults
• New option -list_delimiter

 

README 0.2.5

xorriso_0.2.5 -help

man xorriso (as of 0.2.5)

 

If you want to distribute development versions of xorriso, then use this tarball which produces static linking between xorriso and the libburnia libraries.

Source (./bootstrap is already applied, build tested, installation see README)

xorriso-0.2.5.tar.gz (1050 KB).

A dynamically linked development version of xorriso can be obtained from repositories of libburnia-project.org. xorriso is part of libisoburn/trunk and will get built by its "make".

Be warned that the libraries in SVN and bzr are development versions with possibly unstable API/ABI enhancements. Do not distribute development versions for dynamic linking. Only release versions are safe for that.

Download: svn co http://svn.libburnia-project.org/libburn/trunk libburn

Install: cd libburn ; ./bootstrap ; ./configure --prefix /usr ; make ; make install

Download: bzr branch lp:libisofs

Install: cd libisofs ; ./bootstrap ; ./configure --prefix /usr ; make ; make install

Download: svn co http://svn.libburnia-project.org/libisoburn/trunk libisoburn

Install: cd libisoburn ; ./bootstrap ; ./configure --prefix /usr ; make ; make install

Build of SVN versions needs autotools of at least version 1.7 installed. But after the run of ./bootstrap, only vanilla tools like make and gcc are needed.

 

Many thanks to Derek Foreman and Ben Jansens for starting libburn.
Very special thanks to Andy Polyakov whose dvd+rw-tools provide the libburnia project with invaluable examples on how to deal with DVD media and how to emulate multi-session on overwriteable media.

Enjoying free Open Source hosting by www.webframe.org

and by sourceforge.net