share/man/man7d/dad.7d

   1 '\" te
   2 .\" Copyright 2004 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 DAD 7D "Oct 24, 2005"
   7 .SH NAME
   8 dad \- driver for IDE disk devices
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdad@\fR \fItarget\fR,\fIlun\fR:\fIpartition\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 This driver handles the ide disk drives on SPARC platforms. The type of disk
  19 drive is determined using the ATA IDE identify device command and by reading
  20 the volume label stored on the drive. The \fBdad\fR device driver supports the
  21 Solaris SPARC VTOC and the EFI/GPT disk volume labels.
  22 .sp
  23 .LP
  24 The block-files access the disk using the system's normal buffering mechanism
  25 and are read and written without  regard to physical disk records. There is
  26 also a "raw" interface that provides for direct transmission between the disk
  27 and the user's read or write buffer.  A single read or write call usually
  28 results in one I/O operation; raw I/O is therefore considerably more efficient
  29 when many bytes are transmitted.  The names of the block files are found in
  30 \fB/dev/dsk\fR. Raw file names are found in  \fB/dev/rdsk\fR.
  31 .sp
  32 .LP
  33 I/O requests to the raw device must be aligned on a 512-byte (\fBDEV_BSIZE\fR)
  34 boundary and must have a length that is a multiple of 512 bytes. Requests that
  35 do not meet the restrictions cause the driver to return an \fBEINVAL\fR error.
  36 I/O requests to the block device have no alignment or length restrictions.
  37 .SS "Device Statistics Support"
  38 .sp
  39 .LP
  40 Each device maintains I/O statistics both for the device and for each partition
  41 allocated on that device. For each device/partition, the driver accumulates
  42 reads, writes, bytes read, and bytes written. The driver also takes
  43 hi-resolution time stamps at queue entry and exit points, which facilitates
  44 monitoring the residence time and cumulative  residence-length product for each
  45 queue.
  46 .sp
  47 .LP
  48 Each device also has error statistics associated with it. These must include
  49 counters for hard errors, soft errors and transport errors. Other data may be
  50 implemented as required.
  51 .SH FILES
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB/dev/dsk/c\fR\fIn\fR\fBt\fR\fIn\fR\fBd\fR\fIn\fR\fBs\fR\fIn\fR \fR
  56 .ad
  57 .RS 23n
  58 block files
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB/dev/rdsk/c\fR\fIn\fR\fBt\fR\fIn\fR\fBd\fR\fIn\fR\fBs\fR\fIn\fR \fR
  65 .ad
  66 .RS 23n
  67 raw files
  68 .RE
  69
  70 .sp
  71 .LP
  72 where:
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fBc\fR\fIn\fR \fR
  77 .ad
  78 .RS 7n
  79 controller  \fIn\fR
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fBt\fR\fIn\fR \fR
  86 .ad
  87 .RS 7n
  88 IDE target id  \fIn\fR (0-3)
  89 .RE
  90
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fBd\fR\fIn\fR \fR
  95 .ad
  96 .RS 7n
  97 Always 0.
  98 .RE
  99
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fBs\fR\fIn\fR \fR
 104 .ad
 105 .RS 7n
 106 partition  \fIn\fR (0-7)
 107 .RE
 108
 109 .sp
 110 .LP
 111 The target ide numbers are assigned as:
 112 .sp
 113 .ne 2
 114 .na
 115 \fB0\fR
 116 .ad
 117 .RS 5n
 118 Master disk on Primary channel.
 119 .RE
 120
 121 .sp
 122 .ne 2
 123 .na
 124 \fB1\fR
 125 .ad
 126 .RS 5n
 127 Slave disk on Primary channel.
 128 .RE
 129
 130 .sp
 131 .ne 2
 132 .na
 133 \fB2\fR
 134 .ad
 135 .RS 5n
 136 Master disk on Secondary channel
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fB3\fR
 143 .ad
 144 .RS 5n
 145 Slave disk on Secondary channel.
 146 .RE
 147
 148 .SH IOCTLS
 149 .sp
 150 .LP
 151 Refer to \fBdkio\fR(7I).
 152 .SH ERRORS
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fBEACCES\fR \fR
 157 .ad
 158 .RS 11n
 159 Permission denied.
 160 .RE
 161
 162 .sp
 163 .ne 2
 164 .na
 165 \fB\fBEBUSY\fR \fR
 166 .ad
 167 .RS 11n
 168 The partition was opened exclusively by another thread.
 169 .RE
 170
 171 .sp
 172 .ne 2
 173 .na
 174 \fB\fBEFAULT\fR \fR
 175 .ad
 176 .RS 11n
 177 Argument was a bad address.
 178 .RE
 179
 180 .sp
 181 .ne 2
 182 .na
 183 \fB\fBEINVAL\fR \fR
 184 .ad
 185 .RS 11n
 186 Invalid argument.
 187 .RE
 188
 189 .sp
 190 .ne 2
 191 .na
 192 \fB\fBEIO\fR \fR
 193 .ad
 194 .RS 11n
 195  I/O error occurred.
 196 .RE
 197
 198 .sp
 199 .ne 2
 200 .na
 201 \fB\fBENOTTY\fR \fR
 202 .ad
 203 .RS 11n
 204 The device does not  support the requested ioctl function.
 205 .RE
 206
 207 .sp
 208 .ne 2
 209 .na
 210 \fB\fBENXIO\fR \fR
 211 .ad
 212 .RS 11n
 213 The device did not exist during opening.
 214 .RE
 215
 216 .sp
 217 .ne 2
 218 .na
 219 \fB\fBEROFS\fR \fR
 220 .ad
 221 .RS 11n
 222 The device is a read-only device.
 223 .RE
 224
 225 .SH SEE ALSO
 226 .sp
 227 .LP
 228 \fBformat\fR(8), \fBmount\fR(8), \fBlseek\fR(2), \fBread\fR(2),
 229 \fBwrite\fR(2), \fBdriver.conf\fR(4), \fBvfstab\fR(4), \fBdkio\fR(7I)
 230 .sp
 231 .LP
 232 X3T10 ATA-4 specifications.
 233 .SH DIAGNOSTICS
 234 .sp
 235 .ne 2
 236 .na
 237 \fB\fBCommand:<\fInumber\fR>\fR, Error:<\fInumber\fR>, Status:<\fInumber\fR>\fR
 238 .ad
 239 .sp .6
 240 .RS 4n
 241 Indicates that the command failed with an error and provides status register
 242 contents. Where <\fInumber\fR> is a hexadecimal value.
 243 .RE
 244
 245 .sp
 246 .ne 2
 247 .na
 248 \fB\fBoffline\fR \fR
 249 .ad
 250 .sp .6
 251 .RS 4n
 252 The driver has decided that the target disk is no longer there.
 253 .RE
 254
 255 .sp
 256 .ne 2
 257 .na
 258 \fB\fBdisk ok\fR \fR
 259 .ad
 260 .sp .6
 261 .RS 4n
 262 The target disk is now responding again.
 263 .RE
 264
 265 .sp
 266 .ne 2
 267 .na
 268 \fB\fBdisk not responding to selection\fR \fR
 269 .ad
 270 .sp .6
 271 .RS 4n
 272 The target disk is not responding.
 273 .RE
 274
 275 .sp
 276 .ne 2
 277 .na
 278 \fB\fBi/o to invalid geometry\fR \fR
 279 .ad
 280 .sp .6
 281 .RS 4n
 282 The geometry of the drive could not be established.
 283 .RE
 284
 285 .sp
 286 .ne 2
 287 .na
 288 \fB\fBincomplete read/write - retrying/giving up\fR \fR
 289 .ad
 290 .sp .6
 291 .RS 4n
 292 There was a residue after the command completed normally.
 293 .RE
 294
 295 .sp
 296 .ne 2
 297 .na
 298 \fB\fBno bp for disk label\fR \fR
 299 .ad
 300 .sp .6
 301 .RS 4n
 302 A bp with consistent memory could not be allocated.
 303 .RE
 304
 305 .sp
 306 .ne 2
 307 .na
 308 \fB\fBno memory for disk label\fR \fR
 309 .ad
 310 .sp .6
 311 .RS 4n
 312 Free memory pool exhausted.
 313 .RE
 314
 315 .sp
 316 .ne 2
 317 .na
 318 \fB\fBATA transport failed: reason 'nnnn': {retrying|giving}\fR \fR
 319 .ad
 320 .sp .6
 321 .RS 4n
 322 The host adapter has failed to transport a command to the target for the reason
 323 stated. The driver will either retry the command or, ultimately, give up.
 324 .RE
 325
 326 .sp
 327 .ne 2
 328 .na
 329 \fB\fBno mem for property\fR \fR
 330 .ad
 331 .sp .6
 332 .RS 4n
 333 Free memory pool exhausted.
 334 .RE
 335
 336 .sp
 337 .ne 2
 338 .na
 339 \fB\fBtransport rejected (<n>)\fR \fR
 340 .ad
 341 .sp .6
 342 .RS 4n
 343 Host adapter driver was unable to accept a command.
 344 .RE
 345
 346 .sp
 347 .ne 2
 348 .na
 349 \fB\fBDevice Fault\fR \fR
 350 .ad
 351 .sp .6
 352 .RS 4n
 353 Device fault - reason for such error is vendor specific.
 354 .RE
 355