Date: Sat, 2 Dec 2006 12:55:48 +0100 From: Roland Smith <rsmith@xs4all.nl> To: Marc Fonvieille <blackend@FreeBSD.org> Cc: FreeBSD-gnats-submit@FreeBSD.org, doc@FreeBSD.org Subject: Re: docs/106148: [PATCH] extend the documentation for handling USB drives Message-ID: <20061202115548.GA68002@slackbox.xs4all.nl> In-Reply-To: <20061202092230.GA96391@abigail.blackend.org> References: <20061201181553.67AA8B844@slackbox.xs4all.nl> <20061202092230.GA96391@abigail.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--3V7upXqbjpZ4EhLz Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Dec 02, 2006 at 10:22:30AM +0100, Marc Fonvieille wrote: > On Fri, Dec 01, 2006 at 07:15:53PM +0100, Roland Smith wrote: > >=20 > > >Description: > > The disks chapter of the handbook is quite short in its description of = the > > handling of USB mass-storage drives. The included patch is an attempt to > > expand/clarify this for new users. > >=20 > >=20 > > ------- patch for en_US.ISO8859-1/books/handbook/disks/chapter.sgml ---= ---- > > --- chapter.sgml.orig Sun Oct 8 17:01:02 2006 > > +++ chapter.sgml Sun Oct 8 17:48:40 2006 > > @@ -777,6 +777,68 @@ > > <para>to your configuration file for USB 2.0 support. Note > > &man.uhci.4; and &man.ohci.4; drivers are still needed if you > > want USB 1.X support.</para> > > + > > + <para>To make these devices mountable as a normal user, certain = steps > > + have to be taken. First, the devices that are created when a USB > > + storage device is connected need to be accessible. A solution is to > > + create a group (e.g. named usb) that users of these devices need to > > + belong to. This is done with &man.pw.8;. The users in question also > > + need to be added to that group. This is also done with > > + &man.pw.8;. Second, when the devices are created, they have to be > > + accessible by this group. This is accomplished by adding a line for > > + these devices to &man.devfs.rules.5;; > > + </para> > > + > > + <programlisting>add path 'da*' mode 0660 group usb</programlisti= ng> > > + > > + <note> > > + <para>If you already have SCSI disks in your system, you want to > > + do this a bit different. E.g., if you already have > > + disks <filename>da0</filename> through <filename>da2</filename> > > + attached to the system, change the line as follows: > > + </para> > > + > > + <programlisting>add path 'da[3-9]*' mode 0660 group usb</programlisti= ng> > > + > > + <para>This will exclude the already existing disks from the usb > > + group. > > + </para> >=20 > [...] >=20 > Your idea is a great improvement to the current section, but I think it > would be better to use the same scheme as the one used by the FreeBSD > GNOME team for HAL, i.e, using operator group as in > http://www.freebsd.org/gnome/docs/faq2.html#q19 > This would keep a consistency between our docs and would be compatible > with GNOME and other things using HAL. Ok. I'll rework the patch and post it tomorrow.=20 Roland --=20 R.F.Smith http://www.xs4all.nl/~rsmith/ [plain text _non-HTML_ PGP/GnuPG encrypted/signed email much appreciated] pgp: 1A2B 477F 9970 BA3C 2914 B7CE 1277 EFB0 C321 A725 (KeyID: C321A725) --3V7upXqbjpZ4EhLz Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) iD8DBQFFcWnEEnfvsMMhpyURAsoEAKCZiFwl3M0ixnv+E1LZ8izBrKfUkgCffDXX Lj3rf2FvVJBDhCb+Fd35xtE= =YMW4 -----END PGP SIGNATURE----- --3V7upXqbjpZ4EhLz--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20061202115548.GA68002>