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 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
  39 The
  40 .Nm
  41 driver provides support for Mass Storage devices that attach to the USB
  42 port.
  43 Supported are:
  44 .Pp
  45 .Bl -item -compact
  46 .It
  47 IBM 256MB USB Drive(MSYSTEM DiskOnKey2)
  48 .It
  49 Iomega USB Zip 100 drive
  50 .It
  51 Iomega USB Zip 250 drive
  52 .It
  53 Logitec LDR-H443U2 DVD-RAM/-R/+R/-RW/+RW Drive
  54 .It
  55 Microtech International, Inc.\& USB-SCSI-HD 50 USB to SCSI cable
  56 .It
  57 Panasonic ("Matshita FDD CF-VFDU03")
  58 .It
  59 Panasonic KXL-CB20AN Portable DVD-ROM/CD-R/RW
  60 .It
  61 Panasonic KXL-CB35AN(DVD-ROM & CD-R/RW)
  62 .It
  63 Trek Thumbdrive 8MB
  64 .It
  65 VAIO floppy drive (includes Y-E Data Flashbuster-U)
  66 .El
  67 .Pp
  68 The driver also supports some USB adapters for removable media.
  69 Among the supported models are:
  70 .Pp
  71 .Bl -item -compact
  72 .It
  73 PNY Attache Flash Drive
  74 .It
  75 SanDisk SDDR-31 (Compact Flash)
  76 .It
  77 SanDisk SDDR-75 (only Compact Flash port works)
  78 .It
  79 Sitecom CN-300 MultiFlash (MMC/SD, SmartMedia, CF, MemoryStick)
  80 .El
  81 .Pp
  82 Among the supported digital cameras are:
  83 .Pp
  84 .Bl -item -compact
  85 .It
  86 Asahi Optical (PENTAX) Optio 230 & 330
  87 .El
  88 .Pp
  89 .Xr usb 4
  90 and one of
  91 .Xr uhci 4
  92 or
  93 .Xr ohci 4
  94 must be configured in the kernel as well.
  95 Last but not least, support for
  96 SCSI drives,
  97 .Xr da 4 .
  98 .Sh EXAMPLES
  99 .Bd -literal -offset indent
 100 device umass
 101 device scbus
 102 device da
 103 device pass
 104 .Ed
 105 .Pp
 106 Add the
 107 .Nm
 108 driver to the kernel.
 109 .Pp
 110 .Dl "camcontrol rescan 0"
 111 .Pp
 112 Rescan a Zip drive that was added after boot.
 113 The command above
 114 assumes that the Zip drive is on the first SCSI bus in the system.
 115 .Bd -literal -offset indent
 116 camcontrol rescan 0:0:0
 117 camcontrol rescan 0:0:1
 118 camcontrol rescan 0:0:2
 119 camcontrol rescan 0:0:3
 120 .Ed
 121 .Pp
 122 Rescan all slots on a multi-slot flash reader, where the slots map to separate
 123 LUNs on a single SCSI ID.
 124 Typically only the first slot will be enabled at boot time.
 125 Again, this assumes that the flash reader is the first SCSI bus in the system.
 126 .Bd -literal -offset indent
 127 bsdlabel -w da0 zip100
 128 newfs da0c
 129 mount -t ufs /dev/da0c /mnt
 130 .Ed
 131 .Pp
 132 Write a disklabel to the Zip drive (see
 133 .Xr vpo 4
 134 for the
 135 .Xr disktab 5
 136 entry), creates the file system and mounts the new file system on /mnt.
 137 .Pp
 138 .Dl "newfs_msdos /dev/da0"
 139 .Pp
 140 Create a new FAT type file system.
 141 Care should be taken not to run
 142 .Xr newfs 8
 143 on devices that already contain data, as this will result in the
 144 information being lost.
 145 .Pp
 146 Many consumer devices such as digital cameras automatically create
 147 .Tn MS-DOS
 148 based file systems when storing information such as images and
 149 videos.
 150 These file systems can be accessed by specifying the file system
 151 type as
 152 .Cm msdos
 153 when 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
 166 The
 167 .Nm
 168 driver was written by
 169 .An MAEKAWA Masahide Aq bishop@rr.iij4u.or.jp
 170 and
 171 .An Nick Hibma Aq n_hibma@FreeBSD.org .
 172 .Pp
 173 This manual page was written by
 174 .An Nick Hibma Aq n_hibma@FreeBSD.org .