cdrecord.1..txt

另一种方法编辑刻录程序的代码!要的与偶联系呀

If a SCSI command fails due to a timeout, you may try to raise the
default SCSI command timeout above the timeout value of the failed command.
If the command runs correctly with a raised command timeout,
please report the better timeout value and the corresponding command to 
the author of the program.
If no 
.I timeout 
option is present, a default timeout of 40 seconds is used.
.TP
.BI driver= name
Allows to use a user supplied driver name for the device.
To get a list of possible drivers use
.BR "driver=help" .
The reason for the existence of this option is to allow users to use 
.B cdrecord
with drives that are similar to supported drives but not known
directly by
.BR cdrecord .
Use this option with extreme care. If a wrong driver is used for a
device, the possibility of creating corrupted disks is high.
The minimum problem related to a wrong driver is that the 
.B \-speed
or 
.B \-dummy
will not work.
.sp
There are two special driver entries in the list:
.B cdr_simul
and
.BR dvd_simul .
These driver entries are designed to make timing tests at any speed
or timing tests for drives that do not support the 
.B \-dummy
option.
The simulation drivers implement a drive with a buffer size of 1MB
that can be changed via the 
.B CDR_SIMUL_BUFSIZE
environment variable.
The simultaion driver correctly simulates even a buffer underrun condition.
If the 
.B \-dummy 
option is present, the simultaion is not aborted in case of a buffer underrun.

.TP
.B \-checkdrive
Checks if a driver for the current drive is present and exit.
If the drive is a known drive, 
.B cdrecord
uses exit code 0.
.TP
.B \-prcap
Print the drive capabilities for SCSI-3/mmc compliant drives
as obtained from mode page 0x2A. Values marked with 
.I kB
use 1000 bytes as kilo-byte, values marked with
.I KB
use 1024 bytes as Kilo-byte.
.TP
.B \-inq
Do an inquiry for the drive, print the inquiry info and exit.
.TP
.B \-scanbus
Scan all SCSI devices on all SCSI busses and print the inquiry
strings. This option may be used to find SCSI address of the 
CD-Recorder on a system.
The numbers printed out as labels are computed by: 
.B "bus * 100 + target
.TP
.B \-reset
Try to reset the SCSI bus where the CD recorder is located. This works not
on all operating systems.
.TP
.B \-ignsize
Ignore the known size of the medium. This options should be used with extreme
care, it exists only for debugging purposes don't use it for other reasons.
It is not needed to write disks with more than the nominal capacity.
.TP
.BR defpregap =#
Set the default pre-gap size for all tracks except track number 1.
This option currently only makes sense with the TEAC drive when
creating track-at-once disks without the 2 second silence before each track.
.br
This option may go away in future. 
.TP
.B \-packet
Set Packet writing mode. 
This is an experimental interface.
.TP
.BR pktsize =#
Set the paket size to #, forces fixed packet mode.
This is an experimental interface.
.TP
.B \-noclose
Do not close the current track, useful only when in packet writing mode.
This is an experimental interface.

.SH "TRACK OPTIONS
.PP
Track options may be mixed with track file names.
.TP
.B \-audio
If this flag is present, all subsequent tracks are written in
.B "CD-DA 
(similar to Red Book) audio format.
The file with data for this tracks should
contain stereo, 16-bit digital audio with 44100 samples/s.
The byte order should be the following: MSB left, LSB left, 
MSB right, LSB right, MSB left and so on. The track should be a multiple of 
2352 bytes. It is not possible to put the master image of an audio track 
on a raw disk because 
data will be read in multiple of 2352 bytes during the recording process.
.sp
If a filename ends in 
.I .au
or
.I .wav
the file is considered to be a structured audio data file.
.B Cdrecord
assumes that the file in this case is a Sun audio file or a
Microsoft .WAV file
and extracts the audio data from the files by skipping over the
non-audio header information.
In all other cases, cdrecord will only work correctly if the
audio data stream does not have any header.
Because many structured audio files do not have an integral
number of blocks (1/75th second) in length,
it is often necessary to specify the
.B \-pad
option as well.
.B cdrecord
recognizes that audio data in a .WAV file is stored in Intel
(little-endian) byte order, and will automatically byte-swap the data
if the CD recorder requires big-endian data.  
.B Cdrecord
will reject any audio file that does not match the Red Book requirements
of 16-bit stereo samples in PCM coding at 44100 samples/second.
.sp
Using other structured audio data formats as input to 
.B cdrecord
will usually work if the structure of the data is the 
structure described above (raw pcm data in big-endian byte order).
However, if the data format includes a header,
you will hear a click at the start of a track.
.TP
.B \-swab
If this flag is present, audio data is assumed to be in byte-swapped
(little-endian) order.  Some types of CD-Writers e.g. Yamaha, Sony and the
new SCSI-3/mmc drives require audio data to be presented in
little-endian order,
.\" (which is the order in which it's actually recorded on the CD) ????
while other writers require audio data to be
presented in the big-endian (network) byte order normally used by the
SCSI protocol.
.B Cdrecord
knows if a CD-Recorder needs audio data in big- or little-endian order,
and corrects the byte order of the data stream to match the needs
of the recorder.
You only need the 
.I \-swab 
flag if your data stream is in Intel (little-endian) byte order.
.sp
Note that the verbose output of
.B cdrecord
will show you if swapping is necessary to make the byte order of 
the input data fit the required byte order of the recorder.
.B Cdrecord
will not show you if the 
.I \-swab 
flag was actually present for a track.
.TP
.B \-data
If this flag is present, all subsequent tracks are written in
.B "CD-ROM mode 1
(Yellow Book) format. The data is a multiple of 2048 bytes.
The file with track data should contain an 
.BR ISO-9660 " or " "Rock Ridge
filesystem image (see 
.B mkisofs
for more details). If the track data is an
.B ufs
filesystem image, fragment size should be set to 2 KB or more to allow
CR-drives with 2 KB sector size to to be used for reading.
.TP
.I " "
\-data is the default, if no other flag is present.
.TP
.B \-mode2
If this flag is present, all subsequent tracks are written in
.B "CD-ROM mode 2
format. The data is a multiple of 2048 bytes.
.TP
.B \-xa1
If this flag is present, all subsequent tracks are written in
.B "CD-ROM XA mode 1
format. The data is a multiple of 2048 bytes.
.TP
.B \-xa2
If this flag is present, all subsequent tracks are written in
.B "CD-ROM XA mode 2
format. The data is a multiple of 2048 bytes.
.TP
.B \-cdi
If this flag is present, all subsequent tracks are written in
.B "CDI
format. The data is a multiple of 2048 bytes.
.TP
.B \-isosize
Use the 
.B "ISO-9660
file system size as the size of the next track.
This option is needed if you want to read the image of a track from
a raw disk partition or on a master CD. In the first case the option
.B \-isosize
is needed to limit the size of the CD to the size of the ISO filesystem.
In the second case the option
.B \-isosize
is needed to prevent 
.B cdrecord
from reading the two run out blocks that are appended by each CD-recorder
in track at once mode. These two run out blocks cannot be read and would
cause a buffer under run that would cause a defective copy.
Do not use this option if 
.B cdrecord
reads the track data from 
.IR stdin .
This option currently cannot be used to determine the size of a file system
if the multi session option is present.
.TP
.B \-pad
If the track is a data track, 15 sectors of zeroed data
will be added to the end of this and each subsequent data track.
In this case, the 
.B \-pad 
option is superseded by the 
.B padsize=
option. It will remain however as a shorthand for
.BI padsize=15s.
If the 
.I \-pad 
option refers to an audio track,
.B cdrecord 
will pad the audio data to be a multiple of 2352 bytes. 
The audio data padding is done with binary zeroes which is 
equal to absolute silence.
.TP
.BR padsize= #
Set the amount of data to be appended as padding to the next track to #.
Opposed to the behavior of the 
.B \-pad
option, this value is reset to zero for each new track.
See
.BR fs =
option for possible arguments.
Use this option if your CD-drive is not able to read the last sectors of
a track or if you want to be able to read the CD
on a 
.B Linux 
system with the ISO-9660 filesystem read ahead bug.
If an empty file is used for track data, 
this option may be used to create a disk that is entirely made of padding.
.TP
.B \-nopad
Do not pad the following tracks \- the default.
.TP
.BR pregap =#
Set the  pre-gap size for the next track.
This option currently only makes sense with the TEAC drive when
creating track-at-once disks without the 2 second silence before each track.
.br
This option may go away in future. 
.TP
.B \-preemp
If this flag is present, all TOC entries for subsequent audio tracks 
will indicate that the audio data has been sampled with 50/15 祍ec
preemphasis.
The data, however is not modified during the process of transferring from file
to disk. 
This option has no effect on data tracks.
.TP
.B \-nopreemp
If this flag is present, all TOC entries for subsequent audio tracks 
will indicate that the audio data has been mastered with linear data \- 
this is the default.
.TP
.B tsize=#
If the master image for the next track has been stored on a raw disk, 
use this option
to specify the valid amount of data on this disk. If the image of the next 
track is stored in a regular file, the size of that file is taken to determine
the length of this track.
If the track contains an ISO 9660 filesystem image use the 
.I \-isosize
option to determine the length of that filesystem image.
.br
In Disk at Once mode (not yet implemented) and with some drives that use
the TEAC programming interface, even in Track at Once mode,
.B cdrecord
needs to know the size of each track before starting to write the disk.
Cdrecord now checks this and aborts before starting to write.
If this happens you will need to run
.B "mkisofs -print-size
before and use the output as an argument to the 
.BR tsize =
option of 
.BR cdrecord .
.br
See
.BR fs =
option for possible arguments.

.SH EXAMPLES
.PP
For all examples below, it will be assumed that the CD-Recorder is
connected to the primary SCSI bus of the machine. The SCSI target id is
set to 2.
.PP
To record a pure CD-ROM at double speed, using data from the file
.IR cdimage.raw :
.PP
    cdrecord \-v speed=2 dev=2,0 cdimage.raw
.PP
To create an image for a ISO 9660 filesystem with Rock Ridge extensions:
.PP
    mkisofs \-R \-o cdimage.raw /home/joerg/master/tree
.PP
To check the resulting file before writing to CD on Solaris:
.PP
    mount \-r \-F fbk \-o type=hsfs /dev/fbk0:cdimage.raw /mnt
.PP
On Linux:
.PP
    mount cdimage.raw \-r \-t iso9660 \-o loop /mnt
.PP
Go on with:
.br
    ls \-lR /mnt
.br
    umount /mnt
.PP
If the overall speed of the system is sufficient and the structure of
the filesystem is not too complex, cdrecord will run without creating an
image of the ISO 9660 filesystem. Simply run the pipeline:
.PP
    mkisofs \-R /master/tree | cdrecord \-v fs=6m speed=2 dev=2,0 -
.PP
The recommended minimum fifo size for running this pipeline is 4 MBytes.
As the default fifo size is 4 MB, the 
.B fs=
option needs only be present if you want to use a different fifo size.
If your system is loaded, you should run mkisofs in the real time class too.
To raise the priority of 
.B mkisofs
replace the command
.PP
    mkisofs \-R /master/tree
.br
by
.br
    priocntl \-e \-c RT \-p 59 mkisofs \-R /master/tree
.sp
on Solaris and by
.sp
    nice --18 mkisofs \-R /master/tree
.sp
on systems that don't have
.B "UNIX International
compliant realtime scheduling.
.PP
Cdrecord runs at priority 59 on Solaris, you should run mkisofs
at no more than priority 58. On other systems, you should run mkisofs
at no less than nice --18.
.PP