From owner-freebsd-doc@FreeBSD.ORG Mon Jun 4 21:49:13 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 048901065687 for ; Mon, 4 Jun 2012 21:49:13 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id B2B348FC12 for ; Mon, 4 Jun 2012 21:49:12 +0000 (UTC) Received: from lightning.wonkity.com (lightning.wonkity.com [10.0.0.8]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q54LnBiP001853 for ; Mon, 4 Jun 2012 15:49:11 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Received: from lightning.wonkity.com (localhost [127.0.0.1]) by lightning.wonkity.com (8.14.5/8.14.5) with ESMTP id q54LnB3n064789 for ; Mon, 4 Jun 2012 15:49:11 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Received: from localhost (wblock@localhost) by lightning.wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q54LnBmw064786 for ; Mon, 4 Jun 2012 15:49:11 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Date: Mon, 4 Jun 2012 15:49:11 -0600 (MDT) From: Warren Block To: doc@freebsd.org Message-ID: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [10.0.0.1]); Mon, 04 Jun 2012 15:49:11 -0600 (MDT) Cc: Subject: Handbook Storage chapter 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: Mon, 04 Jun 2012 21:49:13 -0000 >From a thread on -questions, the Handbook Storage chapter, in disks/chapter.sgml, has some seriously outdated instructions. 19.3 "Adding Disks" talks about dedicated disks, an unnecessary complication. 19.3.1 suggests using sysinstall to slice and partition disks, a bad idea now at least. If you look at it funny, sysinstall will happily write the /etc/fstab for the new disk over your existing one. You didn't need that old version, did you? 19.3.2 has a procedure for setting up a disk using fdisk and bsdlabel, which seems overly complicated, mounting the new disk at "/1". At this point, use of fdisk and bsdlabel can probably be replaced with gpart(8) instead. At the same time, the instructions for "dedicated" disks can be eliminated. It has no advantage and several possible disadvantages. Following that is a section on ccd(4), which needs a look. I was under the impression that ccd was, um, only historically relevant now. Finally, there's a section on ataraid(4), which should at least mention and link to the new graid(4) section in the GEOM chapter. 19.10 "Backups to Floppies" can probably go. It wasn't very viable even when floppies could still be bought.