1038ec875SJeroen Ruigrok van der Werven.\" 2038ec875SJeroen Ruigrok van der Werven.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven 39b58ae86SMike Smith.\" Copyright (c) 2000 Michael Smith 4038ec875SJeroen Ruigrok van der Werven.\" All rights reserved. 5038ec875SJeroen Ruigrok van der Werven.\" 6038ec875SJeroen Ruigrok van der Werven.\" Redistribution and use in source and binary forms, with or without 7038ec875SJeroen Ruigrok van der Werven.\" modification, are permitted provided that the following conditions 8038ec875SJeroen Ruigrok van der Werven.\" are met: 9038ec875SJeroen Ruigrok van der Werven.\" 1. Redistributions of source code must retain the above copyright 10038ec875SJeroen Ruigrok van der Werven.\" notice, this list of conditions and the following disclaimer. 11038ec875SJeroen Ruigrok van der Werven.\" 2. The name of the author may not be used to endorse or promote products 12038ec875SJeroen Ruigrok van der Werven.\" derived from this software without specific prior written permission 13038ec875SJeroen Ruigrok van der Werven.\" 14038ec875SJeroen Ruigrok van der Werven.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 15038ec875SJeroen Ruigrok van der Werven.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 16038ec875SJeroen Ruigrok van der Werven.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17038ec875SJeroen Ruigrok van der Werven.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 18038ec875SJeroen Ruigrok van der Werven.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 19038ec875SJeroen Ruigrok van der Werven.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 20038ec875SJeroen Ruigrok van der Werven.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 21038ec875SJeroen Ruigrok van der Werven.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22038ec875SJeroen Ruigrok van der Werven.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 23038ec875SJeroen Ruigrok van der Werven.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24038ec875SJeroen Ruigrok van der Werven.\" 25038ec875SJeroen Ruigrok van der Werven.\" $FreeBSD$ 26038ec875SJeroen Ruigrok van der Werven.\" 279b58ae86SMike Smith.Dd April 10, 2000 28038ec875SJeroen Ruigrok van der Werven.Dt MLX 4 29038ec875SJeroen Ruigrok van der Werven.Os 30038ec875SJeroen Ruigrok van der Werven.Sh NAME 31038ec875SJeroen Ruigrok van der Werven.Nm mlx 329b58ae86SMike Smith.Nd Mylex DAC-family RAID driver 33038ec875SJeroen Ruigrok van der Werven.Sh SYNOPSIS 34cda5a90fSJeroen Ruigrok van der Werven.Cd device pci 35038ec875SJeroen Ruigrok van der Werven.Cd device mlx 36038ec875SJeroen Ruigrok van der Werven.Sh DESCRIPTION 37038ec875SJeroen Ruigrok van der WervenThe 38038ec875SJeroen Ruigrok van der Werven.Nm 399b58ae86SMike Smithdriver provides support for Mylex DAC-family PCI to SCSI RAID controllers, 40f60eac6fSSheldon Hearnincluding versions relabelled by Digital/Compaq. 41f60eac6fSSheldon HearnSupported controllers include: 429b58ae86SMike Smith.Bl -bullet 439b58ae86SMike Smith.It 449b58ae86SMike SmithDAC960P 459b58ae86SMike Smith.It 469b58ae86SMike SmithDAC960PD 479b58ae86SMike Smith.It 489b58ae86SMike SmithDAC960PL 499b58ae86SMike Smith.It 509b58ae86SMike SmithDAC960PJ 519b58ae86SMike Smith.It 529b58ae86SMike SmithDAC960PG 539b58ae86SMike Smith.It 549b58ae86SMike SmithAcceleRAID 150 559b58ae86SMike Smith.It 569b58ae86SMike SmithAcceleRAID 250 579b58ae86SMike Smith.It 589b58ae86SMike SmitheXtremeRAID 1100 599b58ae86SMike Smith.El 60038ec875SJeroen Ruigrok van der Werven.Pp 619b58ae86SMike SmithAll major firmware revisions (2.x, 3.x, 4.x and 5.x) are supported, however 629b58ae86SMike Smithit is always advisable to upgrade to the most recent firmware available for the 639b58ae86SMike Smithcontroller. 649b58ae86SMike Smith.Pp 659b58ae86SMike SmithCompatible Mylex controllers not listed should work, but have not been 669b58ae86SMike Smithverified. 679b58ae86SMike Smith.Sh DIAGNOSTICS 689b58ae86SMike SmithController initialisation phase: 699b58ae86SMike Smith.Bl -diag 709b58ae86SMike Smith.It mlx%d: controller initialisation in progress... 719b58ae86SMike Smith.It mlx%d: initialisation complete 729b58ae86SMike Smith.El 739b58ae86SMike Smith.Pp 749b58ae86SMike SmithThe controller firmware is performing/has completed initialisation. 759b58ae86SMike Smith.Bl -diag 769b58ae86SMike Smith.It mlx%d: physical drive %d:%d not responding 779b58ae86SMike Smith.El 789b58ae86SMike Smith.Pp 799b58ae86SMike SmithThe drive at channel:target is not responding; it may have failed or 809b58ae86SMike Smithbeen removed. 819b58ae86SMike Smith.Bl -diag 829b58ae86SMike Smith.It mlx%d: spinning up drives... 839b58ae86SMike Smith.El 849b58ae86SMike Smith.Pp 859b58ae86SMike SmithDrive startup is in progress; this may take several minutes. 869b58ae86SMike Smith.Bl -diag 879b58ae86SMike Smith.It mlx%d: configuration checksum error 889b58ae86SMike Smith.El 899b58ae86SMike Smith.Pp 909b58ae86SMike SmithThe array configuration has become corrupted. 919b58ae86SMike Smith.Bl -diag 929b58ae86SMike Smith.It mlx%d: mirror race recovery in progress 939b58ae86SMike Smith.It mlx%d: mirror race on a critical system drive 949b58ae86SMike Smith.It mlx%d: mirror race recovery failed 959b58ae86SMike Smith.El 969b58ae86SMike Smith.Pp 979b58ae86SMike SmithThese error codes are undocumented. 989b58ae86SMike Smith.Bl -diag 999b58ae86SMike Smith.It mlx%d: physical drive %d:%d COD mismatch 1009b58ae86SMike Smith.El 1019b58ae86SMike Smith.Pp 1029b58ae86SMike SmithConfiguration data on the drive at channel:target does not match the 1039b58ae86SMike Smithrest of the array. 1049b58ae86SMike Smith.Bl -diag 1059b58ae86SMike Smith.It mlx%d: system drive installation aborted 1069b58ae86SMike Smith.El 1079b58ae86SMike Smith.Pp 1089b58ae86SMike SmithErrors occured preventing one or more system drives from being configured. 1099b58ae86SMike Smith.Bl -diag 1109b58ae86SMike Smith.It mlx%d: new controller configuration found 1119b58ae86SMike Smith.El 1129b58ae86SMike Smith.Pp 1139b58ae86SMike SmithThe controller has detected a configuration on disk which supersedes the 114f60eac6fSSheldon Hearnconfiguration in its nonvolatile memory. 115f60eac6fSSheldon HearnIt will reset and come up with the new configuration. 1169b58ae86SMike Smith.Bl -diag 1179b58ae86SMike Smith.It mlx%d: FATAL MEMORY PARITY ERROR 1189b58ae86SMike Smith.El 1199b58ae86SMike Smith.Pp 1209b58ae86SMike SmithFirmware detected a fatal memory error; the driver will not attempt to 1219b58ae86SMike Smithattach to this controller. 1229b58ae86SMike Smith.Bl -diag 1239b58ae86SMike Smith.It mlx%d: unknown firmware initialisation error %x:%x:%x 1249b58ae86SMike Smith.El 1259b58ae86SMike Smith.Pp 1269b58ae86SMike SmithAn unknown error occurred during initialisation; it will be ignored. 1279b58ae86SMike Smith.Pp 1289b58ae86SMike SmithDriver initialisation/shutdown phase: 1299b58ae86SMike Smith.Bl -diag 1309b58ae86SMike Smith.It mlx%d: can't allocate scatter/gather DMA tag 1319b58ae86SMike Smith.It mlx%d: can't allocate buffer DMA tag 1329b58ae86SMike Smith.It mlx%d: can't allocate s/g table 1339b58ae86SMike Smith.It mlx%d: can't make initial s/g list mapping 1349b58ae86SMike Smith.It mlx%d: can't make permanent s/g list mapping 1359b58ae86SMike Smith.It mlx%d: can't allocate interrupt 1369b58ae86SMike Smith.It mlx%d: can't set up interrupt 1379b58ae86SMike Smith.El 1389b58ae86SMike Smith.Pp 1399b58ae86SMike SmithA resource allocation error occurred while initialising the driver; 1409b58ae86SMike Smithinitialisation has failed and the driver will not attach to this 1419b58ae86SMike Smithcontroller. 1429b58ae86SMike Smith.Bl -diag 1439b58ae86SMike Smith.It mlx%d: error fetching drive status 1449b58ae86SMike Smith.El 1459b58ae86SMike Smith.Pp 1469b58ae86SMike SmithThe current status of all system drives could not be fetched; attachment 1479b58ae86SMike Smithof system drives will be aborted. 1489b58ae86SMike Smith.Bl -diag 1499b58ae86SMike Smith.It mlx%d: device_add_child failed 1509b58ae86SMike Smith.It mlx%d: bus_generic_attach returned %d 1519b58ae86SMike Smith.El 1529b58ae86SMike Smith.Pp 1539b58ae86SMike SmithCreation of the system drive instances failed; attachment of one or more 1549b58ae86SMike Smithsystem drives may have been aborted. 1559b58ae86SMike Smith.Bl -diag 1569b58ae86SMike Smith.It mlxd%d: detaching... 1579b58ae86SMike Smith.El 1589b58ae86SMike Smith.Pp 1599b58ae86SMike SmithThe indicated system drive is being detached. 1609b58ae86SMike Smith.Bl -diag 1619b58ae86SMike Smith.It mlxd%d: still open, can't detach 1629b58ae86SMike Smith.El 1639b58ae86SMike Smith.Pp 1649b58ae86SMike SmithThe indicated system drive is still open or mounted; the controller cannot be detached. 1659b58ae86SMike Smith.Bl -diag 1669b58ae86SMike Smith.It mlx%d: flushing cache... 1679b58ae86SMike Smith.El 1689b58ae86SMike Smith.Pp 1699b58ae86SMike SmithThe controller cache is being flushed prior to detach or shutdown. 1709b58ae86SMike Smith.Pp 1719b58ae86SMike SmithOperational diagnostics: 1729b58ae86SMike Smith.Bl -diag 1739b58ae86SMike Smith.It mlx%d: ENQUIRY failed - %s 1749b58ae86SMike Smith.It mlx%d: ENQUIRY2 failed 1759b58ae86SMike Smith.It mlx%d: ENQUIRY_OLD failed 1769b58ae86SMike Smith.It mlx%d: FLUSH failed - %s 1779b58ae86SMike Smith.It mlx%d: CHECK ASYNC failed - %s 1789b58ae86SMike Smith.It mlx%d: REBUILD ASYNC failed - %s 1799b58ae86SMike Smith.It mlx%d: command failed - %s 1809b58ae86SMike Smith.El 1819b58ae86SMike Smith.Pp 1829b58ae86SMike SmithThe controller rejected a command for the reason given. 1839b58ae86SMike Smith.Bl -diag 1849b58ae86SMike Smith.It mlx%d: I/O beyond end of unit (%u,%d > %u) 1859b58ae86SMike Smith.It mlx%d: I/O error - %s 1869b58ae86SMike Smith.El 1879b58ae86SMike Smith.Pp 1889b58ae86SMike SmithAn I/O error was reported by the controller. 1899b58ae86SMike Smith.Bl -diag 1909b58ae86SMike Smith.It mlx%d: periodic enquiry failed - %s 1919b58ae86SMike Smith.El 1929b58ae86SMike Smith.Pp 1939b58ae86SMike SmithAn attempt to poll the controller for status failed for the reason given. 1949b58ae86SMike Smith.Bl -diag 1959b58ae86SMike Smith.It mlx%d: mlx_periodic_enquiry: unknown command %x 1969b58ae86SMike Smith.El 1979b58ae86SMike Smith.Pp 1989b58ae86SMike SmithThe periodic status poll has issued a command which has become corrupted. 1999b58ae86SMike Smith.Bl -diag 2009b58ae86SMike Smith.It mlxd%d: drive offline 2019b58ae86SMike Smith.It mlxd%d: drive online 2029b58ae86SMike Smith.It mlxd%d: drive critical 2039b58ae86SMike Smith.El 2049b58ae86SMike Smith.Pp 2059b58ae86SMike SmithThe system disk indicated has changed state. 2069b58ae86SMike Smith.Bl -diag 2079b58ae86SMike Smith.It mlx%d: physical drive %d:%d reset 2089b58ae86SMike Smith.It mlx%d: physical drive %d:%d killed %s 2099b58ae86SMike Smith.It "mlx%d: physical drive %d:%d error log: sense = %d asc = %x asq = %x" 2109b58ae86SMike Smith.It "mlx%d: info %4D csi %4D" 2119b58ae86SMike Smith.El 2129b58ae86SMike Smith.Pp 2139b58ae86SMike SmithThe drive at channel:target has been reset, killed for the given reason, 2149b58ae86SMike Smithor experienced a SCSI error. 2159b58ae86SMike Smith.Bl -diag 2169b58ae86SMike Smith.It mlx%d: unknown log message type %x 2179b58ae86SMike Smith.It mlx%d: error reading message log - %s 2189b58ae86SMike Smith.El 2199b58ae86SMike Smith.Pp 2209b58ae86SMike SmithAn error occurred while trying to read the controller's message log. 2219b58ae86SMike Smith.Bl -diag 2229b58ae86SMike Smith.It mlxd%d: consistency check started 2239b58ae86SMike Smith.It mlx%d: consistency check completed 2249b58ae86SMike Smith.El 2259b58ae86SMike Smith.Pp 2269b58ae86SMike SmithA user-initiated consistency check has started/completed. 2279b58ae86SMike Smith.Bl -diag 2289b58ae86SMike Smith.It mlx%d: drive rebuild started for %d:%d 2299b58ae86SMike Smith.It mlx%d: drive rebuild completed 2309b58ae86SMike Smith.El 2319b58ae86SMike Smith.Pp 2329b58ae86SMike SmithA user-initiated physical drive rebuild has started/completed. 2339b58ae86SMike Smith.Bl -diag 2349b58ae86SMike Smith.It mlx%d: background check/rebuild operation started 2359b58ae86SMike Smith.It mlx%d: background check/rebuild operation completed 2369b58ae86SMike Smith.El 2379b58ae86SMike Smith.Pp 2389b58ae86SMike SmithAn automatic system drive consistency check or physical drive rebuild has started/completed. 2399b58ae86SMike Smith.Bl -diag 2409b58ae86SMike Smith.It mlx%d: channel %d pausing for %d seconds 2419b58ae86SMike Smith.It mlx%d: channel %d resuming 2429b58ae86SMike Smith.It mlx%d: pause command failed - %s 2439b58ae86SMike Smith.It mlx%d: pause failed for channel %d 2449b58ae86SMike Smith.It mlx%d: resume command failed - %s 2459b58ae86SMike Smith.It mlx%d: resume failed for channel %d 2469b58ae86SMike Smith.El 2479b58ae86SMike Smith.Pp 248f60eac6fSSheldon HearnController/channel pause operation notification. 249f60eac6fSSheldon Hearn(Channel pause is not currently supported on any controller.) 2509b58ae86SMike Smith.Bl -diag 2519b58ae86SMike Smith.It mlx%d: controller wedged (not taking commands) 2529b58ae86SMike Smith.El 2539b58ae86SMike Smith.Pp 2549b58ae86SMike SmithThe controller is not responding to attempts to submit new commands. 2559b58ae86SMike Smith.Bl -diag 2569b58ae86SMike Smith.It mlx%d: duplicate done event for slot %d 2579b58ae86SMike Smith.It mlx%d: done event for nonbusy slot %d 2589b58ae86SMike Smith.El 2599b58ae86SMike Smith.Pp 2609b58ae86SMike SmithCorruption has occurred in either the controller's onboard list of commands 2619b58ae86SMike Smithor in the driver. 262038ec875SJeroen Ruigrok van der Werven.Sh SEE ALSO 2639b58ae86SMike Smith.Xr mlxcontrol 8 2649b58ae86SMike Smith.Sh BUGS 2659b58ae86SMike SmithThe driver does not yet support EISA adapters. 2669b58ae86SMike Smith.Pp 2679b58ae86SMike SmithThe driver does not yet support the version 6.x firmware as found in the 2689b58ae86SMike SmithAcceleRAID 352 and eXtremeRAID 2000 and 3000 products. 269079f468aSJeroen Ruigrok van der Werven.Sh AUTHORS 270079f468aSJeroen Ruigrok van der WervenThe mlx driver was written by 2719b58ae86SMike Smith.An Michael Smith 2723d647f8bSMike Pritchard.Aq msmith@FreeBSD.org . 273079f468aSJeroen Ruigrok van der Werven.Pp 274079f468aSJeroen Ruigrok van der WervenThis manual page was written by 275079f468aSJeroen Ruigrok van der Werven.An Jeroen Ruigrok van der Werven 2769b58ae86SMike Smith.Aq asmodai@FreeBSD.org 2779b58ae86SMike Smithand 2789b58ae86SMike Smith.An Michael Smith 2799b58ae86SMike Smith.Aq msmith@FreeBSD.org . 2809b58ae86SMike Smith 281