Merge branch 'vendor/MDOCML'
[dragonfly.git] / share / man / man4 / umass.4
1 .\" Copyright (c) 1999
2 .\"     Nick Hibma <n_hibma@FreeBSD.org>. All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
11 .\"    documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\"    must display the following acknowledgement:
14 .\"     This product includes software developed by Bill Paul.
15 .\" 4. Neither the name of the author nor the names of any co-contributors
16 .\"    may be used to endorse or promote products derived from this software
17 .\"   without specific prior written permission.
18 .\"
19 .\" THIS SOFTWARE IS PROVIDED BY NICK HIBMA AND CONTRIBUTORS ``AS IS'' AND
20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL NICK HIBMA OR THE VOICES IN HIS HEAD
23 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
29 .\" THE POSSIBILITY OF SUCH DAMAGE.
30 .\"
31 .\"     $FreeBSD: src/share/man/man4/umass.4,v 1.9.2.8 2003/04/12 20:54:33 murray Exp $
32 .\"
33 .Dd May 3, 1999
34 .Dt UMASS 4
35 .Os
36 .Sh NAME
37 .Nm umass
38 .Nd USB Mass Storage Devices driver
39 .Sh SYNOPSIS
40 .Cd "device umass"
41 .Sh DESCRIPTION
42 The
43 .Nm
44 driver provides support for Mass Storage devices that attach to the USB
45 port.
46 Supported are
47 .Pp
48 .Bl -bullet -compact
49 .It
50 Iomega USB Zip 100 drive
51 .It
52 Iomega USB Zip 250 drive
53 .It
54 Microtech International, Inc. USB-SCSI-HD 50 USB to SCSI cable.
55 .It
56 Panasonic ("Matshita FDD CF-VFDU03")
57 .It
58 Trek Thumbdrive 8MB
59 .It
60 VAIO floppy drive (includes Y-E Data Flashbuster-U)
61 .El
62 .Pp
63 The driver also supports some USB adapters for removable media.
64 Among the supported models are:
65 .Pp
66 .Bl -bullet -compact
67 .It
68 SanDisk SDDR-31 (Compact Flash)
69 .It
70 SanDisk SDDR-75 (only Compact Flash port works)
71 .It
72 Sitecom CN-300 MultiFlash (MMC/SD, SmartMedia, CF, MemoryStick)
73 .El
74 .Pp
75 .Nm usb
76 and one of
77 .Nm uhci
78 or
79 .Nm ohci
80 must be configured in the kernel as well.
81 Last but not least, support for
82 SCSI drives,
83 .Nm da
84 .Sh EXAMPLES
85 .Dl device umass
86 .Dl device scbus
87 .Dl device da
88 .Dl device pass
89 .Pp
90 Add the
91 .Nm
92 driver to the kernel.
93 .Pp
94 .Dl camcontrol rescan 0
95 .Pp
96 Rescan a Zip drive that was added after boot.
97 The command above
98 assumes that the Zip drive is the first SCSI bus in the system.
99 .Pp
100 .Dl camcontrol rescan 0:0:0
101 .Dl camcontrol rescan 0:0:1
102 .Dl camcontrol rescan 0:0:2
103 .Dl camcontrol rescan 0:0:3
104 .Pp
105 Rescan all slots on a multi-slot flash reader, where the slots map to separate
106 LUNs on a single SCSI ID.  Typically only the first slot will be enabled at
107 boot time.  Again, this assumes that the flash reader is the first SCSI bus in
108 the system.
109 .Pp
110 .Dl disklabel -w -r da0s0 zip100
111 .Dl newfs da0s0c
112 .Dl mount -t ufs /dev/da0s0c /mnt
113 .Pp
114 Write a disklabel to the Zip drive (see
115 .Nm vpo
116 for the
117 .Nm disktab
118 entry), creates the filesystem and mounts the new filesystem on /mnt.
119 .Pp
120 .Dl newfs_msdos /dev/da0
121 .Pp
122 Create a new FAT type filesystem.
123 .Sh SEE ALSO
124 .Xr ohci 4 ,
125 .Xr uhci 4 ,
126 .Xr usb 4 ,
127 .Xr vpo 4 ,
128 .Xr disktab 5 ,
129 .Xr camcontrol 8 ,
130 .Xr disklabel 8
131 .Sh AUTHORS
132 .An -nosplit
133 The
134 .Nm
135 driver was written by
136 .An MAEKAWA Masahide Aq Mt bishop@rr.iij4u.or.jp
137 and
138 .An Nick Hibma Aq Mt n_hibma@FreeBSD.org .
139 .Pp
140 This manual page was written by
141 .An Nick Hibma Aq Mt n_hibma@FreeBSD.org .