From owner-freebsd-doc@FreeBSD.ORG Sat Dec 2 09:22:34 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 C34F416A403; Sat, 2 Dec 2006 09:22:34 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 903D643C9D; Sat, 2 Dec 2006 09:22:14 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id kB29MVau096592; Sat, 2 Dec 2006 10:22:31 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.13.4/8.13.3/Submit) id kB29MU0U096591; Sat, 2 Dec 2006 10:22:30 +0100 (CET) (envelope-from marc) Date: Sat, 2 Dec 2006 10:22:30 +0100 From: Marc Fonvieille To: Roland Smith Message-ID: <20061202092230.GA96391@abigail.blackend.org> References: <20061201181553.67AA8B844@slackbox.xs4all.nl> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20061201181553.67AA8B844@slackbox.xs4all.nl> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.11-STABLE User-Agent: Mutt/1.5.9i 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 09:22:34 -0000 On Fri, Dec 01, 2006 at 07:15:53PM +0100, Roland Smith wrote: > > >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. > > > >How-To-Repeat: > N/A > >Fix: > This patch has been tested to apply cleanly on revision 1.265 and 1.267. > > ------- 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. > + [...] 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. -- Marc