From owner-freebsd-doc@FreeBSD.ORG Tue Dec 13 21:50:25 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1D86A16A41F for ; Tue, 13 Dec 2005 21:50:25 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F61D43D5E for ; Tue, 13 Dec 2005 21:50:06 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id jBDLo2C9009606 for ; Tue, 13 Dec 2005 21:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id jBDLo2kd009605; Tue, 13 Dec 2005 21:50:02 GMT (envelope-from gnats) Resent-Date: Tue, 13 Dec 2005 21:50:02 GMT Resent-Message-Id: <200512132150.jBDLo2kd009605@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Roland Smith Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 276D816A420 for ; Tue, 13 Dec 2005 21:40:15 +0000 (GMT) (envelope-from rsmith@xs4all.nl) Received: from smtp-vbr7.xs4all.nl (smtp-vbr7.xs4all.nl [194.109.24.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1B8F743D88 for ; Tue, 13 Dec 2005 21:40:12 +0000 (GMT) (envelope-from rsmith@xs4all.nl) Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160]) by smtp-vbr7.xs4all.nl (8.13.3/8.13.3) with ESMTP id jBDLeBSA018553 for ; Tue, 13 Dec 2005 22:40:11 +0100 (CET) (envelope-from rsmith@xs4all.nl) Received: by slackbox.xs4all.nl (Postfix, from userid 1001) id 2BBACB827; Tue, 13 Dec 2005 22:40:11 +0100 (CET) Message-Id: <20051213214011.2BBACB827@slackbox.xs4all.nl> Date: Tue, 13 Dec 2005 22:40:11 +0100 (CET) From: Roland Smith To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/90362: [patch] enhancement of devfs.rules manpage. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Roland Smith List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Dec 2005 21:50:25 -0000 >Number: 90362 >Category: docs >Synopsis: [patch] enhancement of devfs.rules manpage. >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Dec 13 21:50:02 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Roland Smith >Release: FreeBSD 6.0-STABLE amd64 >Organization: >Environment: System: FreeBSD slackbox.xs4all.nl 6.0-STABLE FreeBSD 6.0-STABLE #0: Sun Nov 20 02:27:45 CET 2005 root@slackbox.xs4all.nl:/usr/obj/usr/src/sys/RFS amd64 >Description: As a result of recent postings on -questions, it became clear that the manpage for devfs.rules could be improved, especially mentioning that a ruleset needs to be activated in /etc/rc.conf. This patch tries to provide such improvement. >How-To-Repeat: >Fix: See enclosed patch. Feel free to improve the tags used, I'm still learning mdoc. :-) ----------------------- patch ---------------------------- --- devfs.rules.5 2005/12/13 19:59:29 1.6 +++ devfs.rules.5 2005/12/13 21:19:53 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD: /repoman/r/ncvs/src/share/man/man5/devfs.rules.5,v 1.2.4.1 2005/07/27 12:03:48 keramida Exp $ .\" -.Dd May 17, 2005 +.Dd Dec 13, 2005 .Dt DEVFS.RULES 5 .Os .Sh NAME @@ -72,8 +72,23 @@ .Dq Li usb group, the following rule may be used: .Pp +.Dl "[localrules=10]" .Dl "add path 'da*s*' mode 0660 group usb" .Pp +The first line declares and starts a new ruleset, with the name +.Va localrules +and the number 10. Rulesets should have a unique name and number. All +rules that follow a ruleset declaration belong to that ruleset, untill a +new ruleset is started. This ruleset has to be enabled in +.Pa /etc/rc.conf +to be the ruleset for the +.Pa /dev +filesystem. This is done by putting the following line in +.Pa /etc/rc.conf : +.Bd -literal +devfs_system_ruleset="localrules" +.Ed +.Pp To make all the .Xr uscanner 4 devices accessible to their owner and the @@ -81,6 +96,7 @@ group, a similar rule may be used: .Pp .Dl "add path 'uscanner*' mode 0660 group usb" +.Pp .Sh SEE ALSO .Xr glob 3 , .Xr devfs 5 , ----------------------- patch ---------------------------- >Release-Note: >Audit-Trail: >Unformatted: