summaryrefslogtreecommitdiffstats
path: root/usr.sbin/burncd/burncd.8
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/burncd/burncd.8')
-rw-r--r--usr.sbin/burncd/burncd.838
1 files changed, 26 insertions, 12 deletions
diff --git a/usr.sbin/burncd/burncd.8 b/usr.sbin/burncd/burncd.8
index ad86abf..24ba84f 100644
--- a/usr.sbin/burncd/burncd.8
+++ b/usr.sbin/burncd/burncd.8
@@ -1,5 +1,5 @@
.\"
-.\" Copyright (c) 2000 Søren Schmidt
+.\" Copyright (c) 2000,2001 Søren Schmidt
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -38,8 +38,11 @@
.Op Fl f Ar device
.Op Fl s Ar speed
.Op Fl e
+.Op Fl l
+.Op Fl m
.Op Fl p
.Op Fl q
+.Op Fl t
.Ar [command]
.Ar [command filename...]
.Sh DESCRIPTION
@@ -53,9 +56,13 @@ Available options and operands:
.It Fl f Ar device
set the device to use for the burning process.
.It Fl s Ar speed
-set the speed of the burner device, typically 1, 2 or 4. Defaults to 1.
+set the speed of the burner device. Defaults to 1.
.It Fl e
-eject the CD-R/RW when done.
+eject the media when done.
+.It Fl l
+read a list of image files from filename.
+.It Fl m
+close disk in multisession mode (otherwise disk is closed as singlesession).
.It Fl p
use preemphasis on audio tracks.
.It Fl q
@@ -76,9 +83,12 @@ and the next writeable address on the media for use with the
switch when adding additional data to ISO filesystems with extra sessions.
.It Ar 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.
+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.
+.It Ar erase
+Erase a CD-RW medium.
+This erases the entire media. Can take up to 1 hour to finish.
.It Ar 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 multisession media.
+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 to
.Nm
as the program exits when this has been done.
@@ -94,10 +104,11 @@ on the command line.
Set the write mode to produce data (XAmode1) tracks for the following image
files on the command line.
.It Ar filename
-All other arguments are treated as filenames of images to write to the media.
+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.
.El
.Pp
-Files whose length are not a multiple of the current media blocksize are quietly zero padded to fit the blocksize requirement.
+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.
.Pp
.Sh EXAMPLES
The typical usage for burning a data CD-R:
@@ -112,16 +123,19 @@ The typical usage for burning a mixed mode CD-R:
.Bd -literal
# burncd -f /dev/acd0c data file1 audio file2 file3 fixate
.Pp
+The typical usage for burning from a compressed image file on stdin:
+.Bd -literal
+# gunzip -c file.iso.gz | burncd -f /dev/acd0c data - fixate
+.Pp
.Sh BUGS
Probably, please report when found.
.Sh HISTORY
-.Nm
-is currently under development.
The
.Nm
command appeared in
.Fx 4.0 .
.Sh AUTHORS
-The program has been contributed by
-.An S\(/oren Schmidt ,
-Denmark.
+The
+.Nm
+command and this manpage was contributed by
+.An S\(/oren Schmidt, Denmark (sos@freebsd.org).
OpenPOWER on IntegriCloud