Initial import from FreeBSD RELENG_4:
[dragonfly.git] / share / man / man4 / worm.4
1 .\"
2 .\" Copyright (C) 1996
3 .\"   interface business GmbH
4 .\"   Tolkewitzer Strasse 49
5 .\"   D-01277 Dresden
6 .\"   F.R. Germany
7 .\"
8 .\" All rights reserved.
9 .\"
10 .\" Written by Joerg Wunsch <joerg_wunsch@interface-business.de>
11 .\"
12 .\"
13 .\" Redistribution and use in source and binary forms, with or without
14 .\" modification, are permitted provided that the following conditions
15 .\" are met:
16 .\" 1. Redistributions of source code must retain the above copyright
17 .\"    notice, this list of conditions and the following disclaimer.
18 .\" 2. Redistributions in binary form must reproduce the above copyright
19 .\"    notice, this list of conditions and the following disclaimer in the
20 .\"    documentation and/or other materials provided with the distribution.
21 .\"
22 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY
23 .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE
26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
28 .\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
29 .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
30 .\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
32 .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
33 .\" DAMAGE.
34 .\"
35 .\" $FreeBSD: src/share/man/man4/worm.4,v 1.18.2.4 2001/08/31 08:02:58 kris Exp $
36 .\" "
37 .Dd October 15, 1998
38 .Dt WORM 4
39 .Os
40 .Sh NAME
41 .Nm worm
42 .Nd write-once (CD-R) disk driver
43 .Sh SYNOPSIS
44 None.
45 .Sh DESCRIPTION
46 The
47 .Nm
48 driver was provided under
49 .Fx
50 releases prior to
51 .Fx 3.0 .
52 .Pp
53 The
54 .Fx
55 .Tn SCSI
56 layer was replaced for
57 .Fx 3.0
58 by a CAM-compliant
59 .Tn SCSI
60 layer.  The new
61 .Tn SCSI
62 layer doesn't include a
63 .Xr worm 4
64 driver, and isn't likely to include one in the future.  Future in-kernel
65 support for CD-R/CD-RW/DVD drives will likely be implemented through the
66 .Xr cd 4
67 driver.  Users who wish
68 to write CDs on a WORM, CD-R, or CD-RW drive
69 should use
70 .Nm cdrtools ,
71 which is in the
72 .Fx
73 ports collection.
74 .Pp
75 The
76 .Xr cd 4
77 driver provides read-only access to CD, CD-R, and CD-RW drives, as well as
78 WORM drives that support the CDROM command set.  Therefore, users wishing
79 to mount CDs in a WORM drive should use the
80 .Xr cd 4
81 driver instead.
82 .Sh SEE ALSO
83 .Xr close 2 ,
84 .Xr ioctl 2 ,
85 .Xr open 2 ,
86 .Xr write 2 ,
87 .Xr cd 4 ,
88 .Xr pass 4 ,
89 .Xr xpt 4
90 .Sh AUTHORS
91 .An -nosplit
92 The first skeleton for a
93 .Nm
94 driver has been written by
95 .An Peter Dufault
96 in May, 1995.  The driver has
97 then been improved and made actually usable at all by
98 .An J\(:org Wunsch
99 in January, 1996.
100 .Sh HISTORY
101 The
102 .Nm
103 driver appeared in
104 .Fx 2.1 ,
105 and disappeared in
106 .Fx 3.0
107 with the advent of the CAM
108 .Tn SCSI
109 layer.