From owner-freebsd-geom@FreeBSD.ORG Tue May 15 16:42:16 2007 Return-Path: X-Original-To: freebsd-geom@freebsd.org Delivered-To: freebsd-geom@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 8778C16A403; Tue, 15 May 2007 16:42:16 +0000 (UTC) (envelope-from rik@inse.ru) Received: from mail.inse.ru (inse.ru [144.206.128.1]) by mx1.freebsd.org (Postfix) with ESMTP id D5DF913C458; Tue, 15 May 2007 16:42:15 +0000 (UTC) (envelope-from rik@inse.ru) Received: from [127.0.0.1] (www.inse.ru [144.206.128.1]) by mail.inse.ru (Postfix) with ESMTP id 70F8533C4C; Tue, 15 May 2007 20:24:49 +0400 (MSD) Message-ID: <4649E0AD.4060705@inse.ru> Date: Tue, 15 May 2007 20:32:45 +0400 From: Roman Kurakin User-Agent: Thunderbird 1.5.0.10 (X11/20070302) MIME-Version: 1.0 To: freebsd-current@freebsd.org Content-Type: multipart/mixed; boundary="------------050703030404090706030209" X-Mailman-Approved-At: Tue, 15 May 2007 17:06:55 +0000 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: pjd@FreeBSD.org, freebsd-geom@freebsd.org, msmith@FreeBSD.org, mdodd@FreeBSD.org, phk@FreeBSD.org, grog@FreeBSD.org, jlemon@FreeBSD.org, mjacob@FreeBSD.org, sos@FreeBSD.org Subject: HEDSUP: man -k cleanup (man -k RAID, some bits are missing) X-BeenThere: freebsd-geom@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: GEOM-specific discussions and implementations List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2007 16:42:16 -0000 This is a multi-part message in MIME format. --------------050703030404090706030209 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Hi all, Trying to obtain information about supported RAID devices in the system via `man -k RAID` I've found that not all known by me devices are there. So a grep-ed a bit and going to commit the following patchset. I think that keyword RAID should present in description of all these man pages. But may be I am wrong? There is also some bits I was not able to fix. 1) Is it safe to s/Array/RAID/ in ida(4)? 2) Is it safe to mark ciss as driver for RAID controllers? 3) Should be isp(4) marked as driver for RAID controllers? 4) Should geom(4) be patched as suggested in my patch or it is enough of mentioning in corresponding class utilities? 5) Have I missed smth else? PS. I think that there is other such places where `man -k` is not complete, so its good todo idea, currently not for me ;-). PPS. Sorry for crossposting. I hope I included all affected parties. rik Index: sbin/geom/class/concat/gconcat.8 =================================================================== RCS file: /home/ncvs/src/sbin/geom/class/concat/gconcat.8,v retrieving revision 1.18 diff -u -r1.18 gconcat.8 --- sbin/geom/class/concat/gconcat.8 30 Jan 2006 22:47:07 -0000 1.18 +++ sbin/geom/class/concat/gconcat.8 15 May 2007 15:55:59 -0000 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm gconcat -.Nd "disk concatenation control utility" +.Nd "disk concatenation control utility (software RAID capability)" .Sh SYNOPSIS .Nm .Cm create Index: sbin/geom/class/mirror/gmirror.8 =================================================================== RCS file: /home/ncvs/src/sbin/geom/class/mirror/gmirror.8,v retrieving revision 1.23 diff -u -r1.23 gmirror.8 --- sbin/geom/class/mirror/gmirror.8 21 Dec 2006 18:30:23 -0000 1.23 +++ sbin/geom/class/mirror/gmirror.8 15 May 2007 15:56:00 -0000 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm gmirror -.Nd "control utility for mirrored devices" +.Nd "control utility for mirrored devices (software RAID1 capability)" .Sh SYNOPSIS .Nm .Cm label Index: sbin/gvinum/gvinum.8 =================================================================== RCS file: /home/ncvs/src/sbin/gvinum/gvinum.8,v retrieving revision 1.4 diff -u -r1.4 gvinum.8 --- sbin/gvinum/gvinum.8 30 Sep 2006 11:02:17 -0000 1.4 +++ sbin/gvinum/gvinum.8 15 May 2007 15:56:00 -0000 @@ -33,7 +33,7 @@ .Os .Sh NAME .Nm gvinum -.Nd Logical Volume Manager control program +.Nd Logical Volume Manager control program (software RAID capability) .Sh SYNOPSIS .Nm .Op Ar command Index: share/man/man4/asr.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/asr.4,v retrieving revision 1.24 diff -u -r1.24 asr.4 --- share/man/man4/asr.4 2 Aug 2004 23:33:15 -0000 1.24 +++ share/man/man4/asr.4 15 May 2007 15:56:00 -0000 @@ -11,7 +11,7 @@ .Os .Sh NAME .Nm asr -.Nd driver for Adaptec I2O based SCSI/ATA host bus adapters +.Nd driver for Adaptec I2O based SCSI/ATA RAID host bus adapters .Sh SYNOPSIS .Cd "device asr" .Sh DESCRIPTION Index: share/man/man4/ccd.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/ccd.4,v retrieving revision 1.32 diff -u -r1.32 ccd.4 --- share/man/man4/ccd.4 14 Apr 2006 09:20:24 -0000 1.32 +++ share/man/man4/ccd.4 15 May 2007 15:56:01 -0000 @@ -39,7 +39,7 @@ .Os .Sh NAME .Nm ccd -.Nd Concatenated Disk driver +.Nd Concatenated Disk driver (software RAID capability) .Sh SYNOPSIS .Cd "device ccd" .Sh DESCRIPTION Index: share/man/man4/geom.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/geom.4,v retrieving revision 1.16 diff -u -r1.16 geom.4 --- share/man/man4/geom.4 25 May 2006 13:39:27 -0000 1.16 +++ share/man/man4/geom.4 15 May 2007 15:56:01 -0000 @@ -39,7 +39,8 @@ .Dt GEOM 4 .Sh NAME .Nm GEOM -.Nd "modular disk I/O request transformation framework" +.Nd "modular disk I/O request transformation framework (software RAID \ +capability)" .Sh DESCRIPTION The .Nm Index: share/man/man4/mpt.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/mpt.4,v retrieving revision 1.15 diff -u -r1.15 mpt.4 --- share/man/man4/mpt.4 7 Apr 2007 04:01:00 -0000 1.15 +++ share/man/man4/mpt.4 15 May 2007 15:56:01 -0000 @@ -40,7 +40,7 @@ .Os .Sh NAME .Nm mpt -.Nd LSI Fusion-MPT SCSI/Fibre Channel driver +.Nd LSI Fusion-MPT SCSI/Fibre Channel driver with RAID capability .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your Index: share/man/man4/pst.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/pst.4,v retrieving revision 1.5 diff -u -r1.5 pst.4 --- share/man/man4/pst.4 20 May 2006 09:39:28 -0000 1.5 +++ share/man/man4/pst.4 15 May 2007 15:56:01 -0000 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm pst -.Nd device driver for Promise Supertrak SX6000 +.Nd device driver for Promise Supertrak SX6000 RAID adapter .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your Index: share/man/man4/vinum.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/vinum.4,v retrieving revision 1.52 diff -u -r1.52 vinum.4 --- share/man/man4/vinum.4 11 Jun 2006 19:41:07 -0000 1.52 +++ share/man/man4/vinum.4 15 May 2007 15:56:02 -0000 @@ -41,7 +41,7 @@ .Os .Sh NAME .Nm vinum -.Nd Logical Volume Manager +.Nd Logical Volume Manager (software RAID capability) .Sh SYNOPSIS .Cd "device vinum" .Sh DESCRIPTION --------------050703030404090706030209--