Print this page 
11641 spelling mistakes in section 7d of the manual
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man7d/sd.7d
          +++ new/usr/src/man/man7d/sd.7d
   1    1  '\" te
   2    2  .\" Copyright (c) 2009 Sun Microsystems, Inc.  All Rights Reserved.
   3    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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4    4  .\"  See the License for the specific language governing permissions and limitations under the License. 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,
   5    5  .\" with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH SD 7D "May 13, 2017"
        6 +.TH SD 7D "Jan 10, 2020"
   7    7  .SH NAME
   8    8  sd \- SCSI disk and ATAPI/SCSI CD-ROM device driver
   9    9  .SH SYNOPSIS
  10      -.LP
  11   10  .nf
  12   11  \fBsd@target,lun:partition\fR
  13   12  .fi
  14   13  
  15   14  .SH DESCRIPTION
  16      -.LP
  17   15  To open a device without checking if the vtoc is valid, use the O_NDELAY flag.
  18   16  When the device is opened using O_NDELAY, the first read or write to the device
  19   17  that happens after the open results in the label being read if the label is not
  20   18  currently valid. Once read, the label remains valid until the last close of the
  21   19  device. Except for reading the label, O_NDELAY has no impact on the driver.
  22   20  .SS "SPARC"
  23      -.LP
  24   21  The \fBsd\fR \fBSCSI\fR and \fBSCSI/ATAPI\fR driver supports embedded
  25   22  \fBSCSI\fR-2 and \fBCCS\fR-compatible \fBSCSI\fR disk and CD-ROM drives,
  26   23  \fBATAPI \fR 2.6 (SFF-8020i)-compliant CD-ROM drives, SFF-8090-compliant
  27   24  \fBSCSI/ATAPI\fR DVD-ROM drives, IOMEGA \fBSCSI/ATAPI\fR ZIP drives, \fBSCSI
  28   25  JAZ\fR drives, and USB mass storage devices (refer to \fBscsa2usb\fR(7D)).
  29   26  .sp
  30   27  .LP
  31   28  To determine the disk drive type, use the \fBSCSI/ATAPI\fR inquiry command and
  32   29  read the volume label stored on block 0 of the drive. (The volume label
  33   30  describes the disk geometry and partitioning and must be present for the disk
  34   31  to be mounted by the system.) A volume label is not required for removable,
  35   32  re-writable or read-only media.
  36   33  .SS "x86 Only"
  37      -.LP
  38      -The \fBsd\fRdriver supports embedded \fBSCSI\fR-2 and \fBCCS\fR-compatible
       34 +The \fBsd\fR driver supports embedded \fBSCSI\fR-2 and \fBCCS\fR-compatible
  39   35  \fBSCSI \fRdisk and CD-ROM drives, \fBATAPI \fR2.6 (SFF-8020i)-compliant CD-ROM
  40   36  drives, SFF-8090-compliant \fBSCSI/ATAPI\fR DVD-ROM drives, IOMEGA
  41   37  \fBSCSI/ATAPI\fR ZIP drives\fB, and SCSI JAZ\fR drives.
  42   38  .sp
  43   39  .LP
  44   40  The x86 BIOS legacy requires a master boot record (MBR) and \fBfdisk\fR table
  45   41  in the first physical sector of the bootable media. If the x86 hard disk
  46   42  contains a Solaris disk label, it is located in the second 512-byte sector of
  47   43  the FDISK partition.
  48   44  .SH DEVICE SPECIAL FILES
  49      -.LP
  50   45  Block-files access the disk using normal buffering mechanism and are read-from
  51   46  and written-to without regard to physical disk records. A \fBraw\fR interface
  52   47  enables direct transmission between the disk and the user's read or write
  53   48  buffer. A single \fBread\fR or \fBwrite\fR call usually results in a single I/O
  54   49  operation, therefore raw I/O is more efficient when many bytes are transmitted.
  55   50  Block files names are found in \fB/dev/dsk\fR; raw file names are found in
  56   51  \fB/dev/rdsk\fR.
  57   52  .sp
  58   53  .LP
  59   54  I/O requests to the raw device must be aligned on a 512-byte (\fBDEV_BSIZE\fR)
  60   55  boundary and all I/O request lengths must be in multiples of 512 bytes.
  61   56  Requests that do not meet these requirements will trigger an \fBEINVAL\fR
  62   57  error. There are no alignment or length restrictions on I/O requests to the
  63   58  block device.
  64   59  .SH CD-ROM DRIVE SUPPORT
  65      -.LP
  66   60  A CD-ROM disk is single-sided and contains approximately 640 megabytes of data
  67   61  or 74 minutes of audio. When the CD-ROM is opened, the eject button is disabled
  68   62  to prevent manual removal of the disk until the last \fBclose()\fR is called.
  69   63  No volume label is required for a CD-ROM. The disk geometry and partitioning
  70   64  information are constant and never change. If the CD-ROM contains data recorded
  71   65  in a Solaris-aware file system format, it can be mounted using the appropriate
  72   66  Solaris file system support.
  73   67  .SH DVD-ROM DRIVE SUPPORT
  74      -.LP
  75   68  DVD-ROM media can be single or double-sided and can be recorded upon using a
  76   69  single or double layer structure. Double-layer media provides parallel or
  77   70  opposite track paths. A DVD-ROM can hold from between 4.5 Gbytes and 17 Gbytes
  78   71  of data, depending on the layer structure used for recording and if the DVD-ROM
  79   72  is single or double-sided.
  80   73  .sp
  81   74  .LP
  82   75  When the DVD-ROM is opened, the eject button is disabled to prevent the manual
  83   76  removal of a disk until the last \fBclose()\fR is called. No volume label is
  84   77  required for a DVD-ROM. If the DVD-ROM contains data recorded in a
  85   78  Solaris-aware file system format, it can be mounted using the appropriate
  86   79  Solaris file system support.
  87   80  .SH ZIP/JAZ DRIVE SUPPORT
  88      -.LP
  89   81  \fBZIP/JAZ\fR media provide varied data capacity points; a single \fBJAZ
  90   82  \fRdrive can store up to 2 GBytes of data, while a ZIP-250 can store up to
  91   83  250MBytes of data. \fBZIP/JAZ\fR drives can be read-from or written-to using
  92   84  the appropriate drive.
  93   85  .sp
  94   86  .LP
  95   87  When a \fBZIP/JAZ\fR drive is opened, the eject button is disabled to prevent
  96   88  the manual removal of a disk until the last \fBclose()\fR is called. No volume
  97   89  label is required for a \fBZIP/JAZ\fR drive. If the \fBZIP/JAZ\fR drive
  98   90  contains data recorded in a Solaris-aware file system format, it can be mounted
  99   91  using the appropriate Solaris file system support.
 100   92  .SH DEVICE STATISTICS SUPPORT
 101      -.LP
 102   93  Each device maintains I/O statistics for the device and for partitions
 103   94  allocated for that device. For each device/partition, the driver accumulates
 104   95  reads, writes, bytes read, and bytes written. The driver also initiates
 105   96  hi-resolution time stamps at queue entry and exit points to enable monitoring
 106   97  of residence time and cumulative residence-length product for each queue.
 107   98  .sp
 108   99  .LP
 109  100  Not all device drivers make per-partition IO statistics available for
 110  101  reporting. \fBsd\fR and \fBssd\fR(7D) per-partition statistics are enabled by
 111      -default but may disabled in their configuration files.
      102 +default but may be disabled in their configuration files.
 112  103  .SH IOCTLS
 113      -.LP
 114  104  Refer to \fBdkio\fR(7I), and \fBcdio\fR(7I)
 115  105  .SS "ERRORS"
 116  106  .ne 2
 117  107  .na
 118  108  \fB\fBEACCES\fR\fR
 119  109  .ad
 120  110  .RS 10n
 121  111  Permission denied
 122  112  .RE
 123  113
↓ open down ↓ 77 lines elided ↑ open up ↑ 
 201  191  .RS 10n
 202  192  Insufficient memory
 203  193  .RE
 204  194  
 205  195  .sp
 206  196  .ne 2
 207  197  .na
 208  198  \fB\fBEPERM\fR\fR
 209  199  .ad
 210  200  .RS 10n
 211      -Insufficent access permission
      201 +Insufficient access permission
 212  202  .RE
 213  203  
 214  204  .sp
 215  205  .ne 2
 216  206  .na
 217  207  \fB\fBEIO\fR\fR
 218  208  .ad
 219  209  .RS 10n
 220  210  An I/O error occurred. Refer to notes for details on copy-protected DVD-ROM
 221  211  media.
 222  212  .RE
 223  213  
 224  214  .SH CONFIGURATION
 225      -.LP
 226  215  The \fBsd\fR driver can be configured by defining properties in the
 227  216  \fBsd.conf\fR file. The \fBsd\fR driver supports the following properties:
 228  217  .sp
 229  218  .ne 2
 230  219  .na
 231  220  \fB\fBenable-partition-kstats\fR\fR
 232  221  .ad
 233  222  .RS 27n
 234  223  The default value is 1, which causes partition IO statistics to be maintained.
 235  224  Set this value to zero to prevent the driver from recording partition
↓ open down ↓ 205 lines elided ↑ open up ↑ 
 441  430  .sp
 442  431  .ne 2
 443  432  .na
 444  433  \fBpn\fR
 445  434  .ad
 446  435  .RS 6n
 447  436  Where \fIn\fR=0 the node corresponds to the entire disk.
 448  437  .RE
 449  438  
 450  439  .SH SEE ALSO
 451      -.LP
 452  440  \fBsar\fR(1), \fBcfgadm_scsi\fR(1M), \fBfdisk\fR(1M), \fBformat\fR(1M),
 453  441  \fBiostat\fR(1M), \fBclose\fR(2), \fBioctl\fR(2), \fBlseek\fR(2),
 454  442  \fBread\fR(2), \fBwrite\fR(2), \fBdriver.conf\fR(4), \fBscsi\fR(4),
 455  443  \fBfilesystem\fR(5), \fBscsa2usb\fR(7D), \fBssd\fR(7D), \fBhsfs\fR(7FS),
 456  444  \fBpcfs\fR(7FS), \fBudfs\fR(7FS), \fBcdio\fR(7I), \fBdkio\fR(7I),
 457  445  \fBscsi_ifsetcap\fR(9F), \fBscsi_reset\fR(9F)
 458  446  .sp
 459  447  .LP
 460  448  \fIANSI Small Computer System Interface-2 (SCSI-2)\fR
 461  449  .sp
↓ open down ↓ 376 lines elided ↑ open up ↑ 
 838  826  .ne 2
 839  827  .na
 840  828  \fBUnit does not respond to selection\fR
 841  829  .ad
 842  830  .sp .6
 843  831  .RS 4n
 844  832  Drive went offline; probably powered down.
 845  833  .RE
 846  834  
 847  835  .SH NOTES
 848      -.LP
 849  836  DVD-ROM media containing DVD-Video data may follow/adhere to the requirements
 850  837  of content scrambling system or copy protection scheme. Reading of
 851  838  copy-protected sector will cause I/O error. Users are advised to use the
 852  839  appropriate playback software to view video contents on DVD-ROM media
 853  840  containing DVD-Video data.
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX