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 .\"     $DragonFly: src/share/man/man4/umass.4,v 1.2 2003/06/17 04:36:59 dillon Exp $
  33 .\"
  34 .Dd May 3, 1999
  35 .Dt UMASS 4
  36 .Os
  37 .Sh NAME
  38 .Nm umass
  39 .Nd USB Mass Storage Devices driver
  40 .Sh SYNOPSIS
  41 .Cd "device umass"
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver provides support for Mass Storage devices that attach to the USB
  46 port.
  47 Supported are
  48 .Pp
  49 .Bl -tag -compact -width xxxxxx
  50 .It Iomega USB Zip 100 drive
  51 .It Iomega USB Zip 250 drive
  52 .It Microtech International, Inc. USB-SCSI-HD 50 USB to SCSI cable.
  53 .It Panasonic ("Matshita FDD CF-VFDU03")
  54 .It Trek Thumbdrive 8MB
  55 .It VAIO floppy drive (includes Y-E Data Flashbuster-U)
  56 .El
  57 .Pp
  58 The driver also supports some USB adapters for removable media.
  59 Among the supported models are:
  60 .Pp
  61 .Bl -tag -compact -width xxxxxx
  62 .It SanDisk SDDR-31 (Compact Flash)
  63 .It SanDisk SDDR-75 (only Compact Flash port works)
  64 .It Sitecom CN-300 MultiFlash (MMC/SD, SmartMedia, CF, MemoryStick)
  65 .El
  66 .Pp
  67 .Nm usb
  68 and one of
  69 .Nm uhci
  70 or
  71 .Nm ohci
  72 must be configured in the kernel as well.
  73 Last but not least, support for
  74 SCSI drives,
  75 .Nm da
  76 .Sh EXAMPLES
  77 .Dl device umass
  78 .Dl device scbus
  79 .Dl device da
  80 .Dl device pass
  81 .Pp
  82 Add the
  83 .Nm
  84 driver to the kernel.
  85 .Pp
  86 .Dl camcontrol rescan 0
  87 .Pp
  88 Rescan a Zip drive that was added after boot.
  89 The command above
  90 assumes that the Zip drive is the first SCSI bus in the system.
  91 .Pp
  92 .Dl camcontrol rescan 0:0:0
  93 .Dl camcontrol rescan 0:0:1
  94 .Dl camcontrol rescan 0:0:2
  95 .Dl camcontrol rescan 0:0:3
  96 .Pp
  97 Rescan all slots on a multi-slot flash reader, where the slots map to separate
  98 LUNs on a single SCSI ID.  Typically only the first slot will be enabled at
  99 boot time.  Again, this assumes that the flash reader is the first SCSI bus in
 100 the system.
 101 .Pp
 102 .Dl disklabel -w -r da0 zip100
 103 .Dl newfs da0c
 104 .Dl mount -t ufs /dev/da0c /mnt
 105 .Pp
 106 Write a disklabel to the Zip drive (see
 107 .Nm vpo
 108 for the
 109 .Nm disktab
 110 entry), creates the filesystem and mounts the new filesystem on /mnt.
 111 .Pp
 112 .Dl newfs_msdos /dev/da0
 113 .Pp
 114 Create a new FAT type filesystem.
 115 .Sh SEE ALSO
 116 .Xr ohci 4 ,
 117 .Xr uhci 4 ,
 118 .Xr usb 4 ,
 119 .Xr vpo 4 ,
 120 .Xr disktab 5 ,
 121 .Xr camcontrol 8 ,
 122 .Xr disklabel 8
 123 .\".Sh HISTORY
 124 .Sh AUTHORS
 125 .An -nosplit
 126 The
 127 .Nm
 128 driver was written by
 129 .An MAEKAWA Masahide Aq bishop@rr.iij4u.or.jp
 130 and
 131 .An Nick Hibma Aq n_hibma@FreeBSD.org .
 132 .Pp
 133 This manual page was written by
 134 .An Nick Hibma Aq n_hibma@FreeBSD.org .