From 97f1a629a66a313946bdb6130bc4b35ef74b8a02 Mon Sep 17 00:00:00 2001 From: grog Date: Tue, 5 Oct 1999 05:33:35 +0000 Subject: Bring in line with reality. --- share/man/man4/vinum.4 | 69 +++++++++++++++++++++++++++++++++++++------------- 1 file changed, 51 insertions(+), 18 deletions(-) (limited to 'share/man/man4/vinum.4') diff --git a/share/man/man4/vinum.4 b/share/man/man4/vinum.4 index c021370..de3dfb3 100644 --- a/share/man/man4/vinum.4 +++ b/share/man/man4/vinum.4 @@ -36,9 +36,8 @@ .\" .\" $FreeBSD$ .\" -.Dd 28 March 1999 -.Dt VINUM 4 -.Os +.Dd 5 October 1999 +.Dt vinum 4 .Sh NAME .Nm vinum .Nd Logical Volume Manager @@ -190,6 +189,13 @@ as described above. If the VINUMDEBUG variables do not match, vinum(8) will fail with a message explaining the problem and what to do to correct it. .Pp +.Nm +was previously available in two versions: a freely available version which did +not contain RAID-5 functionality, and a full version including RAID-5 +functionality, which was available only from Cybernet Systems Inc. The present +version of +.Nm +includes the RAID-5 functionality. .Sh RUNNING VINUM .Nm is part of the base FreeBSD system. It does not require installation. @@ -697,12 +703,9 @@ The drive is up and running. .Bl -enum .It .Nm -is a new product. Many bugs can be expected. The configuration mechanism is -not yet fully functional. If you have difficulties, please look at -.Pa http://www.lemis.com/vinum_beta.html -and -.Pa http://www.lemis.com/vinum_debugging.html -before reporting problems. +is a new product. Bugs can be expected. The configuration mechanism is not yet +fully functional. If you have difficulties, please look at the section +DEBUGGING PROBLEMS WITH VINUM before reporting problems. .It Kernels with the .Nm @@ -712,6 +715,14 @@ kernel and test with the kld module. .It Detection of differences between the version of the kernel and the kld is not yet implemented. +.It +The RAID-5 functionality is new in FreeBSD 3.3. Some problems have been +reported with +.Nm +in combination with soft updates, but these are not reproducible on all +systems. If you are planning to use +.Nm +in a production environment, please test carefully. .El .Sh DEBUGGING PROBLEMS WITH VINUM .Pp @@ -808,8 +819,11 @@ command if you have this kind of trouble. .Pp In order to analyse a panic which you suspect comes from .Nm -you will need to build a debug kernel. See the online handbook for more details -of how to do this. +you will need to build a debug kernel. See the online handbook at +.Pa /usr/share/doc/handbook/kerneldebug.html +(if installed) or +.Pa http://www.freebsd.org/handbook/kerneldebug.html +for more details of how to do this. .Pp Perform the following steps to analyse a .Nm @@ -959,19 +973,38 @@ For an initial investigation, the most important information is the output of the .Nm bt (backtrace) command above. -.Sh AUTHORS -.An Greg Lehey Aq grog@lemis.com +.Ss Reporting problems with Vinum +.Pp +If you find any bugs in +.Nm vinum , +please report them to Greg Lehey . Supply the following +information: +.Pp +.Bl -bullet +.It +The output of the +.Nm vinum list +command. +.It +Any messages printed in +.Pa /var/log/messages . +All such messages will be identified by the text +.Nm +at the beginning. +.It +If you have a panic, a stack trace as described above. +.El +.Sh AUTHOR +.An Greg Lehey Aq grog@lemis.com . .Sh HISTORY .Nm vinum -first appeared in -.Fx 3.0 . -The RAID-5 component of +first appeared in FreeBSD 3.0. The RAID-5 component of .Nm was developed by Cybernet Inc. .Pa www.cybernet.com for its NetMAX product. .Sh SEE ALSO +.Xr vinum 8 , .Xr disklabel 5 , .Xr disklabel 8 , -.Xr newfs 8 , -.Xr vinum 8 . +.Xr newfs 8 . -- cgit v1.1