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