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. 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 December 17, 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
  39 The
  40 .Nm
  41 driver provides support for Mass Storage devices that attach to the USB
  42 port.
  43 .Pp
  44 To use the
  45 .Nm
  46 driver,
  47 .Xr usb 4
  48 and one of
  49 .Xr uhci 4
  50 or
  51 .Xr ohci 4
  52 must be configured in the kernel.
  53 Additionally, since
  54 .Nm
  55 uses the SCSI subsystem and sometimes acts as a SCSI device, it
  56 requires
  57 .Xr da 4
  58 and
  59 .Xr scbus 4
  60 to be included in the kernel.
  61 .Sh HARDWARE
  62 The
  63 .Nm
  64 driver supports USB Mass Storage devices, including:
  65 .Pp
  66 .Bl -bullet -compact
  67 .It
  68 ADTEC Stick Drive AD-UST32M, 64M, 128M, 256M
  69 .It
  70 Denno FireWire/USB2 Removable 2.5-inch HDD Case MIFU-25CB20
  71 .It
  72 FujiFilm Zip USB Drive ZDR100 USB A
  73 .It
  74 GREEN HOUSE USB Flash Memory "PicoDrive" GH-UFD32M, 64M, 128M
  75 .It
  76 IBM 32MB USB Memory Key (P/N 22P5296)
  77 .It
  78 IBM 256MB USB Drive (MSYSTEM DiskOnKey2)
  79 .It
  80 IBM ThinkPad USB Portable CD-ROM Drive (P/N 33L5151)
  81 .It
  82 I-O DATA USB CD/CD-R/CD-RW/DVD-R/DVD-RW/DVD-RAM/DVD-ROM Drive DVR-iUH2 (CDROM, DVD-RAM only)
  83 .It
  84 I-O DATA USB x6 CD-RW Drive CDRW-i64/USB (CDROM only)
  85 .It
  86 I-O DATA USB/IEEE1394 Portable HD Drive HDP-i30P/CI, HDP-i40P/CI
  87 .It
  88 Iomega USB Zip 100/250 drive
  89 .It
  90 Iomega Zip750 USB2.0 drive
  91 .It
  92 Keian USB1.1/2.0 3.5-inch HDD Case KU350A
  93 .It
  94 Kurouto Shikou USB 2.5-inch HDD Case GAWAP2.5PS-USB2.0
  95 .It
  96 LaCie P3 HardDrive USB 200GB
  97 .It
  98 Logitec LDR-H443U2 DVD-RAM/-R/+R/-RW/+RW drive
  99 .It
 100 Logitec Mobile USB Memory LMC-256UD
 101 .It
 102 Logitec USB1.1/2.0 HDD Unit SHD-E60U2
 103 .It
 104 Logitec USB Double-Speed Floppy Drive LFD-31U2
 105 .It
 106 Logitec USB/IEEE1394 DVD-RAM/R/RW Unit LDR-N21FU2 (CDROM only)
 107 .It
 108 MELCO USB Flash Disk "ClipDrive", RUF-C32M, -C64M, -C128M, -C256M, -C512M
 109 .It
 110 MELCO USB Flash Disk "PetitDrive", RUF-32M, -64M, -128M, -256Mm
 111 .It
 112 MELCO USB2.0 Flash Disk "PetitDrive2", RUF-256M/U2, -512M/U2
 113 .It
 114 MELCO USB2.0 MO Drive MO-CH640U2
 115 .It
 116 Matshita CF-VFDU03 floppy drive
 117 .It
 118 Microtech International, Inc.\& USB-SCSI-HD 50 USB to SCSI cable
 119 .It
 120 NOVAC USB2.0 2.5/3.5-inch HDD Case NV-HD351U
 121 .It
 122 PNY Attache Flash Drive
 123 .It
 124 Panasonic ("Matshita FDD CF-VFDU03")
 125 .It
 126 Panasonic KXL-CB20AN Portable DVD-ROM/CD-R/RW
 127 .It
 128 Panasonic KXL-CB35AN (DVD-ROM & CD-R/RW)
 129 .It
 130 Panasonic USB2.0 Portable CD-RW Drive KXL-RW40AN (CDROM only)
 131 .It
 132 Panasonic floppy drive
 133 .It
 134 RATOC Systems USB2.0 Removable HDD Case U2-MDK1, U2-MDK1B
 135 .It
 136 SanDisk SDDR-31 (Compact Flash)
 137 .It
 138 SanDisk SDDR-75 (only Compact Flash port works)
 139 .It
 140 Sitecom CN-300 MultiFlash (MMC/SD, SmartMedia, CF, MemoryStick)
 141 .It
 142 Sony Portable CD-R/RW Drive CRX10U (CDROM only)
 143 .It
 144 TEAC Portable USB CD-ROM Unit CD-110PU/210PU
 145 .It
 146 Trek Thumbdrive 8MB
 147 .It
 148 VAIO floppy drive (includes Y-E Data Flashbuster-U)
 149 .It
 150 Y-E Data floppy drive (720/1.44/2.88Mb)
 151 .El
 152 .Pp
 153 Among the supported digital cameras are:
 154 .Pp
 155 .Bl -bullet -compact
 156 .It
 157 Asahi Optical (PENTAX) Optio 230 & 330
 158 .El
 159 .Sh EXAMPLES
 160 .Bd -literal -offset indent
 161 device umass
 162 device scbus
 163 device da
 164 device pass
 165 .Ed
 166 .Pp
 167 Add the
 168 .Nm
 169 driver to the kernel.
 170 .Pp
 171 .Dl "camcontrol rescan 0"
 172 .Pp
 173 Rescan a Zip drive that was added after boot.
 174 The command above
 175 assumes that the Zip drive is on the first SCSI bus in the system.
 176 .Bd -literal -offset indent
 177 camcontrol rescan 0:0:0
 178 camcontrol rescan 0:0:1
 179 camcontrol rescan 0:0:2
 180 camcontrol rescan 0:0:3
 181 .Ed
 182 .Pp
 183 Rescan all slots on a multi-slot flash reader, where the slots map to separate
 184 LUNs on a single SCSI ID.
 185 Typically only the first slot will be enabled at boot time.
 186 Again, this assumes that the flash reader is the first SCSI bus in the system.
 187 .Bd -literal -offset indent
 188 bsdlabel -w da0 zip100
 189 newfs da0c
 190 mount -t ufs /dev/da0c /mnt
 191 .Ed
 192 .Pp
 193 Write a disklabel to the Zip drive (see
 194 .Xr vpo 4
 195 for the
 196 .Xr disktab 5
 197 entry), creates the file system and mounts the new file system on /mnt.
 198 .Pp
 199 .Dl "newfs_msdos /dev/da0"
 200 .Pp
 201 Create a new FAT type file system.
 202 Care should be taken not to run
 203 .Xr newfs 8
 204 on devices that already contain data, as this will result in the
 205 information being lost.
 206 .Pp
 207 Many consumer devices such as digital cameras automatically create
 208 .Tn MS-DOS
 209 based file systems when storing information such as images and
 210 videos.
 211 These file systems can be accessed by specifying the file system
 212 type as
 213 .Cm msdos
 214 when using
 215 .Xr mount 8 .
 216 .Sh SEE ALSO
 217 .Xr ehci 4 ,
 218 .Xr ohci 4 ,
 219 .Xr uhci 4 ,
 220 .Xr usb 4 ,
 221 .Xr vpo 4 ,
 222 .Xr disktab 5 ,
 223 .Xr bsdlabel 8 ,
 224 .Xr camcontrol 8
 225 .\".Sh HISTORY
 226 .Sh AUTHORS
 227 .An -nosplit
 228 The
 229 .Nm
 230 driver was written by
 231 .An MAEKAWA Masahide Aq bishop@rr.iij4u.or.jp
 232 and
 233 .An Nick Hibma Aq n_hibma@FreeBSD.org .
 234 .Pp
 235 This manual page was written by
 236 .An Nick Hibma Aq n_hibma@FreeBSD.org .