Add a missing initbufbio() to fix a panic when vinum tries to issue a
[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 .\" $DragonFly: src/share/man/man4/Attic/worm.4,v 1.3 2006/02/17 19:37:09 swildner Exp $
37 .\" "
38 .Dd October 15, 1998
39 .Dt WORM 4
40 .Os
41 .Sh NAME
42 .Nm worm
43 .Nd write-once (CD-R) disk driver
44 .Sh SYNOPSIS
45 None.
46 .Sh DESCRIPTION
47 The
48 .Nm
49 driver was provided under
50 .Fx
51 releases prior to
52 .Fx 3.0 .
53 .Pp
54 The
55 .Fx
56 .Tn SCSI
57 layer was replaced for
58 .Fx 3.0
59 by a CAM-compliant
60 .Tn SCSI
61 layer.  The new
62 .Tn SCSI
63 layer doesn't include a
64 .Xr worm 4
65 driver, and isn't likely to include one in the future.  Future in-kernel
66 support for CD-R/CD-RW/DVD drives will likely be implemented through the
67 .Xr cd 4
68 driver.  Users who wish
69 to write CDs on a WORM, CD-R, or CD-RW drive
70 should use
71 .Nm cdrtools ,
72 which is in the
73 .Fx
74 ports collection.
75 .Pp
76 The
77 .Xr cd 4
78 driver provides read-only access to CD, CD-R, and CD-RW drives, as well as
79 WORM drives that support the CDROM command set.  Therefore, users wishing
80 to mount CDs in a WORM drive should use the
81 .Xr cd 4
82 driver instead.
83 .Sh SEE ALSO
84 .Xr close 2 ,
85 .Xr ioctl 2 ,
86 .Xr open 2 ,
87 .Xr write 2 ,
88 .Xr cd 4 ,
89 .Xr pass 4 ,
90 .Xr xpt 4
91 .Sh HISTORY
92 The
93 .Nm
94 driver appeared in
95 .Fx 2.1 ,
96 and disappeared in
97 .Fx 3.0
98 with the advent of the CAM
99 .Tn SCSI
100 layer.
101 .Sh AUTHORS
102 .An -nosplit
103 The first skeleton for a
104 .Nm
105 driver has been written by
106 .An Peter Dufault
107 in May, 1995.  The driver has
108 then been improved and made actually usable at all by
109 .An J\(:org Wunsch
110 in January, 1996.