The worm device is dead in -CURRENT, and wormio.h just went away.
Reviewed by: commiters on IRC
This commit is contained in:
David E. O'Brien
parent
b7db19017b
commit
9bca155e93
@ -1,4 +0,0 @@
|
||||
PROG= wormcontrol
|
||||
MAN8= wormcontrol.8
|
||||
|
||||
.include <bsd.prog.mk>
|
||||
@ -1,182 +0,0 @@
|
||||
.\"
|
||||
.\" Copyright (C) 1996
|
||||
.\" interface business GmbH
|
||||
.\" Tolkewitzer Strasse 49
|
||||
.\" D-01277 Dresden
|
||||
.\" F.R. Germany
|
||||
.\"
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Written by Joerg Wunsch <joerg_wunsch@interface-business.de>
|
||||
.\"
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY
|
||||
.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
|
||||
.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
||||
.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
||||
.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
|
||||
.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
||||
.\" DAMAGE.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.\" arrgh, hilit19 needs this" :-(
|
||||
.Dd January 27, 1996
|
||||
.Os
|
||||
.Dt WORMCONTROL 8
|
||||
.Sh NAME
|
||||
.Nm wormcontrol
|
||||
.Nd control the CD-R driver
|
||||
.Sh SYNOPSIS
|
||||
.Nm wormcontrol
|
||||
.Op Fl f Ar device
|
||||
.Ar command
|
||||
.Op Ar params...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility is used to control the behaviour of the
|
||||
.Xr worm 4
|
||||
driver in order to adjust various parameters of a recordable CD
|
||||
.Pq CD-R .
|
||||
.Pp
|
||||
Unlike many other devices, CD-R's require a very strict handling order.
|
||||
Prior to writing data, the speed of the drive must be selected, and
|
||||
the drive can also be turned into a
|
||||
.Ql dummy
|
||||
mode, where every action is only performed with the laser turned off.
|
||||
This way, it's possible to test whether the environment provides a
|
||||
sufficiently high data flow rate in order to actually burn the CD-R,
|
||||
without destroying the medium in case of a catastrophic failure.
|
||||
.Pp
|
||||
In order to write a new track, the drive must be told whether the new
|
||||
track will become an audio or a data track. Audio tracks are written
|
||||
with a block size of 2352 bytes, while data tracks have 2048 bytes per
|
||||
block. For audio tracks, the driver does further need to know
|
||||
whether the data are recorded with a preemphasis.
|
||||
.Pp
|
||||
Once all tracks of a session have been written, the disk must be
|
||||
.Em fixated .
|
||||
This writes the table of contents and leadout information to the disk.
|
||||
The disk won't be usable without doing this.
|
||||
.Pp
|
||||
The following options are available:
|
||||
.Bl -tag -width ident
|
||||
.It Fl f Ar device
|
||||
Use
|
||||
.Ar device
|
||||
instead of the default
|
||||
.Pa /dev/rworm0 .
|
||||
.It prepdisk Ar single \&| double Op Ar dummy
|
||||
Prepare the disk for recording. This must be done before any tracks
|
||||
can be prepared, and remains in effect until the session has been
|
||||
fixated. Either single speed
|
||||
.Pq for audio data
|
||||
or double speed
|
||||
.Pq for CD-ROM data
|
||||
must be selected, and optionally, the argument
|
||||
.Ar dummy
|
||||
can be used to tell the drive to keep the laser turned off, for testing.
|
||||
.It track Ar audio \&| data Op Ar preemp
|
||||
Inform the driver about the format of the next track. Either
|
||||
.Ar audio
|
||||
or
|
||||
.Ar data
|
||||
.Pq CD-ROM
|
||||
must be selected, with an optional argument
|
||||
.Ar preemp
|
||||
that must be specified for an audio track where data records with
|
||||
preemphasis are being used. Once this command has been successfully
|
||||
specified, the track is ready for being written.
|
||||
.It fixate Ar toc-type Op Ar onp
|
||||
Once all tracks have been written, this closes the current session.
|
||||
The argument
|
||||
.Ar toc-type
|
||||
is a single digit between 0 and 4, with the following meaning:
|
||||
.Bl -item
|
||||
.It
|
||||
0 CD audio
|
||||
.It
|
||||
1 CD-ROM
|
||||
.It
|
||||
2 CD-ROM with first track in mode 1
|
||||
.It
|
||||
3 CD-ROM with first track in mode 2
|
||||
.It
|
||||
4 CDI
|
||||
.El
|
||||
.Pp
|
||||
The optional argument
|
||||
.Ar onp
|
||||
stands for
|
||||
.Dq open next program area ,
|
||||
which means that the next session on the CD-R will be opened and can
|
||||
be recorded in the future. Otherwise, the CD-R will be closed and
|
||||
remains unchangeable.
|
||||
.It blank
|
||||
Blank a CD-RW disk.
|
||||
.It nextwriteable
|
||||
Sets the next writeable location on the drive, used when writing
|
||||
more than one track ie CD-DA (audio) disks.
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
Error codes for the underlying
|
||||
.Xr ioctl 2
|
||||
commands are printed by the
|
||||
.Xr err 3
|
||||
facility.
|
||||
.Sh EXAMPLES
|
||||
The typical sequence of burning a data CD-R looks like:
|
||||
.Bd -literal
|
||||
# wormcontrol prepdisk double
|
||||
# wormcontrol track data
|
||||
# rtprio 5 team -v 1m 5 < cdrom.image | rtprio 5 dd of=/dev/rworm0 obs=20k
|
||||
# wormcontrol fixate 1
|
||||
.Ed
|
||||
.Pp
|
||||
Note that the
|
||||
.Xr dd 1
|
||||
command above is mainly used in order to
|
||||
.Dq slice
|
||||
the data stream. It's particularly useful when recording audio data
|
||||
with their rather unusual blocksize. Since the underlying device is a
|
||||
.Em raw
|
||||
device, the blocksize used in that command must be an integral multiple
|
||||
of the CD-R blocksize.
|
||||
.Pp
|
||||
The mentioned command
|
||||
.Xr team 1
|
||||
is not part of the base system, but comes extremely handy in order to
|
||||
pipe a constant data stream into the CD recorder.
|
||||
.Sh FILES
|
||||
.Bl -tag -width /usr/share/examples/worm/* -compact
|
||||
.It Pa /usr/share/examples/worm/*
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr dd 1 ,
|
||||
.Xr team 1 ,
|
||||
.Xr ioctl 2 ,
|
||||
.Xr err 3 ,
|
||||
.Xr worm 4
|
||||
.Sh HISTORY
|
||||
.Nm Wormcontrol
|
||||
is currently under development.
|
||||
.Sh AUTHORS
|
||||
The program has been contributed by
|
||||
.ie t J\(:org Wunsch,
|
||||
.el Joerg Wunsch,
|
||||
Dresden.
|
||||
@ -1,172 +0,0 @@
|
||||
/*
|
||||
* Copyright (C) 1996
|
||||
* interface business GmbH
|
||||
* Tolkewitzer Strasse 49
|
||||
* D-01277 Dresden
|
||||
* F.R. Germany
|
||||
*
|
||||
* All rights reserved.
|
||||
*
|
||||
* Written by Joerg Wunsch <joerg_wunsch@interface-business.de>
|
||||
*
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in the
|
||||
* documentation and/or other materials provided with the distribution.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY
|
||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE
|
||||
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
|
||||
* OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
||||
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
||||
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
|
||||
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
||||
* DAMAGE.
|
||||
*/
|
||||
|
||||
#ifndef lint
|
||||
static const char rcsid[] =
|
||||
"$FreeBSD$";
|
||||
#endif /* not lint */
|
||||
|
||||
#include <err.h>
|
||||
#include <fcntl.h>
|
||||
#include <stdio.h>
|
||||
#include <stdlib.h>
|
||||
#include <string.h>
|
||||
#include <sysexits.h>
|
||||
#include <unistd.h>
|
||||
|
||||
#include <sys/ioctl.h>
|
||||
#include <sys/wormio.h>
|
||||
|
||||
static void
|
||||
usage()
|
||||
{
|
||||
fprintf(stderr,"usage: wormcontrol [-f device] command [args]\n");
|
||||
exit(EX_USAGE);
|
||||
}
|
||||
|
||||
#define eq(a, b) (strcmp(a, b) == 0)
|
||||
|
||||
int
|
||||
main(int argc, char **argv)
|
||||
{
|
||||
int fd, c, i;
|
||||
int errs = 0;
|
||||
const char *devname = "/dev/rworm0";
|
||||
|
||||
while ((c = getopt(argc, argv, "f:")) != -1)
|
||||
switch(c) {
|
||||
case 'f':
|
||||
devname = optarg;
|
||||
break;
|
||||
|
||||
case '?':
|
||||
default:
|
||||
errs++;
|
||||
}
|
||||
|
||||
argc -= optind;
|
||||
argv += optind;
|
||||
|
||||
if (errs || argc < 1)
|
||||
usage();
|
||||
|
||||
if ((fd = open(devname, O_RDONLY | O_NONBLOCK, 0)) == -1)
|
||||
err(EX_NOINPUT, "open(%s)", devname);
|
||||
|
||||
if (eq(argv[0], "prepdisk")) {
|
||||
struct wormio_prepare_disk d;
|
||||
d.dummy = 0;
|
||||
d.speed = -1;
|
||||
for (i = 1; i < argc; i++) {
|
||||
if (eq(argv[i], "dummy"))
|
||||
d.dummy = 1;
|
||||
else if (eq(argv[i], "single"))
|
||||
d.speed = 1;
|
||||
else if (eq(argv[i], "double"))
|
||||
d.speed = 2;
|
||||
else if (eq(argv[i], "quad"))
|
||||
d.speed = 4;
|
||||
else if (eq(argv[i], "max"))
|
||||
d.speed = 99;
|
||||
else
|
||||
errx(EX_USAGE,
|
||||
"wrong param for \"prepdisk\": %s",
|
||||
argv[i]);
|
||||
}
|
||||
if (d.speed == -1)
|
||||
errx(EX_USAGE, "missing speed parameter");
|
||||
if (ioctl(fd, WORMIOCPREPDISK, &d) == -1)
|
||||
err(EX_IOERR, "ioctl(WORMIOCPREPDISK)");
|
||||
}
|
||||
else if (eq(argv[0], "track")) {
|
||||
struct wormio_prepare_track t;
|
||||
bzero(&t, sizeof (t));
|
||||
t.audio = -1;
|
||||
t.preemp = 0;
|
||||
for (i = 1; i < argc; i++) {
|
||||
if (eq(argv[i], "audio"))
|
||||
t.audio = 1;
|
||||
else if (eq(argv[i], "data")) {
|
||||
t.audio = 0;
|
||||
t.track_type = BLOCK_MODE_1;
|
||||
} else if (eq(argv[i], "preemp"))
|
||||
t.preemp = 1;
|
||||
else
|
||||
errx(EX_USAGE,
|
||||
"wrong param for \"track\": %s",
|
||||
argv[i]);
|
||||
}
|
||||
if (t.audio == -1)
|
||||
errx(EX_USAGE, "missing track type parameter");
|
||||
if (t.audio == 0 && t.preemp == 1)
|
||||
errx(EX_USAGE, "\"preemp\" attempted on data track");
|
||||
if (ioctl(fd, WORMIOCPREPTRACK, &t) == -1)
|
||||
err(EX_IOERR, "ioctl(WORMIOCPREPTRACK)");
|
||||
}
|
||||
else if (eq(argv[0], "fixate")) {
|
||||
struct wormio_fixation f;
|
||||
f.toc_type = -1;
|
||||
f.onp = 0;
|
||||
for (i = 1; i < argc; i++) {
|
||||
if (eq(argv[i], "onp"))
|
||||
f.onp = 1;
|
||||
else if (argv[i][0] >= '0' && argv[i][0] <= '4' &&
|
||||
argv[i][1] == '\0')
|
||||
f.toc_type = argv[i][0] - '0';
|
||||
else
|
||||
errx(EX_USAGE,
|
||||
"wrong param for \"fixate\": %s",
|
||||
argv[i]);
|
||||
}
|
||||
if (f.toc_type == -1)
|
||||
errx(EX_USAGE, "missing TOC type parameter");
|
||||
if (ioctl(fd, WORMIOCFIXATION, &f) == -1)
|
||||
err(EX_IOERR, "ioctl(WORMIOFIXATION)");
|
||||
}
|
||||
else if (eq(argv[0], "blank")) {
|
||||
if (ioctl(fd, CDRIOCBLANK) == -1)
|
||||
err(EX_IOERR, "ioctl(CDRIOCBLANK)");
|
||||
}
|
||||
else if (eq(argv[0], "nextwriteable")) {
|
||||
int addr;
|
||||
if (ioctl(fd, CDRIOCNEXTWRITEABLEADDR, &addr) == -1)
|
||||
err(EX_IOERR, "ioctl(CDRIOCNEXTWRITEABLEADDR)");
|
||||
printf("%d\n", addr);
|
||||
}
|
||||
else
|
||||
errx(EX_USAGE, "unknown command: %s", argv[0]);
|
||||
|
||||
return EX_OK;
|
||||
}
|
||||
Loading…
x
Reference in New Issue
Block a user