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
.Sh NAME
.Nm worm
.Nd write-once (CD-R) disk driver
.Sh SYNOPSIS
None.
.Sh DESCRIPTION
The
.Nm
driver was provided under
.Fx
releases prior to
.Fx 3.0 .
.Pp
The
.Fx
.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
.Nm
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 cdrtools ,
which is in the
.Fx
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
.An -nosplit
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
.An J\(:org 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.
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
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>`
			`.\"`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`.\" 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`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00			`.Os`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.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`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 18:41:33 +00:00			`.Nm`
Use Fx macro wherever possible. 2000-11-14 11:20:58 +00:00			`driver was provided under`
			`.Fx`
			`releases prior to`
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 3.0 .`
This time add the real man pages for "pt" and "worm". 1995-03-04 20:56:39 +00:00			`.Pp`
Use Fx macro wherever possible. 2000-11-14 11:20:58 +00:00			`The`
			`.Fx`
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			`.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`
mdoc(7) police: Deal with self-xrefs. 2002-12-24 13:41:48 +00:00			`.Nm`
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, 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`
cdrecord is now called cdrtools Submitted by: stuart nichols <unstable@stac.state.tx.us> 2001-08-17 06:42:31 +00:00			`.Nm cdrtools ,`
Use Fx macro wherever possible. 2000-11-14 11:20:58 +00:00			`which is in the`
			`.Fx`
			`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`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +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 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`
mdoc(7) police: do not split author names in the AUTHORS section. 2000-11-22 09:35:58 +00:00			`.An -nosplit`
Totally revamp the man page. (Gack, i didn't even know Peter had already written one. :) 1996-01-27 17:55:54 +00:00			`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`
Avoid use of direct troff requests in mdoc(7) manual pages. 2000-11-10 17:46:15 +00:00			`.An J\(:org 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.`