From owner-freebsd-doc@FreeBSD.ORG Sat Dec 2 09:30:14 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D81D816A403 for ; Sat, 2 Dec 2006 09:30:14 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.FreeBSD.org (Postfix) with ESMTP id 39B0C43C9D for ; Sat, 2 Dec 2006 09:29:55 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id kB29UEN7003645 for ; Sat, 2 Dec 2006 09:30:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id kB29UEqc003637; Sat, 2 Dec 2006 09:30:14 GMT (envelope-from gnats) Date: Sat, 2 Dec 2006 09:30:14 GMT Message-Id: <200612020930.kB29UEqc003637@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Cc: 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 Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 02 Dec 2006 09:30:14 -0000 The following reply was made to PR docs/106148; it has been noted by GNATS. From: Marc Fonvieille To: Roland Smith Cc: FreeBSD-gnats-submit@FreeBSD.org, doc@FreeBSD.org Subject: Re: docs/106148: [PATCH] extend the documentation for handling USB drives Date: Sat, 2 Dec 2006 10:22:30 +0100 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