From owner-freebsd-current Wed Jul 17 9:27:24 2002 Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 862EE37B400 for ; Wed, 17 Jul 2002 09:27:19 -0700 (PDT) Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4B0F843E3B for ; Wed, 17 Jul 2002 09:27:18 -0700 (PDT) (envelope-from sheldonh@starjuice.net) Received: from sheldonh by axl.seasidesoftware.co.za with local (Exim 3.36 #1) id 17Urf9-0000El-00; Wed, 17 Jul 2002 18:28:27 +0200 Date: Wed, 17 Jul 2002 18:28:27 +0200 From: Sheldon Hearn To: Dima Dorfman Cc: current@freebsd.org Subject: Re: DEVFS rule subsystem (was: cvs commit: src/sbin Makefile src/sbin/devfs Makefile devfs.8 devfs.c extern.h rule.c src/sys/conf files src/sys/fs/devfs devfs.h devfs_devs.c devfs_rule.c devfs_vfsops.c devfs_vnops.c ) Message-ID: <20020717162827.GA751@starjuice.net> Mail-Followup-To: Dima Dorfman , current@freebsd.org References: <200207170146.g6H1kpWl024662@freefall.freebsd.org> <20020717015221.30D953E22@turbine.trit.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020717015221.30D953E22@turbine.trit.org> User-Agent: Mutt/1.5.1i Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On (2002/07/17 01:52), Dima Dorfman wrote: > The devfs(8) manual page is a pretty good reference of the existing > features and semantics, but it lacks polish needed to be able to serve > as an introduction. Actually, I think it's brilliant. The only nits are the weird sections, which made it hard for me to find my way around. For example, the examples are all in an Examples subsection of the non-standard RULE SUBSYSTEM section, so I didn't see that there were examples when I first looked for them. I'd suggest the attached patch, to make it easier for manpage die-hards to navigate. Great job, man! Ciao, Sheldon. Index: devfs.8 =================================================================== RCS file: /home/ncvs/src/sbin/devfs/devfs.8,v retrieving revision 1.1 diff -u -d -r1.1 devfs.8 --- devfs.8 17 Jul 2002 01:46:47 -0000 1.1 +++ devfs.8 17 Jul 2002 16:25:02 -0000 @@ -62,7 +62,7 @@ operates on .Pa /dev . .El -.Sh RULE SUBSYSTEM +.Ss Rule Subsystem The .Xr devfs 5 rule subsystem provides a way for the administrator of a system to control @@ -207,9 +207,7 @@ .It Cm unhide Unhide the node. .El -.Ss Notes -.Bl -bullet -offset indent -.It +.Sh IMPLEMENTATION NOTES Rulesets are created by the kernel at the first reference, and destroyed when the last reference disappears. E.g., a ruleset is created when a rule is added to it or when it is set @@ -218,12 +216,12 @@ and no other references to it exist (i.e., it is not included by any rules, and it is not the current ruleset for any mount-point). -.It +.Pp Ruleset number 0 is the default ruleset for all new mount-points. It is always empty, cannot be modified or deleted, and does not show up in the output of .Cm showsets . -.It +.Pp Rules and rulesets are unique to the entire system, not a particular mount-point. I.e., a @@ -232,8 +230,7 @@ .Fl m . The mount-point is only relevant when changing what its current ruleset is, or when using one of the apply commands. -.El -.Ss Examples +.Sh EXAMPLES When the system boots, the only ruleset that exists is ruleset number 0; since the latter may not be modified, we have to create another ruleset To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message