usr/src/man/man7d/scsa1394.7d

   1 '\" te
   2 .\" Copyright (c) 2005 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH SCSA1394 7D "Mar 2, 2007"
   7 .SH NAME
   8 scsa1394 \- SCSI to 1394 bridge driver
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBunit@GUID\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBscsa1394\fR driver is a 1394 target and an SCSA HBA driver that supports
  19 1394 mass storage devices compliant with the \fISerial Bus Protocol 2
  20 (SBP-2\fR) specification. It supports both bus-powered and self-powered 1394
  21 mass storage devices.
  22 .sp
  23 .LP
  24 The \fBscsa1394\fR nexus driver maps SCSA target driver requests to SBP-2
  25 Operation Request Blocks (\fBORB\fR's).
  26 .sp
  27 .LP
  28 The \fBscsa1394\fR driver creates a child device info node for each logical
  29 unit (LUN) on the mass storage device. The standard Solaris SCSI disk driver is
  30 attached to those nodes. Refer to \fBsd\fR(7D).
  31 .sp
  32 .LP
  33 This driver supports multiple LUN devices and creates a separate child device
  34 info node for each LUN. All child LUN nodes attach to \fBsd\fR(7D).
  35 .sp
  36 .LP
  37 In previous releases, all 1394 mass storage devices were treated as removable
  38 media devices and managed by \fBrmformat\fR(1) and volume management software.
  39 In the current release, however, only mass storage devices with a removable bit
  40 (RMB) value of \fB1\fR are removable. (The RMB is part of the device's SCSI
  41 INQUIRY data.) See SCSI specifications T10/995D Revision 11a, T10/1236-D
  42 Revision 20 or T10/1416-D Revision 23 for more information. However, for
  43 backward compatibility, all 1394 mass storage devices can still be managed by
  44 \fBrmformat\fR(1). With or without a volume  manager,  you can mount, eject,
  45 hot remove and hot insert a  1394 mass storage device as the following sections
  46 explain.
  47 .SH USING VOLUME MANAGEMENT
  48 .sp
  49 .LP
  50 Mass storage devices are managed by a volume manager. Software that manages
  51 removable media creates a device nickname that can be listed with
  52 \fBeject\fR(1) or \fBrmmount\fR(1). A device that is not mounted automatically
  53 can be mounted using \fBrmmount\fR(1) under \fB/rmdisk/\fIlabel\fR\fR. Note
  54 that the \fBmount\fR(1M) and \fBmount\fR(1M) commands do not accept nicknames;
  55 you must use explicit device names with these commands.
  56 .sp
  57 .LP
  58 See \fBrmmount\fR(1) to unmount the device and \fBeject\fR(1) to eject the
  59 media. If the device is ejected while it is mounted, volume management software
  60 unmounts the device before ejecting it. It also might kill any active
  61 applications that are accessing the device.
  62 .sp
  63 .LP
  64 Volume management software is hotplug-aware and normally mounts file systems on
  65 USB mass storage devices if the file system is recognized. Before hot removing
  66 the USB device, use \fBeject\fR(1) to unmount the file system.
  67 .sp
  68 .LP
  69 You can disable the automatic mounting and unmounting of removable devices by
  70 inserting a entry for a removable device in \fB/etc/vfstab\fR. In this entry,
  71 you must set the \fBmount at boot\fR field to \fBno\fR. See \fBvfstab\fR(4).
  72 See the \fISystem Administration Guide, Volume I\fR and \fISolaris Common
  73 Desktop Environment: User's Guide\fR for details on how to manage a removable
  74 device with CDE and Removable Media Manager. See \fBdtfile.1X\fR under CDE for
  75 information on how to use Removable Media Manager.
  76 .SH USING \fBmount\fR AND \fBumount\fR
  77 .sp
  78 .LP
  79 Use \fBmount\fR(1M) to explicitly mount the device and \fBumount\fR(1M) to
  80 unmount the device. Use \fBeject\fR(1) to eject the media. After you have
  81 explicitly mounted a removable device, you cannot use a nickname as an argument
  82 to \fBeject\fR.
  83 .sp
  84 .LP
  85 Removing the storage device while it is being accessed or mounted fails with a
  86 console warning. To hot remove the storage device from the system, unmount the
  87 file system, then kill all applications accessing the device. Next, hot remove
  88 the device. A storage device can be hot inserted at any time.
  89 .sp
  90 .LP
  91 For a comprehensive listing of (non-bootable) 1394 mass-storage devices that
  92 are compatible with this driver, see \fBwww.sun.com/io\fR.
  93 .SH DEVICE SPECIAL FILES
  94 .sp
  95 .LP
  96 Block special file names are located in \fB/dev/dsk\fR. Raw file names are
  97 located in \fB/dev/rdsk\fR. Input/output requests to the devices must follow
  98 the same restrictions as those for SCSI disks. Refer to \fBsd\fR(7D).
  99 .SH IOCTLS
 100 .sp
 101 .LP
 102 Refer to \fBcdio\fR(7I) and \fBdkio\fR(7I).
 103 .SH ERRORS
 104 .sp
 105 .LP
 106 Refer to \fBsd\fR(7D).
 107 .SH FILES
 108 .sp
 109 .LP
 110 The device special files for the 1394 mass storage device are created like
 111 those for a SCSI disk. Refer to \fBsd\fR(7D).
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB/dev/dsk/c\fIn\fRt\fIn\fRd\fIn\fRs\fIn\fR\fR\fR
 116 .ad
 117 .sp .6
 118 .RS 4n
 119 Block files
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB/dev/rdsk/c\fIn\fRt\fIn\fRd\fIn\fRs\fIn\fR\fR\fR
 126 .ad
 127 .sp .6
 128 .RS 4n
 129 Raw files
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB\fB/vol/dev/aliases/rmdisk0\fR\fR
 136 .ad
 137 .sp .6
 138 .RS 4n
 139 Symbolic link to the character device for the media in removable drive 0. This
 140 is a generic removable media device.
 141 .RE
 142
 143 .sp
 144 .ne 2
 145 .na
 146 \fB\fB/kernel/drv/scsa1394\fR\fR
 147 .ad
 148 .sp .6
 149 .RS 4n
 150 32-bit x86 ELF kernel module
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fB/kernel/drv/amd64/scsa1394\fR\fR
 157 .ad
 158 .sp .6
 159 .RS 4n
 160 64-bit x86 ELF kernel module
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fB/kernel/drv/sparcv9/scsa1394\fR\fR
 167 .ad
 168 .sp .6
 169 .RS 4n
 170 64-bit SPARC ELF kernel module
 171 .RE
 172
 173 .SH ATTRIBUTES
 174 .sp
 175 .LP
 176 See \fBattributes\fR(5) for a description of the following attributes:
 177 .sp
 178
 179 .sp
 180 .TS
 181 box;
 182 c | c
 183 l | l .
 184 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 185 _
 186 Architecture    SPARC, x86, PCI-based systems
 187 .TE
 188
 189 .SH SEE ALSO
 190 .sp
 191 .LP
 192 \fBcdrw\fR(1), \fBeject\fR(1), \fBrmformat\fR(1), \fBrmmount\fR(1),
 193 \fBcfgadm_scsi\fR(1M), \fBfdisk\fR(1M), \fBmount\fR(1M), \fBumount\fR(1M),
 194 \fBdtfile.1X\fR (in CDE man pages), \fBscsi\fR(4), \fBvfstab\fR(4),
 195 \fBattributes\fR(5), \fBhci1394\fR(7D), \fBsd\fR(7D), \fBpcfs\fR(7FS),
 196 \fBcdio\fR(7I), \fBdkio\fR(7I)
 197 .sp
 198 .LP
 199 \fIIEEE Std 1394-1995 Standard for a High Performance Serial Bus\fR
 200 .sp
 201 .LP
 202 \fIANSI NCITS 325-1998 - Serial Bus Protocol 2 (SBP-2)\fR
 203 .sp
 204 .LP
 205 \fISystem Administration Guide: Devices and File Systems\fR
 206 .sp
 207 .LP
 208 SCSI Specification \fIT10/995D Revision 11a\fR \(em March 1997
 209 .sp
 210 .LP
 211 SCSI Specification\fIT10/1236-D Revision 20\fR \(em July 2001
 212 .sp
 213 .LP
 214 SCSI Specification\fIT10/1416-D Revision 23\fR\(em May 2005
 215 .sp
 216 .LP
 217 \fISolaris Common Desktop Environment: User's Guide\fR
 218 .sp
 219 .LP
 220 \fIhttp://www.sun.com/io\fR