NAME
burncd
—
control the ATAPI CD-R/RW
driver
SYNOPSIS
burncd |
[-delmnpqtv ] [-f
device] [-s
speed] [command]
[command file ...] |
DESCRIPTION
Theburncd
utility is used to burn CD-R/RW media using
the ATAPI cd driver.
Available options and operands:
-d
- burn the CD-R/RW in DAO (disk at once) mode.
-e
- eject the media when done.
-f
device- set the device to use for the burning process.
-l
- read a list of image files from filename.
-m
- close disk in multisession mode (otherwise disk is closed as singlesession).
-n
- do not write gaps between data tracks in DAO mode.
-p
- use preemphasis on audio tracks.
-q
- quiet, do not print progress messages.
-s
speed- set the speed of the burner device. Defaults to 1. Specify
“
max
” to use the drive's fastest speed. -t
- test write, do not actually write on the media.
-v
- verbose, print extra progress messages.
command may be one of:
msinfo
- Show the first LBA of the last track on the media and the next writeable
address on the media for use with the
mkisofs(8)'s
-C
switch when adding additional data to ISO file systems with extra sessions. blank
- Blank a CD-RW medium. This uses the fast blanking method, so data are not physically overwritten, only those areas that make the media appear blank for further usage are erased.
erase
- Erase a CD-RW medium. This erases the entire media. Can take up to 1 hour to finish.
fixate
- Fixate the medium so that the TOC is generated and the media can be used
in an ordinary CD drive. The driver defaults to creating singlesession
media (see
-m
option). Should be the last command toburncd
as the program exits when this has been done. Ignored in DAO mode (see-d
option). raw
|audio
- Set the write mode to produce audio (raw mode) tracks for the following images on the command line.
data
|mode1
- Set the write mode to produce data (mode1) tracks for the following image files on the command line.
mode2
- Set the write mode to produce data (mode2) tracks for the following image files on the command line.
XAmode1
- Set the write mode to produce data (XAmode1) tracks for the following image files on the command line.
XAmode2
- Set the write mode to produce data (XAmode2) tracks for the following image files on the command line.
vcd
- Set the write mode to produce VCD/SVCD tracks for the following image
files on the command line. This automatically sets DAO
(
-d
) and “no gaps” (-n
) modes. - file
- All other arguments are treated as filenames of images to write to the
media, or in case the
-l
option is used as files containing lists of images.
Files whose length are not a multiple of the current media
blocksize are quietly zero padded to fit the blocksize requirement. The
conventional filename -
refers to stdin, and can
only be used once.
EXAMPLES
The typical usage for burning a data CD-R:
burncd -f /dev/acd0c data file1
fixate
The typical usage for burning an audio CD-R:
burncd -f /dev/acd0c audio file1
file2 file3 fixate
The typical usage for burning an audio CD-R in DAO mode:
burncd -f /dev/acd0c -d audio file1
file2 file3
The typical usage for burning a mixed mode CD-R:
burncd -f /dev/acd0c data file1 audio
file2 file3 fixate
The typical usage for burning from a compressed image file on stdin:
gunzip -c file.iso.gz | burncd -f
/dev/acd0c data - fixate
In the examples above, the files burned to data CD-Rs are assumed to be ISO9660 file systems. mkisofs(8), available in the dports(7) collection, is commonly used to create ISO9660 file system images from a given directory tree.
HISTORY
The burncd
utility appeared in
FreeBSD 4.0.
AUTHORS
The burncd
utility and this manpage was
contributed by Søren Schmidt
<sos@FreeBSD.org>,
Denmark.
BUGS
Probably, please report when found.