1.\" 2.\" Copyright (c) 2000,2001,2002 S�ren Schmidt <sos@FreeBSD.org> 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer, 10.\" without modification, immediately at the beginning of the file. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. The name of the author may not be used to endorse or promote products 15.\" derived from this software without specific prior written permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" 28.\" $FreeBSD: src/usr.sbin/burncd/burncd.8,v 1.6.2.8 2003/03/12 22:08:13 trhodes Exp $ 29.\" $DragonFly: src/usr.sbin/burncd/burncd.8,v 1.3 2005/08/06 20:18:55 cpressey Exp $ 30.\" 31.Dd December 4, 2001 32.Os 33.Dt BURNCD 8 34.Sh NAME 35.Nm burncd 36.Nd control the ATAPI CD-R/RW driver 37.Sh SYNOPSIS 38.Nm 39.Op Fl delmnpqtv 40.Op Fl f Ar device 41.Op Fl s Ar speed 42.Op Ar command 43.Op Ar command Ar 44.Sh DESCRIPTION 45The 46.Nm 47utility is used to burn CD-R/RW media using the ATAPI cd driver. 48.Pp 49Available options and operands: 50.Pp 51.Bl -tag -width XXXXXXXXXXXX 52.It Fl d 53burn the CD-R/RW in DAO (disk at once) mode. 54.It Fl e 55eject the media when done. 56.It Fl f Ar device 57set the device to use for the burning process. 58.It Fl l 59read a list of image files from filename. 60.It Fl m 61close disk in multisession mode (otherwise disk is closed as singlesession). 62.It Fl n 63do not write gaps between data tracks in DAO mode. 64.It Fl p 65use preemphasis on audio tracks. 66.It Fl q 67quiet, do not print progress messages. 68.It Fl s Ar speed 69set the speed of the burner device. 70Defaults to 1. 71Specify 72.Dq Li max 73to use the drive's fastest speed. 74.It Fl t 75test write, do not actually write on the media. 76.It Fl v 77verbose, print extra progress messages. 78.El 79.Pp 80.Ar command 81may be one of: 82.Pp 83.Bl -tag -width XXXXXXXXXXXX 84.It Cm msinfo 85Show the first LBA of the last track on the media 86and the next writeable address on the media for use with the 87.Xr mkisofs 8 Ns 's 88.Fl C 89switch when adding additional data to ISO file systems with extra sessions. 90.It Cm blank 91Blank a CD-RW medium. 92This uses the fast blanking method, so data are not physically overwritten, 93only those areas that make the media appear blank for further usage are erased. 94.It Cm erase 95Erase a CD-RW medium. 96This erases the entire media. 97Can take up to 1 hour to finish. 98.It Cm fixate 99Fixate the medium so that the TOC is generated and the media can be used 100in an ordinary CD drive. 101The driver defaults to creating singlesession media (see 102.Fl m 103option). 104Should be the last command to 105.Nm 106as the program exits when this has been done. 107Ignored in DAO mode (see 108.Fl d 109option). 110.It Cm raw | audio 111Set the write mode to produce audio (raw mode) tracks for the following 112images on the command line. 113.It Cm data | mode1 114Set the write mode to produce data (mode1) tracks for the following 115image files 116on the command line. 117.It Cm mode2 118Set the write mode to produce data (mode2) tracks for the following 119image files 120on the command line. 121.It Cm XAmode1 122Set the write mode to produce data (XAmode1) tracks for the following image 123files on the command line. 124.It Cm XAmode2 125Set the write mode to produce data (XAmode2) tracks for the following image 126files on the command line. 127.It Cm vcd 128Set the write mode to produce VCD/SVCD tracks for the following image files 129on the command line. 130This automatically sets DAO 131.Pq Fl d 132and 133.Dq "no gaps" 134.Pq Fl n 135modes. 136.It Ar file 137All other arguments are treated as filenames of images to write to the media, 138or in case the 139.Fl l 140option is used as files containing lists of images. 141.El 142.Pp 143Files whose length are not a multiple of the current media blocksize are 144quietly zero padded to fit the blocksize requirement. 145The conventional filename 146.Fl 147refers to stdin, and can only be used once. 148.Sh EXAMPLES 149The typical usage for burning a data CD-R: 150.Pp 151.D1 burncd -f /dev/acd0c data Ar file1 No fixate 152.Pp 153The typical usage for burning an audio CD-R: 154.Pp 155.D1 burncd -f /dev/acd0c audio Ar file1 file2 file3 No Fixate 156.Pp 157The typical usage for burning an audio CD-R in DAO mode: 158.Pp 159.D1 burncd -f /dev/acd0c -d audio Ar file1 file2 file3 160.Pp 161The typical usage for burning a mixed mode CD-R: 162.Pp 163.D1 burncd -f /dev/acd0c data Ar file1 No audio Ar file2 file3 No fixate 164.Pp 165The typical usage for burning from a compressed image file on stdin: 166.Pp 167.Dl "gunzip -c file.iso.gz | burncd -f /dev/acd0c data - fixate" 168.Pp 169In the examples above, the files burned to data CD-Rs are assumed to 170be ISO9660 file systems. 171.Xr mkisofs 8 , 172available in the 173.Fx 174Ports Collection, is commonly used to create ISO9660 file system images 175from a given directory tree. 176.Sh BUGS 177Probably, please report when found. 178.Sh HISTORY 179The 180.Nm 181utility appeared in 182.Fx 4.0 . 183.Sh AUTHORS 184The 185.Nm 186utility and this manpage was contributed by 187.An S\(/oren Schmidt , 188Denmark 189.Aq sos@FreeBSD.org . 190