share/man/man7d/cmdk.7d

   1 '\" te
   2 .\"  Copyright (c) 2008, 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 CMDK 7D "Nov 4, 2008"
   7 .SH NAME
   8 cmdk \- common disk driver
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 cmdk@\fItarget\fR, \fIlun\fR : [ \fIpartition\fR \fB|\fR \fIslice\fR ]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBcmdk\fR device driver is a common interface to various disk devices. The
  19 driver supports magnetic fixed disks and magnetic removable disks.
  20 .sp
  21 .LP
  22 The \fBcmdk\fR device driver supports three different disk labels: fdisk
  23 partition table, Solaris x86 VTOC and EFI/GPT.
  24 .sp
  25 .LP
  26 The block-files access the disk using the system's normal buffering mechanism
  27 and are read and written without regard to physical disk records. There is also
  28 a "raw" interface that provides for direct transmission between the disk and
  29 the user's read or write buffer. A single read or write call usually results in
  30 one I/O operation; raw I/O is therefore considerably more efficient when many
  31 bytes are transmitted. The names of the block files are found in
  32 \fB/dev/dsk\fR. Raw file names are found in \fB/dev/rdsk\fR.
  33 .sp
  34 .LP
  35 I/O requests to the magnetic disk must have an offset and transfer length that
  36 is a multiple of 512 bytes or the driver returns an \fBEINVAL\fR error.
  37 .sp
  38 .LP
  39 Slice 0 is normally used for the root file system on a disk, slice 1 as a
  40 paging area (for example, swap), and slice 2 for backing up the entire fdisk
  41 partition for Solaris software. Other slices may be used for \fBusr\fR file
  42 systems or system reserved area.
  43 .sp
  44 .LP
  45 The fdisk partition 0 is to access the entire disk and is generally used by the
  46 \fBfdisk\fR(8) program.
  47 .SH FILES
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fB/dev/dsk/c\fR\fIn\fR\fBd\fR\fIn\fR[\fBs\fR|\fBp\fR]\fIn\fR\fR
  52 .ad
  53 .RS 26n
  54 block device (IDE)
  55 .RE
  56
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fB/dev/rdsk/c\fR\fIn\fR\fBd\fR\fIn\fR[\fBs\fR|\fBp\fR]\fIn\fR\fR
  61 .ad
  62 .RS 26n
  63 raw device (IDE)
  64 .sp
  65 where:
  66 .sp
  67 .ne 2
  68 .na
  69 \fB\fBc\fR\fIn\fR\fR
  70 .ad
  71 .RS 6n
  72 controller \fIn\fR.
  73 .RE
  74
  75 .sp
  76 .ne 2
  77 .na
  78 \fB\fBd\fR\fIn\fR\fR
  79 .ad
  80 .RS 6n
  81 lun \fIn (0-1)\fR.
  82 .RE
  83
  84 .sp
  85 .ne 2
  86 .na
  87 \fB\fBs\fR\fIn\fR\fR
  88 .ad
  89 .RS 6n
  90 UNIX system slice \fIn (0-15).\fR
  91 .RE
  92
  93 .sp
  94 .ne 2
  95 .na
  96 \fB\fBp\fR\fIn\fR\fR
  97 .ad
  98 .RS 6n
  99 fdisk partition (0-36).
 100 .RE
 101
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB/kernel/drv/cmdk\fR\fR
 108 .ad
 109 .RS 26n
 110 32-bit kernel module.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB/kernel/drv/amd64/cmdk\fR\fR
 117 .ad
 118 .RS 26n
 119 64-bit kernel module.
 120 .RE
 121
 122 .SH ATTRIBUTES
 123 .sp
 124 .LP
 125 See \fBattributes\fR(5) for descriptions of the following attributes:
 126 .sp
 127
 128 .sp
 129 .TS
 130 box;
 131 c | c
 132 l | l .
 133 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 134 _
 135 Architecture    x86
 136 .TE
 137
 138 .SH SEE ALSO
 139 .sp
 140 .LP
 141 \fBfdisk\fR(8), \fBmount\fR(8), \fBlseek\fR(2), \fBread\fR(2),
 142 \fBwrite\fR(2), \fBreaddir\fR(3C), \fBscsi\fR(4), \fBvfstab\fR(4),
 143 \fBattributes\fR(5), \fBdkio\fR(7I)