[src/netbsd-1-6]: src/sbin/raidctl Pullup patch (requested by oster in ticket...

[jmc <jmc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/3b2669f50322
branches:  netbsd-1-6
changeset: 531290:3b2669f50322
user:      jmc <jmc%NetBSD.org@localhost>
date:      Fri Apr 09 18:24:49 2004 +0000

description:
Pullup patch (requested by oster in ticket #1555)

Add a couple little warnings about swapping to RAID 5 sets.

diffstat:

 sbin/raidctl/raidctl.8 |  20 +++++++++++++++++++-
 1 files changed, 19 insertions(+), 1 deletions(-)

diffs (38 lines):

diff -r c4df70be1d2e -r 3b2669f50322 sbin/raidctl/raidctl.8
--- a/sbin/raidctl/raidctl.8    Fri Apr 09 10:41:26 2004 +0000
+++ b/sbin/raidctl/raidctl.8    Fri Apr 09 18:24:49 2004 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: raidctl.8,v 1.29 2002/02/08 01:30:45 ross Exp $
+.\"     $NetBSD: raidctl.8,v 1.29.2.1 2004/04/09 18:24:49 jmc Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -1187,6 +1187,20 @@
 must be in the kernel configuration file.  See
 .Xr raid 4
 for more details.
+.Ss Swapping on RAID
+A RAID device can be used as a swap device.
+In order to ensure that a RAID device used as a swap device
+is correctly unconfigured when the system is shutdown or rebooted,
+it is recommended that the line
+.Bd -literal -offset indent
+swapoff=YES
+.Ed
+.Pp
+be added to
+.Pa /etc/rc.conf .
+.Pp
+Note: Swapping to a RAID 5 device is known to have problems, and is
+currently unsupported.
 .Ss Unconfiguration
 The final operation performed by
 .Nm
@@ -1416,3 +1430,7 @@
 0 there is no perception of increased data security.
 .Sh BUGS
 Hot-spare removal is currently not available.
+.Pp
+Swapping to a RAID 5 device is a good way to lockup your system, and
+use of a RAID 5 set as a swap device (or using a swap file in a
+filesystem on a RAID 5 set) is currently not supported.