"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "xorriso/xorrecord.1" 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.

xorrecord.1  (xorriso-1.5.2)	:	xorrecord.1  (xorriso-1.5.4)
skipping to change at line 136		skipping to change at line 136
also the address used by default when operating systems mount a medium with e.g. ISO 9660		also the address used by default when operating systems mount a medium with e.g. ISO 9660
filesystem.		filesystem.
The second number tells the next writable address, where xorre cord will begin to write the next		The second number tells the next writable address, where xorre cord will begin to write the next
session.		session.
This option is only valid for written, appendable media. In all ot her cases it will yield no output		This option is only valid for written, appendable media. In all ot her cases it will yield no output
text but will abort the program with non-zero exit value.		text but will abort the program with non-zero exit value.
Settings for the burn run:		Settings for the burn run:
A burn run requires exactly one track source address argument, which tells from where to read the data		A burn run requires exactly one track source address argument, which tells from where to read the data
which shall be put into the upcomming session. The medium state must be e ither blank or appendable.		which shall be put into the upcoming session. The medium state must be ei ther blank or appendable.
Track source may be "-" for standard input or the address of a read able file of any type except		Track source may be "-" for standard input or the address of a read able file of any type except
directories. Nearly all media types accept a track source with unpred ictable byte count, like standard		directories. Nearly all media types accept a track source with unpred ictable byte count, like standard
input or named pipes. Nevertheless, DVD-R DL and DVD-RW blanked by mode deformat_quickest demand exact		input or named pipes. Nevertheless, DVD-R DL and DVD-RW blanked by mode deformat_quickest demand exact
in-advance reservation of the track size, so that they either need to be read from a source of predictable		in-advance reservation of the track size, so that they either need to be read from a source of predictable
length, or need to be accompanied by option tsize= or by option -isosize.		length, or need to be accompanied by option tsize= or by option -isosize.
Several options expect a size value as argument. A number with a trailing letter "b" or without a trailing		Several options expect a size value as argument. A number with a trailing letter "b" or without a trailing
letter is a plain byte count. Other trailing letters cause multiplication of the given number by a scaling		letter is a plain byte count. Other trailing letters cause multiplication of the given number by a scaling
factor:		factor:
"k" or "K" = 1024 , "m" or "M" = 1024k , "g" or "G" = 1024m , "s" or "S" = 2048		"k" or "K" = 1024 , "m" or "M" = 1024k , "g" or "G" = 1024m , "s" or "S" = 2048
E.g. tsize=234567s means a size of 234567 * 2048 = 480393216 bytes.		E.g. tsize=234567s means a size of 234567 * 2048 = 480393216 bytes.
skipping to change at line 171		skipping to change at line 171
blank=format_overwrite. Blank unformatted BD-R stay unforma tted.		blank=format_overwrite. Blank unformatted BD-R stay unforma tted.
(Note: blank=as_needed is not an original cdrecord option.)		(Note: blank=as_needed is not an original cdrecord option.)
all		all
Blank an entire CD-RW or an unformatted DVD-RW.		Blank an entire CD-RW or an unformatted DVD-RW.
fast		fast
Minimally blank an entire CD-RW or blank an unformatted DVD -RW.		Minimally blank an entire CD-RW or blank an unformatted DVD -RW.
deformat		deformat
Like blank=all but with the additional ability to blank ov erwriteable DVD-RW. This will		Like blank=all but with the additional ability to blank o verwritable DVD-RW. This will
destroy their formatting and make them sequentially recorda ble.		destroy their formatting and make them sequentially recorda ble.
(Note: blank=deformat is not an original cdrecord options)		(Note: blank=deformat is not an original cdrecord options)
deformat_quickest		deformat_quickest
Like blank=deformat but blanking DVD-RW only minimally. This is faster than full blanking		Like blank=deformat but blanking DVD-RW only minimally. This is faster than full blanking
but yields media incapable of writing tracks of unpredicata ble size. Multi-session will not		but yields media incapable of writing tracks of unpredictab le size. Multi-session will not
be possible either.		be possible either.
(Note: blank=deformat_quickest is not an original cdrecord option.)		(Note: blank=deformat_quickest is not an original cdrecord option.)
format_overwrite		format_overwrite
Format a DVD-RW to "Restricted Overwrite". The user should bring some patience.		Format a DVD-RW to "Restricted Overwrite". The user should bring some patience.
Format unformatted DVD+RW, BD-RE or blank BD-R to their d efault size. It is not mandatory		Format unformatted DVD+RW, BD-RE or blank BD-R to their d efault size. It is not mandatory
to do this with DVD+RW and BD-RE media, because they will g et formatted automatically on the		to do this with DVD+RW and BD-RE media, because they will g et formatted automatically on the
first write attempt.		first write attempt.
BD-R media may be written in unformatted state. This keep s disabled the replacement of bad		BD-R media may be written in unformatted state. This keep s disabled the replacement of bad
blocks and enables full nominal write speed. Once BD-R medi a are written, they cannot be		blocks and enables full nominal write speed. Once BD-R medi a are written, they cannot be
skipping to change at line 207		skipping to change at line 207
-multi This option keeps CD, unformatted DVD-R[W], DVD+R, or BD-R appenda ble after the current session has		-multi This option keeps CD, unformatted DVD-R[W], DVD+R, or BD-R appenda ble after the current session has
been written. Without it the disc gets closed and may not be w ritten any more - unless it is a		been written. Without it the disc gets closed and may not be w ritten any more - unless it is a
-RW and gets blanked, which causes loss of its content.		-RW and gets blanked, which causes loss of its content.
This option cannot be applied to DVD-R DL or to DVD-RW which were blanked by mode		This option cannot be applied to DVD-R DL or to DVD-RW which were blanked by mode
"deformat_quickest". Option --multi_if_possible may automatica lly recognize and handle this		"deformat_quickest". Option --multi_if_possible may automatica lly recognize and handle this
situation.		situation.
In order to have all filesystem content accessible, the eventual I SO-9660 filesystem of a follow-up		In order to have all filesystem content accessible, the eventual I SO-9660 filesystem of a follow-up
session needs to be prepared in a special way by the files ystem formatter program. mkisofs,		session needs to be prepared in a special way by the files ystem formatter program. mkisofs,
genisoimage, and xorrisofs expect particular info about the situat ion which can be retrieved by		genisoimage, and xorrisofs expect particular info about the situat ion which can be retrieved by
xorrecord option -msinfo.		xorrecord option -msinfo.
With overwriteable DVD or BD media, -multi cannot mark the end		With overwritable DVD or BD media, -multi cannot mark the end of t
of the session. So when adding a		he session. So when adding a new
new session, this end has to be determined from the payload. Curr		session, this end has to be determined from the payload. Currentl
ently only ISO-9660 filesystems		y only ISO-9660 filesystems can
can be used that way. See option --grow_overwriteable_iso.		be used that way. See option --grow_overwriteable_iso.
-dummy Try to perform the drive operations without actually affectin g the inserted media. There is no		-dummy Try to perform the drive operations without actually affectin g the inserted media. There is no
warranty that this will work with a particular combination of drive and media. Blanking is		warranty that this will work with a particular combination of drive and media. Blanking is
prevented reliably, though. To avoid inadverted real burning, -du mmy refuses burn runs on anything		prevented reliably, though. To avoid inadverted real burning, -du mmy refuses burn runs on anything
but CD-R[W], DVD-R[W], or emulated stdio-drives.		but CD-R[W], DVD-R[W], or emulated stdio-drives.
-waiti Wait until input data is available at stdin or EOF occurs at stdin . Only then begin to access any		-waiti Wait until input data is available at stdin or EOF occurs at stdin . Only then begin to access any
drives.		drives.
One should use this if xorrisofs is working at the end of a pi pe where the feeder process reads		One should use this if xorrisofs is working at the end of a pi pe where the feeder process reads
from the drive before it starts writing its output into xorrisofs. Example:		from the drive before it starts writing its output into xorrisofs. Example:
skipping to change at line 244		skipping to change at line 244
xorrecord exits with non-zero value.		xorrecord exits with non-zero value.
-isosize		-isosize
Try to obtain the track size from the content of the track source. This works only if the track		Try to obtain the track size from the content of the track source. This works only if the track
source bears an ISO 9660 filesystem. Any other track source c ontent will cause the burn run to		source bears an ISO 9660 filesystem. Any other track source c ontent will cause the burn run to
abort.		abort.
If the track source is not a regular file or block device, then th is option will work only if the		If the track source is not a regular file or block device, then th is option will work only if the
program's fifo size is at least 64k. See option fs=.		program's fifo size is at least 64k. See option fs=.
padsize=size		padsize=size
Add the given amount of trailing zeros to the upcomming track.		Add the given amount of trailing zeros to the upcoming track. Thi
This feature can be disabled by		s feature can be disabled by size
size 0. Default is 300 kB in order to work around a problem with G		0. Default is 300 kB in order to work around a problem with GNU/Li
NU/Linux which often fails to		nux which often fails to read the
read the last few blocks of a CD track which was written		last few blocks of a CD track which was written in write mode TAO
in write mode TAO. TAO is used by		. TAO is used by xorrecord if the
xorrecord if the track size cannot be predicted or if the CD mediu		track size cannot be predicted or if the CD medium is not blank bu
m is not blank but appendable.		t appendable.
-nopad The same as padsize=0.		-nopad The same as padsize=0.
-pad The same as padsize=15s. This was once sufficient with older GN U/Linux kernels. Meanwhile one		-pad The same as padsize=15s. This was once sufficient with older GN U/Linux kernels. Meanwhile one
should at least use padsize=128k, if not padsize=300k.		should at least use padsize=128k, if not padsize=300k.
-data Explicitly announce that the track source shall be recorded as da ta track, and not as audio track.		-data Explicitly announce that the track source shall be recorded as da ta track, and not as audio track.
This option has no effect with xorrecord, because there is no su pport for other track formats		This option has no effect with xorrecord, because there is no su pport for other track formats
anyway.		anyway.
skipping to change at line 356		skipping to change at line 356
command while all others have to wait for its completion. This yi elds awful throughput if more		command while all others have to wait for its completion. This yi elds awful throughput if more
than one drive is writing or reading simultaneously.		than one drive is writing or reading simultaneously.
The global lock is not applied to device files /dev/sg* and also n ot with the system calls read(2),		The global lock is not applied to device files /dev/sg* and also n ot with the system calls read(2),
write(2). But ioctl(SG_IO) is affected, which is needed to perform the SCSI commands for optical		write(2). But ioctl(SG_IO) is affected, which is needed to perform the SCSI commands for optical
burning.		burning.
So for simultaneous burn runs on modern GNU/Linux it is advisable to use		So for simultaneous burn runs on modern GNU/Linux it is advisable to use
drive_scsi_dev_family="sg". The drive addresses may then well b e given as /dev/sr* but will		drive_scsi_dev_family="sg". The drive addresses may then well b e given as /dev/sr* but will
nevertheless get used as /dev/sg*.		nevertheless get used as /dev/sg*.
--grow_overwriteable_iso		--grow_overwriteable_iso
Enable emulation of multi-session writing on overwriteable media which contain an ISO 9660		Enable emulation of multi-session writing on overwritable m edia which contain an ISO 9660
filesystem. This emulation is learned from growisofs -M but adapte d to the usage model of		filesystem. This emulation is learned from growisofs -M but adapte d to the usage model of
xorrecord -msinfo		xorrecord -msinfo
xorrisofs -C -M | xorrecord -waiti -multi -		xorrisofs -C -M | xorrecord -waiti -multi -
for sequential media.		for sequential media.
--grow_overwriteable_iso does not hamper the use of true multi-ses sion media. I.e. it is possible		--grow_overwriteable_iso does not hamper the use of true multi-ses sion media. I.e. it is possible
to use the same xorrecord options with both kinds of media and to achieve similar results if ISO		to use the same xorrecord options with both kinds of media and to achieve similar results if ISO
9660 filesystem images are to be written. This option implies option -isosize and therefore		9660 filesystem images are to be written. This option implies option -isosize and therefore
demands that the track source is a ISO 9660 filesystem image.		demands that the track source is a ISO 9660 filesystem image.
With overwriteable media and no option blank=fast|all presen t it expands an eventual ISO 9660		With overwritable media and no option blank=fast|all presen t it expands an eventual ISO 9660
filesystem on media. It is assumed that this image's inner size de scription points to the end of		filesystem on media. It is assumed that this image's inner size de scription points to the end of
the valuable data. Overwriteable media with a recognizable ISO 9660 size will be regarded as		the valuable data. Overwritable media with a recognizable ISO 9660 size will be regarded as
appendable rather than as blank. I.e. options -msinfo and -toc wil l work. -toc will always show a		appendable rather than as blank. I.e. options -msinfo and -toc wil l work. -toc will always show a
single session with its size increasing with every added ISO 9660 image.		single session with its size increasing with every added ISO 9660 image.
--multi_if_possible		--multi_if_possible
Apply option -multi if the medium is suitable. Not suitable ar e DVD-R DL and DVD-RW, which were		Apply option -multi if the medium is suitable. Not suitable ar e DVD-R DL and DVD-RW, which were
blanked with mode "deformat_quickest".		blanked with mode "deformat_quickest".
Not all drives correctly recognize such fast-blanked DVD-RW which need "on". If there is well		Not all drives correctly recognize such fast-blanked DVD-RW which need "on". If there is well
founded suspicion that a burn run failed due to -multi, then this causes a re-try without -multi.		founded suspicion that a burn run failed due to -multi, then this causes a re-try without -multi.
stream_recording="on"|"off"|number		stream_recording="on"|"off"|number
skipping to change at line 565		skipping to change at line 565
public list <bug-xorriso@gnu.org>. If more privacy is desired, mail to < scdbackup@gmx.net>.		public list <bug-xorriso@gnu.org>. If more privacy is desired, mail to < scdbackup@gmx.net>.
Please describe what you expect xorriso to do, the program arguments or d ialog commands by which you tried		Please describe what you expect xorriso to do, the program arguments or d ialog commands by which you tried
to achieve it, the messages of xorriso, and the undesirable outcome of yo ur program run.		to achieve it, the messages of xorriso, and the undesirable outcome of yo ur program run.
Expect to get asked more questions before solutions can be proposed.		Expect to get asked more questions before solutions can be proposed.
AUTHOR		AUTHOR
Thomas Schmitt <scdbackup@gmx.net>		Thomas Schmitt <scdbackup@gmx.net>
for libburnia-project.org		for libburnia-project.org
COPYRIGHT		COPYRIGHT
Copyright (c) 2011 - 2019 Thomas Schmitt		Copyright (c) 2011 - 2021 Thomas Schmitt
Permission is granted to distribute this text freely. It shall only be mo dified in sync with the technical		Permission is granted to distribute this text freely. It shall only be mo dified in sync with the technical
properties of xorriso. If you make use of the license to derive modified versions of xorriso then you are		properties 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.		entitled to modify this text under that same license.
CREDITS		CREDITS
xorriso is in part based on work by Vreixo Formoso who provides libisofs together with Mario Danic who		xorriso is in part based on work by Vreixo Formoso who provides libisofs together with Mario Danic who
also leads the libburnia team. Thanks to Andy Polyakov who invented e mulated growing, to Derek Foreman		also leads the libburnia team. Thanks to Andy Polyakov who invented e mulated growing, to Derek Foreman
and Ben Jansens who once founded libburn.		and Ben Jansens who once founded libburn.
Compliments towards Joerg Schilling whose cdrtools served me for ten year s.		Compliments towards Joerg Schilling whose cdrtools served me for ten year s.
Version 1.5.2, Oct 26, 2019 XORRECORD(1)		Version 1.5.4, Jan 30, 2021 XORRECORD(1)
End of changes. 10 change blocks.
20 lines changed or deleted		20 lines changed or added

---