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