Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 13 Dec 2005 15:17:11 -0800
From:      Brooks Davis <brooks@one-eyed-alien.net>
To:        Brooks Davis <brooks@one-eyed-alien.net>, "[LoN]Kamikaze" <LoN_Kamikaze@gmx.de>, freebsd-stable@freebsd.org
Subject:   Re: devfs doesn't set access rights
Message-ID:  <20051213231711.GB17830@odin.ac.hmc.edu>
In-Reply-To: <20051213213121.GA26709@slackbox.xs4all.nl>
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>

next in thread | previous in thread | raw e-mail | index | archive | help

--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:
> <snip>
> > > 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.
> <snip>
> > 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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051213231711.GB17830>