"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "xorriso/xorrecord.texi" between
libisoburn-1.5.0.tar.gz and libisoburn-1.5.2.tar.gz

About: libisoburn is a frontend for the libraries libburn and libisofs which enables creation and expansion of ISO-9660 filesystems on all media and file types supported by libburn. It implements the API and command interpreter of program xorriso, and installs this program as small dynamically linked binary. xorriso is suitable for incremental data backup and for production of bootable ISO 9660 images. A statically linked version is available as GNU xorriso.

xorrecord.texi  (libisoburn-1.5.0):xorrecord.texi  (libisoburn-1.5.2)
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c %**start of header @c %**start of header
@setfilename xorrecord.info @setfilename xorrecord.info
@settitle GNU xorrecord 1.5.0 @settitle GNU xorrecord 1.5.2
@c %**end of header @c %**end of header
@c @c
@c man-ignore-lines begin @c man-ignore-lines begin
@dircategory Archiving @dircategory Archiving
@direntry @direntry
* Xorrecord: (xorrecord). Emulates CD/DVD/BD program cdrecord * Xorrecord: (xorrecord). Emulates CD/DVD/BD program cdrecord
@end direntry @end direntry
@c man-ignore-lines end @c man-ignore-lines end
@c @c
@c Notes about embedded man page: @c Notes about embedded man page:
skipping to change at line 53 skipping to change at line 53
@c man .\" @c man .\"
@c man .\" IMPORTANT NOTE: @c man .\" IMPORTANT NOTE:
@c man .\" @c man .\"
@c man .\" The original of this file is kept in xorriso/xorrecord.texi @c man .\" The original of this file is kept in xorriso/xorrecord.texi
@c man .\" This here was generated by program xorriso/make_xorriso_1 @c man .\" This here was generated by program xorriso/make_xorriso_1
@c man .\" @c man .\"
@c man .\" @c man .\"
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1) @c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRECORD 1 "Version 1.5.0, Sep 15, 2018" @c man .TH XORRECORD 1 "Version 1.5.2, Oct 26, 2019"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@c man .\" .nh disable hyphenation @c man .\" .nh disable hyphenation
@c man .\" .hy enable hyphenation @c man .\" .hy enable hyphenation
@c man .\" .ad l left justify @c man .\" .ad l left justify
@c man .\" .ad b justify to both left and right margins @c man .\" .ad b justify to both left and right margins
@c man .\" .nf disable filling @c man .\" .nf disable filling
@c man .\" .fi enable filling @c man .\" .fi enable filling
@c man .\" .br insert line break @c man .\" .br insert line break
@c man .\" .sp <n> insert n+1 empty lines @c man .\" .sp <n> insert n+1 empty lines
@c man .\" for manpage-specific macros, see man(7) @c man .\" for manpage-specific macros, see man(7)
@c man .nh @c man .nh
@c man-ignore-lines begin @c man-ignore-lines begin
@copying @copying
xorrecord - Emulation of CD/DVD/BD program cdrecord by program xorriso xorrecord - Emulation of CD/DVD/BD program cdrecord by program xorriso
Copyright @copyright{} 2011 - 2018 Thomas Schmitt Copyright @copyright{} 2011 - 2019 Thomas Schmitt
@quotation @quotation
Permission is granted to distrubute this text freely. Permission is granted to distribute this text freely.
@end quotation @end quotation
@end copying @end copying
@c man-ignore-lines end @c man-ignore-lines end
@titlepage @titlepage
@title Manual of GNU xorriso personality xorrecord 1.5.0 @title Manual of GNU xorriso personality xorrecord 1.5.2
@author Thomas Schmitt @author Thomas Schmitt
@page @page
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
@insertcopying @insertcopying
@end titlepage @end titlepage
@contents @contents
@ifnottex @ifnottex
@node Top @node Top
@top xorrecord 1.5.0 @top xorrecord 1.5.2
@c man-ignore-lines 1 @c man-ignore-lines 1
@c man .SH NAME @c man .SH NAME
xorrecord - Emulation of CD/DVD/BD program cdrecord by program xorriso xorrecord - Emulation of CD/DVD/BD program cdrecord by program xorriso
@end ifnottex @end ifnottex
@menu @menu
* Overview:: Overview * Overview:: Overview
* Standards:: MMC, Session, Track, Media types * Standards:: MMC, Session, Track, Media types
* Drive:: Drive preparation and addressing * Drive:: Drive preparation and addressing
* Xorriso:: Relation to program xorriso * Xorriso:: Relation to program xorriso
skipping to change at line 710 skipping to change at line 710
be enabled by repeated -v or by -vv or by -vvv. be enabled by repeated -v or by -vv or by -vvv.
@c man .TP @c man .TP
@item -V @item -V
@kindex -V log SCSI command transactions to stderr @kindex -V log SCSI command transactions to stderr
@cindex Verbosity, SCSI commands, -V @cindex Verbosity, SCSI commands, -V
@cindex SCSI commands, log, -V @cindex SCSI commands, log, -V
Log SCSI commands and drive replies to standard error. Log SCSI commands and drive replies to standard error.
This might be of interest if @strong{xorrecord} and a particular drive This might be of interest if @strong{xorrecord} and a particular drive
or medium do not cooperate as expected, or if you just want to know or medium do not cooperate as expected, or if you just want to know
how libburn interacts with the drive. how libburn interacts with the drive.
To understand this extremely verbous log, one needs to read SCSI To understand this extremely verbose log, one needs to read SCSI
specs SPC, SBC, and MMC. specs SPC, SBC, and MMC.
@* @*
Please do not add such a log to a bug report on the first hand, Please do not add such a log to a bug report on the first hand,
unless you want to point out a particular deviation unless you want to point out a particular deviation
from said specs, or if you get asked for this log by a maintainer of from said specs, or if you get asked for this log by a maintainer of
@command{xorrecord} who feels in charge for your bug report. @command{xorrecord} who feels in charge for your bug report.
@c man .TP @c man .TP
@item -help @item -help
@kindex -help print sparse overview of options @kindex -help print sparse overview of options
@cindex Options, overview, -help @cindex Options, overview, -help
skipping to change at line 739 skipping to change at line 739
@section Options not compatible to cdrecord @section Options not compatible to cdrecord
@table @asis @table @asis
@sp 1 @sp 1
@c man .TP @c man .TP
@item @minus{}@minus{}no_rc @item @minus{}@minus{}no_rc
@kindex @minus{}@minus{}no_rc do not execute xorriso startup files @kindex @minus{}@minus{}no_rc do not execute xorriso startup files
@cindex Startup files, do not execute, @minus{}@minus{}no_rc @cindex Startup files, do not execute, @minus{}@minus{}no_rc
Only if used as first command line argument this option Only if used as first command line argument this option
prevents reading and interpretation of startup files. See section FILES below. prevents reading and interpretation of startup files. See section FILES below.
@c man .TP @c man .TP
@item @minus{}@minus{}drive_not_exclusive
@kindex @minus{}@minus{}drive_not_exclusive use drive even if busy
@cindex Drive, use even if busy, @minus{}@minus{}drive_not_exclusive
This option disables the use of device file locking mechanisms when acquiring
the drive. On GNU/Linux the locking is done by open(O_EXCL), on FreeBSD by
flock(LOCK_EX).
@*
Be aware that it can cause problems if you use a drive which is mounted,
or opened by some other process, or guarded by /dev/pktcdvd*.
Make sure that other users of the drive do not cause drive activities
while a xorrecord burn run is going on.
@c man .TP
@item drive_scsi_dev_family=sr|scd|sg|default @item drive_scsi_dev_family=sr|scd|sg|default
@kindex drive_scsi_dev_family= Linux device type to be used @kindex drive_scsi_dev_family= Linux device type to be used
@cindex Drive, Linux device type, drive_scsi_dev_family @cindex Drive, Linux device type, drive_scsi_dev_family
GNU/Linux specific: GNU/Linux specific:
@* @*
By default, cdrskin tries to map Linux drive addresses to /dev/sr* before By default, cdrskin tries to map Linux drive addresses to /dev/sr* before
they get opened for operating the drive. This coordinates well with they get opened for operating the drive. This coordinates well with
other use cases of optical drives, like mount(8). But since year 2010 other use cases of optical drives, like mount(8). But since year 2010
all /dev/sr* share a global lock which allows only one drive to process all /dev/sr* share a global lock which allows only one drive to process
an SCSI command while all others have to wait for its completion. an SCSI command while all others have to wait for its completion.
skipping to change at line 1001 skipping to change at line 1013
@* @*
-multi --grow_overwriteable_iso \ -multi --grow_overwriteable_iso \
@* @*
blank=as_needed -eject padsize=300k image_1.iso blank=as_needed -eject padsize=300k image_1.iso
@* @*
@sp 1 @sp 1
For the second session xorrisofs needs to know the -msinfo numbers For the second session xorrisofs needs to know the -msinfo numbers
of the medium. Further it will read data from the medium by using the of the medium. Further it will read data from the medium by using the
system's read-only CD-ROM driver. system's read-only CD-ROM driver.
@* @*
It is advised to load the tray manually Many systems do not take notice of xorrecord's write activities. It is
or via dd by the CD-ROM driver, rather than letting xorrecord do this necessary to force their attention by ejecting and reloading the drive tray.
by its own SCSI driver. Many system CD-ROM drivers do not take notice Therefore above run uses option -eject.
of xorrecord's activities.
@*
@sp 1
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
@* @*
Now get the -msinfo numbers: Get the -msinfo numbers (and properly reload the tray if it has a motor) by:
@* @*
$ m=$(xorrecord dev=/dev/sr0 -msinfo) $ m=$(xorrecord dev=/dev/sr0 -msinfo)
@* @*
@sp 1 @sp 1
and use them with xorrisofs to add ./tree2 to the image as /dir2: Offer a victim to any problem caused by obtrusive demons after tray loading:
@*
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
@*
@sp 1
Use the numbers with xorrisofs to add ./tree2 to the image as /dir2:
@* @*
@sp 1 @sp 1
$ xorrisofs -M /dev/sr0 -C $m -o image_2.iso \ $ xorrisofs -M /dev/sr0 -C $m -o image_2.iso \
@* @*
-J -graft-points /dir2=./tree2 -J -graft-points /dir2=./tree2
@* @*
@sp 1 @sp 1
Now burn the new session onto the same medium. This time without blanking: Now burn the new session onto the same medium. This time without blanking:
@* @*
@sp 1 @sp 1
skipping to change at line 1039 skipping to change at line 1052
-eject padsize=300k image_2.iso -eject padsize=300k image_2.iso
@* @*
@sp 1 @sp 1
Operating systems which mount this medium will read the superblock Operating systems which mount this medium will read the superblock
of the second session and show both directories /dir1 and /dir2. of the second session and show both directories /dir1 and /dir2.
@c man .SS @c man .SS
@c man .B Write ISO 9660 session on-the-fly: @c man .B Write ISO 9660 session on-the-fly:
@node ExIsoFly, ExAfio, ExIsoMulti, Examples @node ExIsoFly, ExAfio, ExIsoMulti, Examples
@section Write ISO 9660 session on-the-fly @section Write ISO 9660 session on-the-fly
It is possible to combine the run of @strong{xorrisofs} and @command{xorrecord} It is possible to combine the run of @strong{xorrisofs} and @command{xorrecord}
in a pipeline without storing the ISO 9660 image as file on hard disk: in a pipeline without storing the ISO 9660 image as file on hard disk.
@*
The piped run is more vulnerable to the problem that some systems have not
enough patience with automatic tray loading and that demons may interfere
with a first CD-ROM driver read attempt from a freshly loaded medium.
It is advised to load the tray manually or via a separate run of xorriso with
a subsequent run of dd.
@*
Again, xorriso has the patience and dd is a dispensable victim for demons.
@*
@sp 1
$ m=$(xorrecord dev=/dev/sr0 -msinfo)
@*
@sp 1
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
@* @*
@sp 1 @sp 1
$ xorrisofs -M /dev/sr0 -C $m \ $ xorrisofs -M /dev/sr0 -C $m \
@* @*
-J -graft-points /dir2=./tree2 \ -J -graft-points /dir2=./tree2 \
@* @*
| xorrecord -v dev=/dev/sr0 speed=12 fs=8m \ | xorrecord -v dev=/dev/sr0 speed=12 fs=8m \
@* @*
-waiti -multi --grow_overwriteable_iso \ -waiti -multi --grow_overwriteable_iso \
@* @*
-eject padsize=300k - -eject padsize=300k -
@* @*
@sp 1 @sp 1
This is also the main use case of program @strong{xorriso} itself, This is also the main use case of program @strong{xorriso} itself,
where this run would look like: where the run would need no system workarounds and simply look like:
@* @*
@sp 1 @sp 1
$ xorriso -dev /dev/sr0 -joliet on -speed 12 -fs 8m \ $ xorriso -dev /dev/sr0 -joliet on -speed 12 -fs 8m \
@* @*
-map ./tree2 /dir2 -commit_eject all -map ./tree2 /dir2 -commit_eject all
@c man .SS @c man .SS
@c man .B Write compressed afio archive on-the-fly: @c man .B Write compressed afio archive on-the-fly:
@node ExAfio, , ExIsoFly, Examples @node ExAfio, , ExIsoFly, Examples
@section Write compressed afio archive on-the-fly @section Write compressed afio archive on-the-fly
This is possible with all media except minimally blanked DVD-RW and DVD-R DL. This is possible with all media except minimally blanked DVD-RW and DVD-R DL.
skipping to change at line 1173 skipping to change at line 1200
Expect to get asked more questions before solutions can be proposed. Expect to get asked more questions before solutions can be proposed.
@c man .SH AUTHOR @c man .SH AUTHOR
@node Legal, CommandIdx, Bugreport, Top @node Legal, CommandIdx, Bugreport, Top
@chapter Author, Copyright, Credits @chapter Author, Copyright, Credits
@section Author @section Author
Thomas Schmitt <scdbackup@@gmx.net> Thomas Schmitt <scdbackup@@gmx.net>
@* @*
for libburnia-project.org for libburnia-project.org
@c man .SH COPYRIGHT @c man .SH COPYRIGHT
@section Copyright @section Copyright
Copyright (c) 2011 - 2018 Thomas Schmitt Copyright (c) 2011 - 2019 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of xorriso. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of xorriso then you are entitled
to modify this text under that same license. to modify this text under that same license.
@c man .SH CREDITS @c man .SH CREDITS
@section Credits @section Credits
@command{xorriso} is in part based on work by Vreixo Formoso who provides @command{xorriso} is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team. libisofs together with Mario Danic who also leads the libburnia team.
Thanks to Andy Polyakov who invented emulated growing, Thanks to Andy Polyakov who invented emulated growing,
 End of changes. 14 change blocks. 
19 lines changed or deleted 46 lines changed or added

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