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