freebsd-nq/share/man/man4/worm.4

.\" 
.\" 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$
.\" "
.Dd October 15, 1998
.Dt WORM 4
.Os FreeBSD
.Sh NAME
.Nm worm
.Nd write-once (CD-R) disk driver
.Sh SYNOPSIS
None.
.Sh DESCRIPTION
The
.Nm worm
driver was provided under FreeBSD releases prior to
.Fx 3.0 .
.Pp
The FreeBSD
.Tn SCSI
layer was replaced for
.Fx 3.0
by a CAM-compliant
.Tn SCSI
layer.  The new
.Tn SCSI
layer doesn't include a
.Xr worm 4
driver, and isn't likely to include one in the future.  Future in-kernel
support for CD-R/CD-RW/DVD drives will likely be implemented through the
.Xr cd 4
driver.  Users who wish
to write CDs on a WORM, CD-R, or CD-RW drive
should use
.Nm cdrecord ,
which is in the FreeBSD ports collection.
.Pp
The
.Xr cd 4 
driver provides read-only access to CD, CD-R, and CD-RW drives, as well as
WORM drives that support the CDROM command set.  Therefore, users wishing
to mount CDs in a WORM drive should use the
.Xr cd 4
driver instead.
.Sh SEE ALSO
.Xr close 2 ,
.Xr ioctl 2 ,
.Xr open 2 ,
.Xr write 2 ,
.Xr cd 4 ,
.Xr pass 4 ,
.Xr xpt 4
.Sh AUTHORS
The first skeleton for a
.Nm
driver has been written by
.An Peter Dufault
in May, 1995.  The driver has
then been improved and made actually usable at all by
.ie t J\(:org Wunsch
.el Joerg Wunsch
in January, 1996.
.Sh HISTORY
The
.Nm
driver appeared in
.Fx 2.1 ,
and disappeared in
.Fx 3.0
with the advent of the CAM
.Tn SCSI
layer.
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`.\"`
			`.\" 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.`
			`.\"`
$Id$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00			`.\" $FreeBSD$`
Update the BUGS section, now that we've got some experience in using this driver. 1996-06-23 18:27:12 +00:00			`.\" "`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`.Dd October 15, 1998`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`.Dt WORM 4`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Os FreeBSD`
			`.Sh NAME`
			`.Nm worm`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`.Nd write-once (CD-R) disk driver`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Sh SYNOPSIS`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`None.`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Sh DESCRIPTION`
			`The`
Correct some man page xrefs, and some other minor changes to bring some man pages up to mdoc guidelines and fix some minor formatting glitches. Also fixed a number of man pages to not abuse the .Xr macro to display functions and path names and a lot of other junk. 1996-04-08 04:18:31 +00:00			`.Nm worm`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`driver was provided under FreeBSD releases prior to`
			`.Fx 3.0 .`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Pp`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`The FreeBSD`
			`.Tn SCSI`
			`layer was replaced for`
			`.Fx 3.0`
			`by a CAM-compliant`
			`.Tn SCSI`
			`layer. The new`
			`.Tn SCSI`
			`layer doesn't include a`
			`.Xr worm 4`
			`driver, and isn't likely to include one in the future. Future in-kernel`
			`support for CD-R/CD-RW/DVD drives will likely be implemented through the`
Update the BUGS section, now that we've got some experience in using this driver. 1996-06-23 18:27:12 +00:00			`.Xr cd 4`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`driver. Users who wish`
			`to write CDs on a WORM, CD-R, or CD-RW drive`
			`should use`
			`.Nm cdrecord ,`
			`which is in the FreeBSD ports collection.`
Update the BUGS section, now that we've got some experience in using this driver. 1996-06-23 18:27:12 +00:00			`.Pp`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`The`
			`.Xr cd 4`
			`driver provides read-only access to CD, CD-R, and CD-RW drives, as well as`
			`WORM drives that support the CDROM command set. Therefore, users wishing`
			`to mount CDs in a WORM drive should use the`
			`.Xr cd 4`
			`driver instead.`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Sh SEE ALSO`
Sort cross references. 1996-12-26 16:16:37 +00:00			`.Xr close 2 ,`
			`.Xr ioctl 2 ,`
			`.Xr open 2 ,`
			`.Xr write 2 ,`
Update the BUGS section, now that we've got some experience in using this driver. 1996-06-23 18:27:12 +00:00			`.Xr cd 4 ,`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`.Xr pass 4 ,`
			`.Xr xpt 4`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`.Sh AUTHORS`
			`The first skeleton for a`
			`.Nm`
.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs. Use .An/.Aq. 1998-03-12 07:31:21 +00:00			`driver has been written by`
			`.An Peter Dufault`
			`in May, 1995. The driver has`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`then been improved and made actually usable at all by`
Update the BUGS section, now that we've got some experience in using this driver. 1996-06-23 18:27:12 +00:00			`.ie t J\(:org Wunsch`
			`.el Joerg Wunsch`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`in January, 1996.`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Sh HISTORY`
			`The`
			`.Nm`
Update a bunch of man pages to use the .Fx macro to specify FreeBSD versions. 1996-08-21 22:01:49 +00:00			`driver appeared in`
Change the worm(4) man page to note that there is no longer a worm(4) driver, and point users in the right direction for similar functionality. The functionality that used to be provided there is now provided by the cd(4) driver and cdrecord. Fix cross-references in a few other man pages. (i.e. delete references to things I haven't written yet) 1998-10-16 00:26:28 +00:00			`.Fx 2.1 ,`
			`and disappeared in`
			`.Fx 3.0`
			`with the advent of the CAM`
			`.Tn SCSI`
			`layer.`