"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "README" between
xorriso-1.5.2.tar.gz and xorriso-1.5.4.tar.gz

About: GNU xorriso creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions. It is suitable for incremental data backup and for production of bootable ISO 9660 images. GNU xorriso is a statical compilation of the libraries libburn, libisofs, libisoburn, and libjte.

README  (xorriso-1.5.2):README  (xorriso-1.5.4)
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
Contribution of libburnia-project.org to the GNU Operating System Contribution of libburnia-project.org to the GNU Operating System
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
GNU xorriso. By Thomas Schmitt <scdbackup@gmx.net> GNU xorriso. By Thomas Schmitt <scdbackup@gmx.net>
Derived from and supported by libburnia-project.org, published via: Derived from and supported by libburnia-project.org, published via:
http://www.gnu.org/software/xorriso/xorriso_eng.html http://www.gnu.org/software/xorriso/xorriso_eng.html
http://www.gnu.org/software/xorriso/xorriso-1.5.2.tar.gz http://www.gnu.org/software/xorriso/xorriso-1.5.4.tar.gz
Provided under GPL version 3 or later. No warranty. Provided under GPL version 3 or later. No warranty.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
xorriso is a program which copies file objects from POSIX compliant xorriso is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows
session-wise manipulation of such filesystems. It can load the management session-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
Vice versa xorriso is able to restore file objects from ISO 9660 filesystems. Vice versa xorriso is able to restore file objects from ISO 9660 filesystems.
skipping to change at line 50 skipping to change at line 50
plus on Solaris: libvolmgt plus on Solaris: libvolmgt
plus on FreeBSD: libiconv, libcam, IDE and SATA drives need atapicam plus on FreeBSD: libiconv, libcam, IDE and SATA drives need atapicam
Optional at compile time are: Optional at compile time are:
libreadline and the readline-dev headers, or libedit and its header, libreadline and the readline-dev headers, or libedit and its header,
make dialog mode more convenient. make dialog mode more convenient.
zlib and zlib-devel allow zisofs compression. zlib and zlib-devel allow zisofs compression.
on GNU/Linux: libacl and libacl-devel allow getting and setting ACLs. on GNU/Linux: libacl and libacl-devel allow getting and setting ACLs.
If they were present at compile time, then the optional libraries have to If they were present at compile time, then the optional libraries have to
be present at runtime, too. be present at runtime, too.
Obtain xorriso-1.5.2.tar.gz, take it to a directory of your choice and do: Obtain xorriso-1.5.4.tar.gz, take it to a directory of your choice and do:
tar xzf xorriso-1.5.2.tar.gz tar xzf xorriso-1.5.4.tar.gz
cd xorriso-1.5.2 cd xorriso-1.5.4
Within that directory execute: Within that directory execute:
./configure --prefix=/usr ./configure --prefix=/usr
make make
This will produce a binary named This will produce a binary named
./xorriso/xorriso ./xorriso/xorriso
If you want xorriso to report a "Build timestamp" with its option -version : If you want xorriso to report a "Build timestamp" with its option -version :
skipping to change at line 99 skipping to change at line 99
xorrecord starts xorriso with -as cdrecord emulation already enabled xorrecord starts xorriso with -as cdrecord emulation already enabled
osirrox starts with -osirrox image-to-disk copying already enabled osirrox starts with -osirrox image-to-disk copying already enabled
By default xorriso will depend on libreadline if the library and its By default xorriso will depend on libreadline if the library and its
development header files are present at compile time. If not, then it will development header files are present at compile time. If not, then it will
try to depend on libedit and its header file. try to depend on libedit and its header file.
Both conditional dependencies can be avoided by running Both conditional dependencies can be avoided by running
./configure --prefix=/usr --disable-libreadline ./configure --prefix=/usr --disable-libreadline
make clean ; make make clean ; make
Never omit the "make clean" command after switching enabling of libreadline. Never omit the "make clean" command after switching enabling of libreadline.
If you want to explictely allow only the use of libedit, then do If you want to explicitly allow only the use of libedit, then do
./configure --prefix=/usr --disable-libreadline --enable-libedit ./configure --prefix=/usr --disable-libreadline --enable-libedit
Other deliberate dependency reduction options of ./configure are: Other deliberate dependency reduction options of ./configure are:
--disable-libacl avoid use of ACL functions like acl_to_text() --disable-libacl avoid use of ACL functions like acl_to_text()
--disable-xattr avoid use of xattr functions like listxattr() on Linux --disable-xattr avoid use of xattr functions like listxattr() on Linux
or extattr_list_file() on FreeBSD or extattr_list_file() on FreeBSD
--disable-zlib avoid use of zlib functions like compress2() --disable-zlib avoid use of zlib functions like compress2()
this also avoids the use of libjte and option -jigdo. this also avoids the use of libjte and option -jigdo.
xorriso brings own system adapters which allow burning optical media on xorriso brings own system adapters which allow burning optical media on
skipping to change at line 258 skipping to change at line 258
Besides true optical drives, xorriso can also address disk files as input or Besides true optical drives, xorriso can also address disk files as input or
output drives. By default paths to files under /dev are accepted only if the output drives. By default paths to files under /dev are accepted only if the
device represents a real optical drive. Other device files may be addressed device represents a real optical drive. Other device files may be addressed
by prepending "stdio:" to the path. by prepending "stdio:" to the path.
Like: Like:
xorriso -dev stdio:/dev/sdb ...more arguments... xorriso -dev stdio:/dev/sdb ...more arguments...
This rule may be changed by xorriso option -drive_class. This rule may be changed by xorriso option -drive_class.
Prefix "mmc:" causes a path to be accepted only if it is a real optical drive Prefix "mmc:" causes a path to be accepted only if it is a real optical drive
which is accessible by generic SCSI/MMC commands. which is accessible by generic SCSI/MMC commands.
xorriso-dd-target
GNU xorriso comes with a script named
xorriso-dd-target/xorriso-dd-target
which uses the util-linux program lsblk to find suitable hard-disk-like
target devices for copying hard-disk bootable ISO images onto them. Such images
are offered by GNU/Linux distributions for installing their system.
xorriso-dd-target gets installed only if ./configure detects to run on a
GNU/Linux system. It refuses to start on non-Linux kernels or if program lsblk
is not found in /usr/sbin, /sbin, /usr/bin, /bin.
For introduction, examples, and details see in the build directory
man xorriso-dd-target/xorriso-dd-target.1
info xorriso-dd-target/xorriso-dd-target.info
Testing Testing
For automated and manual tests of xorriso's functionality see file For automated and manual tests of xorriso's functionality see file
releng/README releng/README
Result comparison with self produced ISO images Result comparison with self produced ISO images
We are quite sure that libisofs produces accurate representations of the disk We are quite sure that libisofs produces accurate representations of the disk
files. This opinion is founded on a lot of test burns and checks by a little files. This opinion is founded on a lot of test burns and checks by a little
test program which compares files from the mounted image with the orignals test program which compares files from the mounted image with the orignals
skipping to change at line 335 skipping to change at line 351
Parameters md5= and self= are 32 digit hex, the others are decimal numbers. Parameters md5= and self= are 32 digit hex, the others are decimal numbers.
Tag_id distinguishes the following tag types Tag_id distinguishes the following tag types
"libisofs_rlsb32_checksum_tag_v1" Relocated 64 kB superblock tag "libisofs_rlsb32_checksum_tag_v1" Relocated 64 kB superblock tag
"libisofs_sb_checksum_tag_v1" Superblock tag "libisofs_sb_checksum_tag_v1" Superblock tag
"libisofs_tree_checksum_tag_v1" Directory tree tag "libisofs_tree_checksum_tag_v1" Directory tree tag
"libisofs_checksum_tag_v1" Session end tag "libisofs_checksum_tag_v1" Session end tag
A relocated superblock may appear at LBA 0 of an image which was produced for A relocated superblock may appear at LBA 0 of an image which was produced for
being stored in a disk file or on overwriteable media (e.g. DVD+RW, BD-RE). being stored in a disk file or on overwritable media (e.g. DVD+RW, BD-RE).
xorriso records the first session at LBA 32. A follow-up session xorriso records the first session at LBA 32. A follow-up session
begins at the next block address which is divisible by 32 and higher than the begins at the next block address which is divisible by 32 and higher than the
address of the previous session's end tag. Normally no session starts after the address of the previous session's end tag. Normally no session starts after the
address given by relocated superblock parameter session_start=. address given by relocated superblock parameter session_start=.
Session oriented media like CD-R[W], DVD-R, DVD+R, BD-R will have no relocated Session oriented media like CD-R[W], DVD-R, DVD+R, BD-R will have no relocated
superblock but rather bear a table-of-content on media level. superblock but rather bear a table-of-content on media level.
A tag is valid if pos= tells its own block address and self= tells its own MD5 A tag is valid if pos= tells its own block address and self= tells its own MD5
up to the last hex digit of md5=. range_start= tells the first block that is up to the last hex digit of md5=. range_start= tells the first block that is
covered by md5=, range_size= tells the number of blocks covered by md5=. covered by md5=, range_size= tells the number of blocks covered by md5=.
skipping to change at line 358 skipping to change at line 374
The newline character at the end is mandatory. The newline character at the end is mandatory.
libisoburn libisoburn
xorriso is based on libisofs which does ISO 9660 filesystem aspects and on xorriso is based on libisofs which does ISO 9660 filesystem aspects and on
libburn which does the input and output aspects. Parts of this foundation libburn which does the input and output aspects. Parts of this foundation
are accessed via libisoburn, which is closely related to xorriso. are accessed via libisoburn, which is closely related to xorriso.
libisoburn provides several services: libisoburn provides several services:
- Encapsulation of coordination between libisofs and libburn. - Encapsulation of coordination between libisofs and libburn.
- Emulation of ISO 9660 multi-session on overwriteable media - Emulation of ISO 9660 multi-session on overwritable media
or random access files. or random access files.
- Implementation of the xorriso API. - Implementation of the xorriso API.
The sourcecode of all three libraries is included in the GNU xorriso tarball. The sourcecode of all three libraries is included in the GNU xorriso tarball.
It is compiled with xorriso and linked statically. It is compiled with xorriso and linked statically.
But you may as well get and install releases of libburn and libisofs, in order But you may as well get and install releases of libburn and libisofs, in order
to be able to install a release of libisoburn which produces libisoburn.so.1 to be able to install a release of libisoburn which produces libisoburn.so.1
and a matching dynamically linked xorriso binary. and a matching dynamically linked xorriso binary.
This binary is very lean but depends on properly installed libraries of This binary is very lean but depends on properly installed libraries of
suitable revision. suitable revision.
Dynamic library and compile time header requirements for libisoburn-1.5.2 : Dynamic library and compile time header requirements for libisoburn-1.5.4 :
- libburn.so.4 , version libburn-1.5.2 or higher - libburn.so.4 , version libburn-1.5.4 or higher
- libisofs.so.6 , version libisofs-1.5.2 or higher - libisofs.so.6 , version libisofs-1.5.4 or higher
libisoburn and xorriso will not start with libraries which are older than their libisoburn and xorriso will not start with libraries which are older than their
libisofs.so.6 , version <span class="insert">libisofs-1.5.4</span> or higher
headers seen at compile time. So compile in the oldest possible installation headers seen at compile time. So compile in the oldest possible installation
setup unless you have reason to enforce a newer bug fix level. setup unless you have reason to enforce a newer bug fix level.
GNU xorriso has less runtime dependencies and can be moved more freely. GNU xorriso has less runtime dependencies and can be moved more freely.
System Dependent Drive Permission Examples System Dependent Drive Permission Examples
Accessing the optical drives requires privileges which usually are granted Accessing the optical drives requires privileges which usually are granted
only to the superuser. GNU/Linux, FreeBSD, Solaris, and NetBSD offer quite only to the superuser. GNU/Linux, FreeBSD, Solaris, and NetBSD offer quite
skipping to change at line 495 skipping to change at line 511
way as for its own software releases. It is further committed to keep its way as for its own software releases. It is further committed to keep its
own licenses open for obtaining future copies under GPLv2+. own licenses open for obtaining future copies under GPLv2+.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
libburnia program xorriso is based on and sub project of: libburnia program xorriso is based on and sub project of:
libburnia-project.org libburnia-project.org
By Mario Danic <mario.danic@gmail.com>, libburn, libisofs By Mario Danic <mario.danic@gmail.com>, libburn, libisofs
Vreixo Formoso <metalpain2002@yahoo.es>, libisofs, libisoburn Vreixo Formoso <metalpain2002@yahoo.es>, libisofs, libisoburn
Thomas Schmitt <scdbackup@gmx.net>, libburn, libisofs, Thomas Schmitt <scdbackup@gmx.net>, libburn, libisofs,
libisoburn, xorriso libisoburn, xorriso
Copyright (C) 2006-2019 Mario Danic, Vreixo Formoso, Thomas Schmitt. Copyright (C) 2006-2021 Mario Danic, Vreixo Formoso, Thomas Schmitt.
libburnia-project.org is inspired by and in libburn still containing parts libburnia-project.org is inspired by and in libburn still containing parts
of old of old
Libburn. By Derek Foreman <derek@signalmarketing.com> and Libburn. By Derek Foreman <derek@signalmarketing.com> and
Ben Jansens <xor@orodu.net> Ben Jansens <xor@orodu.net>
Copyright (C) 2002-2006 Derek Foreman and Ben Jansens Copyright (C) 2002-2006 Derek Foreman and Ben Jansens
GNU xorriso contains libjte out of source package jigit >= 1.17 GNU xorriso contains libjte out of source package jigit >= 1.17
Copyright (C) 2000-2007 Free Software Foundation, Inc. Copyright (C) 2000-2007 Free Software Foundation, Inc.
2004-2011 Steve McIntyre 2004-2011 Steve McIntyre
2010-2011 George Danchev, Thomas Schmitt 2010-2011 George Danchev, Thomas Schmitt
GNU xorriso contains xorriso-dd-target
Copyright (C) 2019-2021 Nio Wiklund alias sudodus, Thomas Schmitt
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
This text itself is This text itself is
Copyright (c) 2007 - 2019 Thomas Schmitt <scdbackup@gmx.net> Copyright (c) 2007 - 2021 Thomas Schmitt <scdbackup@gmx.net>
and is freely distributable. and is freely distributable.
It shall only be modified in sync with the technical properties of xorriso. It shall only be modified in sync with the technical properties of xorriso.
If you make use of the license to derive modified versions of xorriso If you make use of the license to derive modified versions of xorriso
then you are entitled to modify this text under that same license. then you are entitled to modify this text under that same license.
 End of changes. 12 change blocks. 
13 lines changed or deleted 31 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)