xref: /freebsd/share/man/man4/umass.4 (revision 6fd05b64b5b65dd4ba9b86482a0634a5f0b96c29)
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. Neither the name of the author nor the names of any co-contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"   without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY NICK HIBMA AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL NICK HIBMA OR THE VOICES IN HIS HEAD
20.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
26.\" THE POSSIBILITY OF SUCH DAMAGE.
27.\"
28.\"	$FreeBSD$
29.\"
30.Dd February 10, 2004
31.Dt UMASS 4
32.Os
33.Sh NAME
34.Nm umass
35.Nd USB Mass Storage Devices driver
36.Sh SYNOPSIS
37.Cd "device umass"
38.Sh DESCRIPTION
39The
40.Nm
41driver provides support for Mass Storage devices that attach to the USB
42port.
43Supported are:
44.Pp
45.Bl -item -compact
46.It
47IBM 256MB USB Drive(MSYSTEM DiskOnKey2)
48.It
49Iomega USB Zip 100 drive
50.It
51Iomega USB Zip 250 drive
52.It
53Logitec LDR-H443U2 DVD-RAM/-R/+R/-RW/+RW Drive
54.It
55Microtech International, Inc.\& USB-SCSI-HD 50 USB to SCSI cable
56.It
57Panasonic ("Matshita FDD CF-VFDU03")
58.It
59Panasonic KXL-CB20AN Portable DVD-ROM/CD-R/RW
60.It
61Panasonic KXL-CB35AN(DVD-ROM & CD-R/RW)
62.It
63Trek Thumbdrive 8MB
64.It
65VAIO floppy drive (includes Y-E Data Flashbuster-U)
66.El
67.Pp
68The driver also supports some USB adapters for removable media.
69Among the supported models are:
70.Pp
71.Bl -item -compact
72.It
73PNY Attache Flash Drive
74.It
75SanDisk SDDR-31 (Compact Flash)
76.It
77SanDisk SDDR-75 (only Compact Flash port works)
78.It
79Sitecom CN-300 MultiFlash (MMC/SD, SmartMedia, CF, MemoryStick)
80.El
81.Pp
82Among the supported digital cameras are:
83.Pp
84.Bl -item -compact
85.It
86Asahi Optical (PENTAX) Optio 230 & 330
87.El
88.Pp
89.Xr usb 4
90and one of
91.Xr uhci 4
92or
93.Xr ohci 4
94must be configured in the kernel as well.
95Last but not least, support for
96SCSI drives,
97.Xr da 4 .
98.Sh EXAMPLES
99.Bd -literal -offset indent
100device umass
101device scbus
102device da
103device pass
104.Ed
105.Pp
106Add the
107.Nm
108driver to the kernel.
109.Pp
110.Dl "camcontrol rescan 0"
111.Pp
112Rescan a Zip drive that was added after boot.
113The command above
114assumes that the Zip drive is on the first SCSI bus in the system.
115.Bd -literal -offset indent
116camcontrol rescan 0:0:0
117camcontrol rescan 0:0:1
118camcontrol rescan 0:0:2
119camcontrol rescan 0:0:3
120.Ed
121.Pp
122Rescan all slots on a multi-slot flash reader, where the slots map to separate
123LUNs on a single SCSI ID.
124Typically only the first slot will be enabled at boot time.
125Again, this assumes that the flash reader is the first SCSI bus in the system.
126.Bd -literal -offset indent
127bsdlabel -w da0 zip100
128newfs da0c
129mount -t ufs /dev/da0c /mnt
130.Ed
131.Pp
132Write a disklabel to the Zip drive (see
133.Xr vpo 4
134for the
135.Xr disktab 5
136entry), creates the file system and mounts the new file system on /mnt.
137.Pp
138.Dl "newfs_msdos /dev/da0"
139.Pp
140Create a new FAT type file system.
141Care should be taken not to run
142.Xr newfs 8
143on devices that already contain data, as this will result in the
144information being lost.
145.Pp
146Many consumer devices such as digital cameras automatically create
147.Tn MS-DOS
148based file systems when storing information such as images and
149videos.
150These file systems can be accessed by specifying the file system
151type as
152.Cm msdos
153when using
154.Xr mount 8 .
155.Sh SEE ALSO
156.Xr ohci 4 ,
157.Xr uhci 4 ,
158.Xr usb 4 ,
159.Xr vpo 4 ,
160.Xr disktab 5 ,
161.Xr bsdlabel 8 ,
162.Xr camcontrol 8
163.\".Sh HISTORY
164.Sh AUTHORS
165.An -nosplit
166The
167.Nm
168driver was written by
169.An MAEKAWA Masahide Aq bishop@rr.iij4u.or.jp
170and
171.An Nick Hibma Aq n_hibma@FreeBSD.org .
172.Pp
173This manual page was written by
174.An Nick Hibma Aq n_hibma@FreeBSD.org .
175