xref: /illumos-gate/usr/src/man/man4fs/dev.4fs (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1*bbf21555SRichard Lowe.\"
2*bbf21555SRichard Lowe.\" Copyright (c) 2006, Sun Microsystems, Inc.  All Rights Reserved
3*bbf21555SRichard Lowe.\" Copyright 2021 Oxide Computer Company
4*bbf21555SRichard Lowe.\"
5*bbf21555SRichard Lowe.\" The contents of this file are subject to the terms of the
6*bbf21555SRichard Lowe.\" Common Development and Distribution License (the "License").
7*bbf21555SRichard Lowe.\" You may not use this file except in compliance with the License.
8*bbf21555SRichard Lowe.\"
9*bbf21555SRichard Lowe.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*bbf21555SRichard Lowe.\" or http://www.opensolaris.org/os/licensing.
11*bbf21555SRichard Lowe.\" See the License for the specific language governing permissions
12*bbf21555SRichard Lowe.\" and limitations under the License.
13*bbf21555SRichard Lowe.\"
14*bbf21555SRichard Lowe.\" When distributing Covered Code, include this CDDL HEADER in each
15*bbf21555SRichard Lowe.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*bbf21555SRichard Lowe.\" If applicable, add the following below this CDDL HEADER, with the
17*bbf21555SRichard Lowe.\" fields enclosed by brackets "[]" replaced with your own identifying
18*bbf21555SRichard Lowe.\" information: Portions Copyright [yyyy] [name of copyright owner]
19*bbf21555SRichard Lowe.\"
20*bbf21555SRichard Lowe.Dd November 29, 2021
21*bbf21555SRichard Lowe.Dt DEV 4FS
22*bbf21555SRichard Lowe.Os
23*bbf21555SRichard Lowe.Sh NAME
24*bbf21555SRichard Lowe.Nm dev
25*bbf21555SRichard Lowe.Nd Device name file system
26*bbf21555SRichard Lowe.Sh DESCRIPTION
27*bbf21555SRichard LoweThe
28*bbf21555SRichard Lowe.Nm
29*bbf21555SRichard Lowefilesystem manages the name spaces of devices in the operating system.
30*bbf21555SRichard LoweThe global zone's instance of the
31*bbf21555SRichard Lowe.Nm
32*bbf21555SRichard Lowefilesystem is mounted during boot on
33*bbf21555SRichard Lowe.Pa /dev .
34*bbf21555SRichard LoweThis filesystem is colloqiually called
35*bbf21555SRichard Lowe.Sq sdev
36*bbf21555SRichard Loweas a way to distinguish it from the
37*bbf21555SRichard Lowe.Xr devfs 4FS
38*bbf21555SRichard Lowefilesystem mounted at
39*bbf21555SRichard Lowe.Pa /devices .
40*bbf21555SRichard Lowe.Pp
41*bbf21555SRichard LoweA subdirectory under
42*bbf21555SRichard Lowe.Pa /dev
43*bbf21555SRichard Lowemay have unique operational semantics.
44*bbf21555SRichard LoweMost of the common device names under
45*bbf21555SRichard Lowe.Pa /dev
46*bbf21555SRichard Loweare created automatically by
47*bbf21555SRichard Lowe.Xr devfsadm 8
48*bbf21555SRichard LoweOthers, such as
49*bbf21555SRichard Lowe.Pa /dev/pts ,
50*bbf21555SRichard Lowe.Pa /dev/net ,
51*bbf21555SRichard Loweand
52*bbf21555SRichard Lowe.Pa /dev/zvol
53*bbf21555SRichard Loweare dynamic and reflect the operational state of the system.
54*bbf21555SRichard LoweYou can manually generate device names for newly attached hardware by invoking
55*bbf21555SRichard Lowe.Xr devfsadm 8
56*bbf21555SRichard Loweor implicitly, by indirectly causing a lookup or readdir operation in the
57*bbf21555SRichard Lowefilesystem to occur.
58*bbf21555SRichard LoweFor example, you can discover a disk that was attached when the system was
59*bbf21555SRichard Lowepowered down (and generate a name for that device) by invoking
60*bbf21555SRichard Lowe.Xr format 8 .
61*bbf21555SRichard Lowe.Pp
62*bbf21555SRichard LoweIn a non-global zone, the
63*bbf21555SRichard Lowe.Nm
64*bbf21555SRichard Lowefilesystem is also mounted at
65*bbf21555SRichard Lowe.Pa /dev ;
66*bbf21555SRichard Lowehowever, it is generally speaking read-only.
67*bbf21555SRichard LoweUnlike in the global zone, a privileged user in a non-global zone cannot create
68*bbf21555SRichard Lowedirectories or files, directories, or other objects within the filesystem.
69*bbf21555SRichard Lowe.Sh FILES
70*bbf21555SRichard Lowe.Bl -tag -width Pa
71*bbf21555SRichard Lowe.It Pa /dev
72*bbf21555SRichard LoweMount point for the
73*bbf21555SRichard Lowe.Nm
74*bbf21555SRichard Lowefilesystem in the global zone and non-global zones.
75*bbf21555SRichard Lowe.El
76*bbf21555SRichard Lowe.Sh SEE ALSO
77*bbf21555SRichard Lowe.Xr devfs 4FS ,
78*bbf21555SRichard Lowe.Xr devfsadm 8 ,
79*bbf21555SRichard Lowe.Xr format 8
80*bbf21555SRichard Lowe.Sh NOTES
81*bbf21555SRichard LoweThe global
82*bbf21555SRichard Lowe.Pa /dev
83*bbf21555SRichard Loweinstance cannot be unmounted.
84