1.\" 2.\" Copyright (c) 2000 Michael Smith 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. The name of the author may not be used to endorse or promote products 11.\" derived from this software without specific prior written permission 12.\" 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 14.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 15.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 16.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 17.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 18.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 19.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 20.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 21.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 22.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 23.\" 24.\" $FreeBSD$ 25.\" 26.Dd April 10, 2000 27.Dt MLXCONTROL 8 28.Os 29.Sh NAME 30.Nm mlxcontrol 31.Nd Mylex DAC-family RAID management utility 32.Sh SYNOPSIS 33.Nm 34.Aq command 35.Op args 36.Nm 37status 38.Op Fl qv 39.Op Ar drive 40.Nm 41rescan 42.Ar controller 43.Op Ar controller ... 44.Nm 45detach 46.Ar drive 47.Op Ar drive ... 48.Nm 49detach 50.Fl a 51.Nm 52check 53.Ar drive 54.Nm 55config 56.Ar controller 57.Nm 58help 59.Ar command 60.Sh DESCRIPTION 61The 62.Nm 63utility provides status monitoring and management functions 64for devices attached 65to the 66.Xr mlx 4 67driver. 68.Pp 69Controller names are of the form "mlxN" 70where N is the unit number of the controller. 71Drive names are of the form "mlxdN" 72where N is the unit number of the drive. 73Do not specify the path to a device node. 74.Pp 75.Bl -tag -width rebuild 76.It status 77Print the status of controllers and system drives. 78If one or more drives are specified, 79only print information about these drives, 80otherwise print information 81about all controllers and drives in the system. 82With the 83.Fl v 84flag, display much more verbose information. 85With the 86.Fl q 87flag, do not print any output. 88This command returns 890 if all drives tested are online, 901 if one or more drives are critical and 912 if one or more are offline. 92.It rescan 93Rescan one or more controllers for non-attached system drives 94(e.g.\& drives that have been 95detached or created subsequent to driver initialisation). 96If the 97.Fl a 98flag is supplied, rescan all controllers in the system. 99.It detach 100Detach one or more system drives. 101Drives must be unmounted 102and not opened by any other utility for this command to succeed. 103If the 104.Fl a 105flag is supplied, detach all system drives from the nominated controller. 106.It check 107Initiate a consistency check and repair pass on a redundant system drive 108(e.g.\& RAID1 or RAID5). 109The controller will scan the system drive and repair any inconsistencies. 110This command returns immediately; 111use the 112.Ar status 113command to monitor the progress of the check. 114.It rebuild 115Requires two arguments, 116.Ar controller 117and 118.Ar physdrive 119as specified in the 120output of the 121.Ar status 122command. 123All system drives using space on the physical drive 124.Ar physdrive 125are rebuilt, reconstructing all data on the drive. 126Note that each controller can only perform one rebuild at a time. 127This command returns immediately; use the 128.Ar status 129command to monitor the progress of the rebuild. 130.It config 131Print the current configuration from the nominated controller. 132This command will be updated 133to allow addition/deletion of system drives from a configuration 134in a future release. 135.It help 136Print usage information for 137.Ar command . 138.El 139.Sh AUTHORS 140The mlxcontrol utility was written by 141.An Michael Smith 142.Aq msmith@FreeBSD.org . 143.Sh BUGS 144The 145.Ar config 146command does not yet support modifying system drive configuration. 147.Pp 148Error log extraction is not yet supported. 149