share/man/man7d/blkdev.7d

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  12 .
  13 .Dd "Jul 30, 2014"
  14 .Dt BLKDEV 7D
  15 .Os
  16 .Sh NAME
  17 .Nm blkdev
  18 .Nd generic block device driver
  19 .Sh DESCRIPTION
  20 The
  21 .Nm
  22 driver supports generic block-oriented devices, such as non-volatile
  23 memory storage devices.
  24 It provides a hardware independent layer for such storage devices, allowing them
  25 to concentrate on the hardware-specific details, while
  26 .Nm
  27 takes care of all the other details, such as
  28 .Xr dkio 7I .
  29 .Lp
  30 The
  31 .Nm
  32 driver only supports block-oriented, random-access devices.
  33 It does not support traditional rotational media and does not support
  34 SCSI commands.
  35 .Lp
  36 The most typical use case for
  37 .Nm
  38 devices is to be used to host a file system, such as
  39 .Xr pcfs 7FS
  40 or
  41 .Xr zfs 7FS .
  42 .
  43 .Sh INTERFACE STABILITY
  44 .Sy Uncommitted .
  45 .
  46 .Sh FILES
  47 .
  48 .Bl -tag -compact -width Pa
  49 .It Pa /dev/dsk/cndnsn
  50 Block device minor nodes.
  51 .It Pa /dev/rdsk/cndnsn
  52 Raw block device minor nodes.
  53 .El
  54 .Lp
  55 In the above, the following substitutions may occur:
  56 .Bl -tag -offset indent -width Va
  57 .It Va cn
  58 A controller number, typically one for each instance of
  59 each underlying hardware dependent device driver (there can be multiple
  60 such drivers in the system.)  Controller numbers are dynamically assigned
  61 by the system.
  62 .It Va dn
  63 Generally, each instance of the underlying hardware will have a
  64 logical unit number as well.
  65 .It Va sn
  66 This is the
  67 .Em slice
  68 number, representing a subset of the disk.
  69 See
  70 .Xr dkio 7I .
  71 .El
  72 .
  73 .Sh SEE ALSO
  74 .Xr rmformat 1 ,
  75 .Xr devinfo 8 ,
  76 .Xr fdisk 8 ,
  77 .Xr mount 8 ,
  78 .Xr umount 8 ,
  79 .Xr sd 7D ,
  80 .Xr pcfs 7FS ,
  81 .Xr zfs 7FS ,
  82 .Xr dkio 7I