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 October 13, 2015 28.Dt DEVFS.CONF 5 29.Os 30.Sh NAME 31.Nm devfs.conf 32.Nd boot-time devfs configuration information 33.Sh DESCRIPTION 34The 35.Nm 36file provides an easy way to set ownership and permissions, or create 37links for devices available at boot. 38.Pp 39It does not work for devices plugged in and out after the system is up 40and running, e.g.\& USB devices. 41See 42.Xr devfs.rules 5 43for setting ownership and permissions for all device nodes, and 44.Xr devd.conf 5 45for actions to be taken when devices are attached or detached. 46.Pp 47Lines starting with a hash sign 48.Pq Ql # 49and empty lines are ignored. 50The lines that specify 51.Nm 52rules consist of three parameters separated by whitespace: 53.Bl -tag -width indent 54.It Ar action 55The action to take for the device. 56The action names are only significant to the first unique character. 57.It Ar devname 58The name of the device created by 59.Xr devfs 5 . 60.It Ar arg 61The argument of the 62.Ar action . 63.El 64.Pp 65The actions currently supported are: 66.Bl -tag -width indent 67.It Ic link 68This action creates a symbolic link named 69.Ar arg 70that points to 71.Ar devname , 72the name of the device created by 73.Xr devfs 5 . 74.It Ic own 75This action changes the ownership of 76.Ar devname . 77The 78.Ar arg 79parameter must be in the form of an 80.Ar owner Ns : Ns Ar group 81pair, in the same format used by 82.Xr chown 8 . 83.It Ic perm 84This action changes the permissions of 85.Ar devname . 86The 87.Ar arg 88parameter must be a 89.Ar mode 90as 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 99To create a 100.Pa /dev/cdrom 101link that points to the first 102.Xr SCSI 4 103CD-ROM, 104the following may be added to 105.Nm : 106.Bd -literal -offset indent 107link cd0 cdrom 108.Ed 109.Pp 110Similarly, to link 111.Pa /dev/cdrom 112to the first SCSI CD-ROM device, the following action may be used: 113.Bd -literal -offset indent 114link cd0 cdrom 115.Ed 116.Pp 117To set the owner of a device, the 118.Ic own 119action may be specified: 120.Bd -literal -offset indent 121own cd0 root:cdrom 122.Ed 123.Pp 124To set the permissions of a device, a 125.Ic perm 126action should be used: 127.Bd -literal -offset indent 128perm 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 137This manual page was written by 138.An Roland Smith Aq Mt rsmith@xs4all.nl . 139