usr/src/man/man7fs/devfs.7fs

   1 '\" te
   2 .\"  Copyright (c) 2004 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DEVFS 7FS "Oct 26, 2004"
   7 .SH NAME
   8 devfs \- Devices file system
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 The \fBdevfs\fR filesystem manages a name space of all devices under the
  13 Solaris operating environment and is mounted during boot on the \fB/devices\fR
  14 name space.
  15 .sp
  16 .LP
  17 The \fB/devices\fR name space is dynamic and reflects the current state of
  18 accessible devices under the Solaris operating environment. The names of all
  19 attached device instances are present under \fB/devices\fR.
  20 .sp
  21 .LP
  22 The content under \fB/devices\fR is under the exclusive control of the
  23 \fBdevfs\fR filesystem and cannot be changed.
  24 .sp
  25 .LP
  26 The system may be configured to include a device in one of two ways:
  27 .br
  28 .in +2
  29 By means of dynamic reconfiguration (DR), using, for example, \fBcfgadm\fR(1M).
  30 .in -2
  31 .br
  32 .in +2
  33 For devices driven by \fBdriver.conf\fR(4) enumeration, edit the
  34 \fBdriver.conf\fR file to add a new entry, then use \fBupdate_drv\fR(1M) to
  35 cause the system to re-read the \fBdriver.conf\fR file and thereby enumerate
  36 the instance.
  37 .in -2
  38 .sp
  39 .LP
  40 The device may be attached through a number of system calls and programs,
  41 including \fBopen\fR(2), \fBstat\fR(2) and \fBls\fR(1). During device attach,
  42 the device driver typically creates minor nodes corresponding to the device via
  43 \fBddi_create_minor_node\fR(9F). If the attach is successful, one or more minor
  44 nodes referring to the device are created under \fB/devices\fR.
  45 .sp
  46 .LP
  47 Operations like \fBmknod\fR(2), \fBmkdir\fR(2) and \fBcreat\fR(2) are not
  48 supported in \fB/devices\fR.
  49 .SH FILES
  50 .sp
  51 .ne 2
  52 .na
  53 \fB/devices\fR
  54 .ad
  55 .RS 12n
  56 Mount point for \fBdevfs\fR file system
  57 .RE
  58
  59 .SH SEE ALSO
  60 .sp
  61 .LP
  62 \fBdevfsadm\fR(1M), \fBvfstab\fR(4), \fBattach\fR(9E)
  63 .SH NOTES
  64 .sp
  65 .LP
  66 The \fB/devices\fR name space cannot be unmounted.
  67 .sp
  68 .LP
  69 All content at or below the \fB/devices\fR name space is an implementation
  70 artifact and subject to incompatible change or removal without notification.