xref: /titanic_52/usr/src/man/man7d/blkdev.7d (revision 263f549e5da8b32c4922f586afb365b8ae388a6c)
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
20The
21.Nm
22driver supports generic block-oriented devices, such as non-volatile
23memory storage devices. It provides a hardware independent layer
24for such storage devices, allowing them to concentrate on the
25hardware-specific details, while
26.Nm
27takes care of all the other details, such as
28.Xr dkio 7I .
29.Lp
30The
31.Nm
32driver only supports block-oriented, random-access devices.  It does
33not 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 7FS
40or
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
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.  See
69.Xr dkio 7I .
70.El
71.
72.Sh SEE ALSO
73.Xr devinfo 1M ,
74.Xr fdisk 1M ,
75.Xr mount 1M ,
76.Xr rmformat 1M ,
77.Xr umount 1M ,
78.Xr sd 7D ,
79.Xr pcfs 7FS ,
80.Xr zfs 7FS ,
81.Xr dkio 7I
82