From owner-freebsd-doc@FreeBSD.ORG Sat Dec 2 11:55:51 2006 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 670C816A412; Sat, 2 Dec 2006 11:55:51 +0000 (UTC) (envelope-from rsmith@xs4all.nl) Received: from smtp-vbr2.xs4all.nl (smtp-vbr2.xs4all.nl [194.109.24.22]) by mx1.FreeBSD.org (Postfix) with ESMTP id BAB3C43CA8; Sat, 2 Dec 2006 11:55:30 +0000 (GMT) (envelope-from rsmith@xs4all.nl) Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160]) by smtp-vbr2.xs4all.nl (8.13.8/8.13.8) with ESMTP id kB2BtmcV081169; Sat, 2 Dec 2006 12:55:49 +0100 (CET) (envelope-from rsmith@xs4all.nl) Received: by slackbox.xs4all.nl (Postfix, from userid 1001) id 94AEFB845; Sat, 2 Dec 2006 12:55:48 +0100 (CET) Date: Sat, 2 Dec 2006 12:55:48 +0100 From: Roland Smith To: Marc Fonvieille Message-ID: <20061202115548.GA68002@slackbox.xs4all.nl> References: <20061201181553.67AA8B844@slackbox.xs4all.nl> <20061202092230.GA96391@abigail.blackend.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="3V7upXqbjpZ4EhLz" Content-Disposition: inline In-Reply-To: <20061202092230.GA96391@abigail.blackend.org> X-GPG-Fingerprint: 1A2B 477F 9970 BA3C 2914 B7CE 1277 EFB0 C321 A725 X-GPG-Key: http://www.xs4all.nl/~rsmith/pubkey.txt X-GPG-Notice: If this message is not signed, don't assume I sent it! User-Agent: Mutt/1.5.13 (2006-08-11) X-Virus-Scanned: by XS4ALL Virus Scanner Cc: FreeBSD-gnats-submit@FreeBSD.org, doc@FreeBSD.org Subject: Re: docs/106148: [PATCH] extend the documentation for handling USB drives X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 02 Dec 2006 11:55:51 -0000 --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 @@ > > 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. > > + > > + 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;; > > + > > + > > + add path 'da*' mode 0660 group usb > > + > > + > > + If you already have SCSI disks in your system, you want to > > + do this a bit different. E.g., if you already have > > + disks da0 through da2 > > + attached to the system, change the line as follows: > > + > > + > > + add path 'da[3-9]*' mode 0660 group usb > > + > > + This will exclude the already existing disks from the usb > > + group. > > + >=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--