xref: /dflybsd-src/share/man/man5/devfs.5 (revision 5b3e799a68fbadea72137b4cd440608038b1b73c)
179cf5ce7SSascha Wildner.\" Copyright (c) 1996
279cf5ce7SSascha Wildner.\"	Mike Pritchard <mpp@FreeBSD.org>.  All rights reserved.
379cf5ce7SSascha Wildner.\"
479cf5ce7SSascha Wildner.\" Copyright (c) 1992, 1993, 1994
579cf5ce7SSascha Wildner.\"	The Regents of the University of California.  All rights reserved.
679cf5ce7SSascha Wildner.\" All rights reserved.
779cf5ce7SSascha Wildner.\"
879cf5ce7SSascha Wildner.\" This code is derived from software donated to Berkeley by
979cf5ce7SSascha Wildner.\" Jan-Simon Pendry.
1079cf5ce7SSascha Wildner.\"
1179cf5ce7SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
1279cf5ce7SSascha Wildner.\" modification, are permitted provided that the following conditions
1379cf5ce7SSascha Wildner.\" are met:
1479cf5ce7SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
1579cf5ce7SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
1679cf5ce7SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
1779cf5ce7SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
1879cf5ce7SSascha Wildner.\"    documentation and/or other materials provided with the distribution.
19dc71b7abSJustin C. Sherrill.\" 3. Neither the name of the University nor the names of its contributors
2079cf5ce7SSascha Wildner.\"    may be used to endorse or promote products derived from this software
2179cf5ce7SSascha Wildner.\"    without specific prior written permission.
2279cf5ce7SSascha Wildner.\"
2379cf5ce7SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2479cf5ce7SSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2579cf5ce7SSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2679cf5ce7SSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2779cf5ce7SSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2879cf5ce7SSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2979cf5ce7SSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3079cf5ce7SSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
3179cf5ce7SSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3279cf5ce7SSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3379cf5ce7SSascha Wildner.\" SUCH DAMAGE.
3479cf5ce7SSascha Wildner.\"
3579cf5ce7SSascha Wildner.\" $FreeBSD: src/share/man/man5/devfs.5,v 1.19 2006/09/18 15:24:19 ru Exp $
3679cf5ce7SSascha Wildner.\"
37*5b3e799aSSascha Wildner.Dd February 17, 2018
3879cf5ce7SSascha Wildner.Dt DEVFS 5
3979cf5ce7SSascha Wildner.Os
4079cf5ce7SSascha Wildner.Sh NAME
4179cf5ce7SSascha Wildner.Nm devfs
4279cf5ce7SSascha Wildner.Nd device file system
4379cf5ce7SSascha Wildner.\".Sh SYNOPSIS
4479cf5ce7SSascha Wildner.\".Bd -literal
4579cf5ce7SSascha Wildner.\"devfs	/dev	devfs rw 0 0
4679cf5ce7SSascha Wildner.\".Ed
4779cf5ce7SSascha Wildner.Sh DESCRIPTION
4879cf5ce7SSascha WildnerThe device file system, or
4979cf5ce7SSascha Wildner.Nm ,
5079cf5ce7SSascha Wildnerprovides access to kernel's device
5179cf5ce7SSascha Wildnernamespace in the global file system namespace.
5279cf5ce7SSascha WildnerIt is mounted automatically on
5379cf5ce7SSascha Wildner.Pa /dev .
5479cf5ce7SSascha Wildner.Pp
5579cf5ce7SSascha WildnerThe file system includes several directories, links, symbolic links
5679cf5ce7SSascha Wildnerand devices, some of which can also be written.
5779cf5ce7SSascha WildnerIn a chroot'ed
5879cf5ce7SSascha Wildnerenvironment,
5979cf5ce7SSascha Wildner.Nm
6079cf5ce7SSascha Wildnercan be used to create a new
6179cf5ce7SSascha Wildner.Pa /dev
6279cf5ce7SSascha Wildnermount point.
63*5b3e799aSSascha Wildner.Sh SYSCTL VARIABLES
64*5b3e799aSSascha Wildner.Bl -hang -width ".Va vfs.devfs.debug"
65*5b3e799aSSascha Wildner.It Va vfs.devfs.debug
66*5b3e799aSSascha WildnerEnables
67*5b3e799aSSascha Wildner.Nm
68*5b3e799aSSascha Wildnerdebugging.
69*5b3e799aSSascha Wildner.El
7079cf5ce7SSascha Wildner.Sh FILES
7179cf5ce7SSascha Wildner.Bl -tag -width /dev/XXXX -compact
7279cf5ce7SSascha Wildner.It Pa /dev
7379cf5ce7SSascha WildnerThe normal
7479cf5ce7SSascha Wildner.Nm
7579cf5ce7SSascha Wildnermount point.
7679cf5ce7SSascha Wildner.El
7779cf5ce7SSascha Wildner.\".Sh EXAMPLES
7879cf5ce7SSascha Wildner.\"To mount a
7979cf5ce7SSascha Wildner.\".Nm
8079cf5ce7SSascha Wildner.\"volume located on
8179cf5ce7SSascha Wildner.\".Pa /dev :
8279cf5ce7SSascha Wildner.\".Pp
8379cf5ce7SSascha Wildner.\".Dl "mount -t devfs devfs /dev"
8479cf5ce7SSascha Wildner.Sh SEE ALSO
8579cf5ce7SSascha Wildner.Xr devfsctl 8
8679cf5ce7SSascha Wildner.\".Xr mount 8
8779cf5ce7SSascha Wildner.Sh HISTORY
8879cf5ce7SSascha WildnerThe
8979cf5ce7SSascha Wildner.Nm
9079cf5ce7SSascha Wildnerfile system first appeared in
9179cf5ce7SSascha Wildner.Dx 2.3 .
9279cf5ce7SSascha Wildner.Sh AUTHORS
9379cf5ce7SSascha Wildner.An Alex Hornung
94