From owner-freebsd-stable@FreeBSD.ORG Tue Dec 13 23:17:26 2005 Return-Path: X-Original-To: freebsd-stable@freebsd.org Delivered-To: freebsd-stable@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D5D6416A41F for ; Tue, 13 Dec 2005 23:17:26 +0000 (GMT) (envelope-from brdavis@odin.ac.hmc.edu) Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id 01A8C43D55 for ; Tue, 13 Dec 2005 23:17:12 +0000 (GMT) (envelope-from brdavis@odin.ac.hmc.edu) Received: from odin.ac.hmc.edu (localhost.localdomain [127.0.0.1]) by odin.ac.hmc.edu (8.13.0/8.13.0) with ESMTP id jBDNHB9M012321; Tue, 13 Dec 2005 15:17:12 -0800 Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.13.0/8.13.0/Submit) id jBDNHBAV012320; Tue, 13 Dec 2005 15:17:11 -0800 Date: Tue, 13 Dec 2005 15:17:11 -0800 From: Brooks Davis To: Brooks Davis , "[LoN]Kamikaze" , freebsd-stable@freebsd.org Message-ID: <20051213231711.GB17830@odin.ac.hmc.edu> References: <439EF8B5.4030702@gmx.de> <20051213164947.GA17705@odin.ac.hmc.edu> <20051213180418.GA20852@slackbox.xs4all.nl> <20051213192143.GA5926@odin.ac.hmc.edu> <20051213202234.GB23420@slackbox.xs4all.nl> <20051213205539.GA17830@odin.ac.hmc.edu> <20051213213121.GA26709@slackbox.xs4all.nl> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="uZ3hkaAS1mZxFaxD" Content-Disposition: inline In-Reply-To: <20051213213121.GA26709@slackbox.xs4all.nl> User-Agent: Mutt/1.4.1i X-Virus-Scanned: by amavisd-new X-Spam-Status: No, hits=0.0 required=8.0 tests=none autolearn=no version=2.63 X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on odin.ac.hmc.edu Cc: Subject: Re: devfs doesn't set access rights X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Dec 2005 23:17:27 -0000 --uZ3hkaAS1mZxFaxD Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Dec 13, 2005 at 10:31:21PM +0100, Roland Smith wrote: > On Tue, Dec 13, 2005 at 12:55:39PM -0800, Brooks Davis wrote: > > > > What's wrong with the EXAMPLES section in devfs(8)? > >=20 > > It's fine. Referring to devfs(8) was poor word choice on my part. I > > meant the system as a whole including devfs.rules. > >=20 > > > > any documentation of the rc.conf variables > > > > (which also aren't documented in rc.conf(5) either), and any mentio= n of > > > > that the purpose or usage of lines like: > > > >=20 > > > > [devfsrules_unhide_basic=3D2] > > >=20 > > > See devfs.rules(5), third para of DESCRIPTION. I agree it could use an > > > example, and some explanation that you have to enable the ruleset in > > > /etc/rc.conf. > >=20 > > That's quite easy to miss. I saw the bit about comments and my eyes > > glazed over and skipped the rest. Breaking out the paragraph into > > bullets might be an improvement. > >=20 > > > There is an example on my website: > > > http://www.xs4all.nl/~rsmith/freebsd/#hotplug=20 > > > > > > Following is a patch for devfs.rules.5. Comments? Otherwise I'll subm= it it. > >=20 > > Content looks good to me. > > > From looking in rc.conf(5), I think this should be: > >=20 > > .Pa /etc/rc.conf : > > .Bd -literal > > devfs_system_ruleset=3D"localrules" > > .Ed >=20 > Ok, I'll incorporate that, and send-pr it. Great. > > > +.Pp > > > To make all the > > > .Xr uscanner 4 > > > devices accessible to their owner and the > > > @@ -81,6 +95,7 @@ > > > group, a similar rule may be used: > > > .Pp > > > .Dl "add path 'uscanner*' mode 0660 group usb" > > > +.Pp > >=20 > > I think this is unnecessary. It's certainly not common practice. >=20 > It's just another example. I was referring to the .Pp before the .Sh below. > > > .Sh SEE ALSO > > > .Xr glob 3 , > > > .Xr devfs 5 , > > > ------------------ devfs.rules.5 patch -------------------------- > > >=20 > > > > Setting the mode of a device node really ought to be trivial, but l= ast > > > > time I looked at it I was clearly missing something and couldn't ge= t it > > > > working. I decided the device in question really ought to be attac= hed > > > > at boot and thus gave up and used devfs.conf since I had productive > > > > work to do. Some cook easy to use cookbook example would be really > > > > helpful for those who don't have time to figure out all the details. > > >=20 > > > Maybe my freebsd page can help. Most of the things I learned while > > > configuring FreeBSD are documented here. > > >=20 > > > http://www.xs4all.nl/~rsmith/freebsd > >=20 > > The example you site looks like excellent handbook fodder. >=20 > Do you want to submit it? I won't have time to do it before mid-januari > at least. > =20 > > > > Comparativly few people will want to do anything more than make a d= evice > > > > or two more accessable. > > >=20 > > > Agreed. But the mechanism is more general because devfs can be used in > > > multiple places (e.g. jails). > >=20 > > Definitely. The full features look quite cool and useful. My concern = is > > simply that it's easy to find out how to do the common thing without > > having to understand all the complex things you can do. Thanks for > > writing this manpage and working to improve it! >=20 > Thanks! Actually, my motivation for writing the manpages was to stop the > tide of "how do I configure devfs" postings on -questions. >=20 > Unfortunately, once you understand the details of the system well enough > to document it, some of the details will seem so obvious that you don't > document them. :-) Yes, that's always a problem. I haven't mastered the necessary xen-like state where I can forget what I know when I'm reading my own work. :) -- Brooks --=20 Any statement of the form "X is the one, true Y" is FALSE. PGP fingerprint 655D 519C 26A7 82E7 2529 9BF0 5D8E 8BE9 F238 1AD4 --uZ3hkaAS1mZxFaxD Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (GNU/Linux) iD8DBQFDn1Z3XY6L6fI4GtQRAohcAJ0ZSVzHxAZin55hIiuemWqEaZgPxACfdHdy p2UxsG3h0bgZsGdBClGhfG0= =TCBq -----END PGP SIGNATURE----- --uZ3hkaAS1mZxFaxD--