Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DEVFS.RULES(5)		    BSD	File Formats Manual		DEVFS.RULES(5)

NAME
     devfs.rules -- devfs configuration	information

DESCRIPTION
     The devfs.rules file provides an easy way to create and apply devfs(8)
     rules, even for devices that are not available at boot.

     For devices available at boot, see	devfs.conf(5).

     The format	of this	file is	simple.	 Empty lines and lines beginning with
     a hash sign (`#') are ignored.  A line between brackets denotes the start
     of	a ruleset.  In the brackets should be the name of the ruleset and its
     number, separated by an equal sign.

     Other lines are rule specifications as documented in devfs(8), in the
     section Rule Specification.  These	lines are prepended with "rule"	and
     are passed	to devfs(8) by the startup scripts of the system.  It is im-
     portant to	put path elements that contain glob(3) special characters be-
     tween quotes.

     Rulesets should have a unique name	and number.

     All rules that follow a ruleset declaration belong	to that	ruleset, until
     a new ruleset is started.

     One custom	ruleset	has to be enabled in /etc/rc.conf, otherwise it	will
     not be applied to the /dev	file system by the default system startup
     process.  For example, to enable a	"localrules" ruleset for the /dev file
     system, you would have to use something like this in your rc.conf file:

	   devfs_system_ruleset="localrules"

FILES
     /etc/defaults/devfs.rules	       Default devfs.rules configuration file.
     /etc/devfs.rules		       Local devfs.rules configuration file.
				       Rulesets	in here	override those in
				       /etc/defaults/devfs.rules with the same
				       ruleset number, otherwise the two files
				       are effectively merged.

EXAMPLES
     To	make all the partitions	of da(4) devices readable and writable by
     their owner and the "usb" group, the following rule may be	used:

	   [localrules=10]
	   add path 'da*s*' mode 0660 group usb

     The first line declares and starts	a new ruleset, with the	name
     localrules	and the	number 10.

     To	give usbconfig(8) and libusb(3)	enabled	applications permission	to all
     usb devices for their owner and the "usb" group, a	similar	rule may be
     used:

	   add path 'usb/*' mode 0660 group usb

SEE ALSO
     glob(3), devfs(5),	devfs.conf(5), devfs(8)

AUTHORS
     This manual page was written by Roland Smith <rsmith@xs4all.nl>.

BSD			       February	21, 2010			   BSD

NAME | DESCRIPTION | FILES | EXAMPLES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=devfs.rules&manpath=FreeBSD+11.1-RELEASE+and+Ports>

home | help