docs/106148: [PATCH] extend the documentation for handling USB drives

[Roland Smith]

The following reply was made to PR docs/106148; it has been noted by GNATS.

From: Roland Smith <rsmith at xs4all.nl>
To: Marc Fonvieille <blackend at FreeBSD.org>
Cc: FreeBSD-gnats-submit at FreeBSD.org, doc at FreeBSD.org
Subject: Re: docs/106148: [PATCH] extend the documentation for handling USB drives
Date: Sat, 2 Dec 2006 12:55:48 +0100

 --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--