share/man/man5/devfs.conf.5

   1 .\" Copyright (c) 2004 Roland Smith <rsmith@xs4all.nl>
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\" $FreeBSD$
  26 .\"
  27 .Dd May 17, 2005
  28 .Dt DEVFS.CONF 5
  29 .Os
  30 .Sh NAME
  31 .Nm devfs.conf
  32 .Nd boot-time devfs configuration information
  33 .Sh DESCRIPTION
  34 The
  35 .Nm
  36 file provides an easy way to set ownership and permissions, or create
  37 links for devices available at boot.
  38 .Pp
  39 It does not work for devices plugged in and out after the system is up
  40 and running, e.g.\& USB devices.
  41 See
  42 .Xr devfs.rules 5
  43 for setting ownership and permissions for all device nodes, and
  44 .Xr devd.conf 5
  45 for actions to be taken when devices are attached or detached.
  46 .Pp
  47 Lines starting with a hash sign
  48 .Pq Ql #
  49 and empty lines are ignored.
  50 The lines that specify
  51 .Nm
  52 rules consist of three parameters separated by whitespace:
  53 .Bl -tag -width indent
  54 .It Ar action
  55 The action to take for the device.
  56 The action names are only significant to the first unique character.
  57 .It Ar devname
  58 The name of the device created by
  59 .Xr devfs 5 .
  60 .It Ar arg
  61 The argument of the
  62 .Ar action .
  63 .El
  64 .Pp
  65 The actions currently supported are:
  66 .Bl -tag -width indent
  67 .It Ic link
  68 This action creates a symbolic link named
  69 .Ar arg
  70 that points to
  71 .Ar devname ,
  72 the name of the device created by
  73 .Xr devfs 5 .
  74 .It Ic own
  75 This action changes the ownership of
  76 .Ar devname .
  77 The
  78 .Ar arg
  79 parameter must be in the form of an
  80 .Ar owner Ns : Ns Ar group
  81 pair, in the same format used by
  82 .Xr chown 8 .
  83 .It Ic perm
  84 This action changes the permissions of
  85 .Ar devname .
  86 The
  87 .Ar arg
  88 parameter must be a
  89 .Ar mode
  90 as explained in
  91 .Xr chmod 1 .
  92 .El
  93 .Sh FILES
  94 .Bl -tag -compact -width Pa
  95 .It Pa /etc/devfs.conf
  96 .It Pa /usr/share/examples/etc/devfs.conf
  97 .El
  98 .Sh EXAMPLES
  99 To create a
 100 .Pa /dev/cdrom
 101 link that points to the first
 102 .Xr SCSI 4
 103 CD-ROM,
 104 the following may be added to
 105 .Nm :
 106 .Bd -literal -offset indent
 107 link    cd0     cdrom
 108 .Ed
 109 .Pp
 110 Similarly, to link
 111 .Pa /dev/cdrom
 112 to the first ATAPI CD-ROM device, the following action may be used:
 113 .Bd -literal -offset indent
 114 link    acd0    cdrom
 115 .Ed
 116 .Pp
 117 To set the owner of a device, the
 118 .Ic own
 119 action may be specified:
 120 .Bd -literal -offset indent
 121 own     cd0     root:cdrom
 122 .Ed
 123 .Pp
 124 To set the permissions of a device, a
 125 .Ic perm
 126 action should be used:
 127 .Bd -literal -offset indent
 128 perm    cd0     0660
 129 .Ed
 130 .Sh SEE ALSO
 131 .Xr chmod 1 ,
 132 .Xr devd.conf 5 ,
 133 .Xr devfs 5 ,
 134 .Xr devfs.rules 5 ,
 135 .Xr chown 8
 136 .Sh AUTHORS
 137 This manual page was written by
 138 .An "Roland Smith" Aq rsmith@xs4all.nl .