share/man/man5/devfs.5

   1 .\" Copyright (c) 1996
   2 .\"     Mike Pritchard <mpp@FreeBSD.org>.  All rights reserved.
   3 .\"
   4 .\" Copyright (c) 1992, 1993, 1994
   5 .\"     The Regents of the University of California.  All rights reserved.
   6 .\" All rights reserved.
   7 .\"
   8 .\" This code is derived from software donated to Berkeley by
   9 .\" Jan-Simon Pendry.
  10 .\"
  11 .\" Redistribution and use in source and binary forms, with or without
  12 .\" modification, are permitted provided that the following conditions
  13 .\" are met:
  14 .\" 1. Redistributions of source code must retain the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer.
  16 .\" 2. Redistributions in binary form must reproduce the above copyright
  17 .\"    notice, this list of conditions and the following disclaimer in the
  18 .\"    documentation and/or other materials provided with the distribution.
  19 .\" 3. All advertising materials mentioning features or use of this software
  20 .\"    must display the following acknowledgement:
  21 .\"     This product includes software developed by the University of
  22 .\"     California, Berkeley and its contributors.
  23 .\" 4. Neither the name of the University nor the names of its contributors
  24 .\"    may be used to endorse or promote products derived from this software
  25 .\"    without specific prior written permission.
  26 .\"
  27 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  28 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  29 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  30 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  31 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  32 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  33 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  34 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  35 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  36 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  37 .\" SUCH DAMAGE.
  38 .\"
  39 .\" $FreeBSD: src/share/man/man5/devfs.5,v 1.19 2006/09/18 15:24:19 ru Exp $
  40 .\"
  41 .Dd September 12, 2009
  42 .Dt DEVFS 5
  43 .Os
  44 .Sh NAME
  45 .Nm devfs
  46 .Nd device file system
  47 .\".Sh SYNOPSIS
  48 .\".Bd -literal
  49 .\"devfs        /dev    devfs rw 0 0
  50 .\".Ed
  51 .Sh DESCRIPTION
  52 The device file system, or
  53 .Nm ,
  54 provides access to kernel's device
  55 namespace in the global file system namespace.
  56 It is mounted automatically on
  57 .Pa /dev .
  58 .Pp
  59 The file system includes several directories, links, symbolic links
  60 and devices, some of which can also be written.
  61 In a chroot'ed
  62 environment,
  63 .Nm
  64 can be used to create a new
  65 .Pa /dev
  66 mount point.
  67 .\".Pp
  68 .\"The
  69 .\".Xr mknod 8
  70 .\"tool can be used to recover deleted device entries under
  71 .\".Nm .
  72 .Sh FILES
  73 .Bl -tag -width /dev/XXXX -compact
  74 .It Pa /dev
  75 The normal
  76 .Nm
  77 mount point.
  78 .El
  79 .\".Sh EXAMPLES
  80 .\"To mount a
  81 .\".Nm
  82 .\"volume located on
  83 .\".Pa /dev :
  84 .\".Pp
  85 .\".Dl "mount -t devfs devfs /dev"
  86 .Sh SEE ALSO
  87 .Xr devfsctl 8
  88 .\".Xr mount 8
  89 .Sh HISTORY
  90 The
  91 .Nm
  92 file system first appeared in
  93 .Dx 2.3 .
  94 .Sh AUTHORS
  95 .An Alex Hornung