xref: /illumos-gate/usr/src/man/man4d/blkdev.4d (revision 5d9d9091f564c198a760790b0bfa72c44e17912b)
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 4D
15.Os
16.Sh NAME
17.Nm blkdev
18.Nd generic block device driver
19.Sh DESCRIPTION
20The
21.Nm
22driver supports generic block-oriented devices, such as non-volatile
23memory storage devices.
24It provides a hardware independent layer for such storage devices, allowing them
25to concentrate on the hardware-specific details, while
26.Nm
27takes care of all the other details, such as
28.Xr dkio 4I .
29.Lp
30The
31.Nm
32driver only supports block-oriented, random-access devices.
33It does not support traditional rotational media and does not support
34SCSI commands.
35.Lp
36The most typical use case for
37.Nm
38devices is to be used to host a file system, such as
39.Xr pcfs 4FS
40or
41.Xr zfs 4FS .
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
50Block device minor nodes.
51.It Pa /dev/rdsk/cndnsn
52Raw block device minor nodes.
53.El
54.Lp
55In the above, the following substitutions may occur:
56.Bl -tag -offset indent -width Va
57.It Va cn
58A controller number, typically one for each instance of
59each underlying hardware dependent device driver (there can be multiple
60such drivers in the system.)  Controller numbers are dynamically assigned
61by the system.
62.It Va dn
63Generally, each instance of the underlying hardware will have a
64logical unit number as well.
65.It Va sn
66This is the
67.Em slice
68number, representing a subset of the disk.
69See
70.Xr dkio 4I .
71.El
72.
73.Sh SEE ALSO
74.Xr rmformat 1 ,
75.Xr sd 4D ,
76.Xr pcfs 4FS ,
77.Xr zfs 4FS ,
78.Xr dkio 4I ,
79.Xr devinfo 8 ,
80.Xr fdisk 8 ,
81.Xr mount 8 ,
82.Xr umount 8
83