xref: /freebsd/sys/dev/mpt/mpt_debug.c (revision 815b7436a7c6302365b6514194d27d41cb736227)
1 /*-
2  * Debug routines for LSI '909 FC  adapters.
3  * FreeBSD Version.
4  *
5  * SPDX-License-Identifier: BSD-2-Clause AND BSD-3-Clause
6  *
7  * Copyright (c)  2000, 2001 by Greg Ansley
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice immediately at the beginning of the file, without modification,
14  *    this list of conditions, and the following disclaimer.
15  * 2. The name of the author may not be used to endorse or promote products
16  *    derived from this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
22  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  *
30  */
31 /*-
32  * Copyright (c) 2002, 2006 by Matthew Jacob
33  * All rights reserved.
34  *
35  * Redistribution and use in source and binary forms, with or without
36  * modification, are permitted provided that the following conditions are
37  * met:
38  * 1. Redistributions of source code must retain the above copyright
39  *    notice, this list of conditions and the following disclaimer.
40  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
41  *    substantially similar to the "NO WARRANTY" disclaimer below
42  *    ("Disclaimer") and any redistribution must be conditioned upon including
43  *    a substantially similar Disclaimer requirement for further binary
44  *    redistribution.
45  * 3. Neither the names of the above listed copyright holders nor the names
46  *    of any contributors may be used to endorse or promote products derived
47  *    from this software without specific prior written permission.
48  *
49  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
50  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
53  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
54  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
55  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
56  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
57  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
58  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF THE COPYRIGHT
59  * OWNER OR CONTRIBUTOR IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
60  *
61  * Support from Chris Ellsworth in order to make SAS adapters work
62  * is gratefully acknowledged.
63  *
64  * Support from LSI-Logic has also gone a great deal toward making this a
65  * workable subsystem and is gratefully acknowledged.
66  */
67 
68 #include <sys/cdefs.h>
69 #include <dev/mpt/mpt.h>
70 
71 #include <dev/mpt/mpilib/mpi_ioc.h>
72 #include <dev/mpt/mpilib/mpi_init.h>
73 #include <dev/mpt/mpilib/mpi_fc.h>
74 #include <dev/mpt/mpilib/mpi_targ.h>
75 
76 #include <cam/scsi/scsi_all.h>
77 
78 #include <machine/stdarg.h>	/* for use by mpt_prt below */
79 
80 struct Error_Map {
81 	int 	 Error_Code;
82 	char    *Error_String;
83 };
84 
85 static const struct Error_Map IOC_Status[] = {
86 { MPI_IOCSTATUS_SUCCESS,                  "Success" },
87 { MPI_IOCSTATUS_INVALID_FUNCTION,         "IOC: Invalid Function" },
88 { MPI_IOCSTATUS_BUSY,                     "IOC: Busy" },
89 { MPI_IOCSTATUS_INVALID_SGL,              "IOC: Invalid SGL" },
90 { MPI_IOCSTATUS_INTERNAL_ERROR,           "IOC: Internal Error" },
91 { MPI_IOCSTATUS_RESERVED,                 "IOC: Reserved" },
92 { MPI_IOCSTATUS_INSUFFICIENT_RESOURCES,   "IOC: Insufficient Resources" },
93 { MPI_IOCSTATUS_INVALID_FIELD,            "IOC: Invalid Field" },
94 { MPI_IOCSTATUS_INVALID_STATE,            "IOC: Invalid State" },
95 { MPI_IOCSTATUS_CONFIG_INVALID_ACTION,    "Invalid Action" },
96 { MPI_IOCSTATUS_CONFIG_INVALID_TYPE,      "Invalid Type" },
97 { MPI_IOCSTATUS_CONFIG_INVALID_PAGE,      "Invalid Page" },
98 { MPI_IOCSTATUS_CONFIG_INVALID_DATA,      "Invalid Data" },
99 { MPI_IOCSTATUS_CONFIG_NO_DEFAULTS,       "No Defaults" },
100 { MPI_IOCSTATUS_CONFIG_CANT_COMMIT,       "Can't Commit" },
101 { MPI_IOCSTATUS_SCSI_RECOVERED_ERROR,     "SCSI: Recoverd Error" },
102 { MPI_IOCSTATUS_SCSI_INVALID_BUS,         "SCSI: Invalid Bus" },
103 { MPI_IOCSTATUS_SCSI_INVALID_TARGETID,    "SCSI: Invalid Target ID" },
104 { MPI_IOCSTATUS_SCSI_DEVICE_NOT_THERE,    "SCSI: Device Not There" },
105 { MPI_IOCSTATUS_SCSI_DATA_OVERRUN,        "SCSI: Data Overrun" },
106 { MPI_IOCSTATUS_SCSI_DATA_UNDERRUN,       "SCSI: Data Underrun" },
107 { MPI_IOCSTATUS_SCSI_IO_DATA_ERROR,       "SCSI: Data Error" },
108 { MPI_IOCSTATUS_SCSI_PROTOCOL_ERROR,      "SCSI: Protocol Error" },
109 { MPI_IOCSTATUS_SCSI_TASK_TERMINATED,     "SCSI: Task Terminated" },
110 { MPI_IOCSTATUS_SCSI_RESIDUAL_MISMATCH,   "SCSI: Residual Mismatch" },
111 { MPI_IOCSTATUS_SCSI_TASK_MGMT_FAILED,    "SCSI: Task Management Failed" },
112 { MPI_IOCSTATUS_SCSI_IOC_TERMINATED,      "SCSI: IOC Bus Reset" },
113 { MPI_IOCSTATUS_SCSI_EXT_TERMINATED,      "SCSI: External Bus Reset" },
114 { MPI_IOCSTATUS_TARGET_PRIORITY_IO,       "SCSI Target: Priority I/O" },
115 { MPI_IOCSTATUS_TARGET_INVALID_PORT,      "SCSI Target: Invalid Port" },
116 { MPI_IOCSTATUS_TARGET_INVALID_IOCINDEX,  "SCSI Target: Invalid IOC Index" },
117 { MPI_IOCSTATUS_TARGET_ABORTED,           "SCSI Target: Aborted" },
118 { MPI_IOCSTATUS_TARGET_NO_CONN_RETRYABLE, "SCSI Target: No Connection (Retryable)" },
119 { MPI_IOCSTATUS_TARGET_NO_CONNECTION,     "SCSI Target: No Connection" },
120 { MPI_IOCSTATUS_TARGET_XFER_COUNT_MISMATCH,"SCSI Target: Transfer Count Mismatch" },
121 { MPI_IOCSTATUS_TARGET_FC_ABORTED,        "FC: Aborted" },
122 { MPI_IOCSTATUS_TARGET_FC_RX_ID_INVALID,  "FC: Receive ID Invalid" },
123 { MPI_IOCSTATUS_TARGET_FC_DID_INVALID,    "FC: Receive DID Invalid" },
124 { MPI_IOCSTATUS_TARGET_FC_NODE_LOGGED_OUT,"FC: Node Logged Out" },
125 { MPI_IOCSTATUS_LAN_DEVICE_NOT_FOUND,     "LAN: Device Not Found" },
126 { MPI_IOCSTATUS_LAN_DEVICE_FAILURE,       "LAN: Device Not Failure" },
127 { MPI_IOCSTATUS_LAN_TRANSMIT_ERROR,       "LAN: Transmit Error" },
128 { MPI_IOCSTATUS_LAN_TRANSMIT_ABORTED,     "LAN: Transmit Aborted" },
129 { MPI_IOCSTATUS_LAN_RECEIVE_ERROR,        "LAN: Receive Error" },
130 { MPI_IOCSTATUS_LAN_RECEIVE_ABORTED,      "LAN: Receive Aborted" },
131 { MPI_IOCSTATUS_LAN_PARTIAL_PACKET,       "LAN: Partial Packet" },
132 { MPI_IOCSTATUS_LAN_CANCELED,             "LAN: Canceled" },
133 { -1, 0},
134 };
135 
136 static const struct Error_Map IOC_Func[] = {
137 { MPI_FUNCTION_SCSI_IO_REQUEST,              "SCSI IO Request" },
138 { MPI_FUNCTION_SCSI_TASK_MGMT,               "SCSI Task Management" },
139 { MPI_FUNCTION_IOC_INIT,                     "IOC Init" },
140 { MPI_FUNCTION_IOC_FACTS,                    "IOC Facts" },
141 { MPI_FUNCTION_CONFIG,                       "Config" },
142 { MPI_FUNCTION_PORT_FACTS,                   "Port Facts" },
143 { MPI_FUNCTION_PORT_ENABLE,                  "Port Enable" },
144 { MPI_FUNCTION_EVENT_NOTIFICATION,           "Event Notification" },
145 { MPI_FUNCTION_EVENT_ACK,                    "Event Ack" },
146 { MPI_FUNCTION_FW_DOWNLOAD,                  "FW Download" },
147 { MPI_FUNCTION_TARGET_CMD_BUFFER_POST,       "SCSI Target Command Buffer" },
148 { MPI_FUNCTION_TARGET_ASSIST,                "Target Assist" },
149 { MPI_FUNCTION_TARGET_STATUS_SEND,           "Target Status Send" },
150 { MPI_FUNCTION_TARGET_MODE_ABORT,            "Target Mode Abort" },
151 { -1, 0},
152 };
153 
154 static const struct Error_Map IOC_Event[] = {
155 { MPI_EVENT_NONE,   	                "None" },
156 { MPI_EVENT_LOG_DATA,                   "LogData" },
157 { MPI_EVENT_STATE_CHANGE,               "State Change" },
158 { MPI_EVENT_UNIT_ATTENTION,             "Unit Attention" },
159 { MPI_EVENT_IOC_BUS_RESET,              "IOC Bus Reset" },
160 { MPI_EVENT_EXT_BUS_RESET,              "External Bus Reset" },
161 { MPI_EVENT_RESCAN,        	        "Rescan" },
162 { MPI_EVENT_LINK_STATUS_CHANGE,	        "Link Status Change" },
163 { MPI_EVENT_LOOP_STATE_CHANGE, 	        "Loop State Change" },
164 { MPI_EVENT_LOGOUT,    	       		"Logout" },
165 { MPI_EVENT_EVENT_CHANGE,               "EventChange" },
166 { -1, 0},
167 };
168 
169 static const struct Error_Map IOC_SCSIState[] = {
170 { MPI_SCSI_STATE_AUTOSENSE_VALID,	"AutoSense_Valid" },
171 { MPI_SCSI_STATE_AUTOSENSE_FAILED,	"AutoSense_Failed" },
172 { MPI_SCSI_STATE_NO_SCSI_STATUS,	"No_SCSI_Status" },
173 { MPI_SCSI_STATE_TERMINATED,	   	"State_Terminated" },
174 { MPI_SCSI_STATE_RESPONSE_INFO_VALID,	"Repsonse_Info_Valid" },
175 { MPI_SCSI_STATE_QUEUE_TAG_REJECTED,	"Queue Tag Rejected" },
176 { -1, 0},
177 };
178 
179 static const struct Error_Map IOC_SCSIStatus[] = {
180 { SCSI_STATUS_OK,			"OK" },
181 { SCSI_STATUS_CHECK_COND,		"Check Condition" },
182 { SCSI_STATUS_COND_MET,			"Check Condition Met" },
183 { SCSI_STATUS_BUSY,			"Busy" },
184 { SCSI_STATUS_INTERMED,			"Intermediate Condition" },
185 { SCSI_STATUS_INTERMED_COND_MET,	"Intermediate Condition Met" },
186 { SCSI_STATUS_RESERV_CONFLICT,		"Reservation Conflict" },
187 { SCSI_STATUS_CMD_TERMINATED,		"Command Terminated" },
188 { SCSI_STATUS_QUEUE_FULL,		"Queue Full" },
189 { -1, 0},
190 };
191 
192 static const struct Error_Map IOC_Diag[] = {
193 { MPI_DIAG_DRWE,		"DWE" },
194 { MPI_DIAG_FLASH_BAD_SIG,	"FLASH_Bad" },
195 { MPI_DIAGNOSTIC_OFFSET,	"Offset" },
196 { MPI_DIAG_RESET_ADAPTER,	"Reset" },
197 { MPI_DIAG_DISABLE_ARM,		"DisARM" },
198 { MPI_DIAG_MEM_ENABLE,		"DME" },
199 { -1, 0 },
200 };
201 
202 static const struct Error_Map IOC_SCSITMType[] = {
203 { MPI_SCSITASKMGMT_TASKTYPE_ABORT_TASK,		"Abort Task" },
204 { MPI_SCSITASKMGMT_TASKTYPE_ABRT_TASK_SET,	"Abort Task Set" },
205 { MPI_SCSITASKMGMT_TASKTYPE_TARGET_RESET,	"Target Reset" },
206 { MPI_SCSITASKMGMT_TASKTYPE_RESET_BUS,		"Reset Bus" },
207 { MPI_SCSITASKMGMT_TASKTYPE_LOGICAL_UNIT_RESET,	"Logical Unit Reset" },
208 { -1, 0 },
209 };
210 
211 static char *
212 mpt_ioc_status(int code)
213 {
214 	const struct Error_Map *status = IOC_Status;
215 	static char buf[64];
216 	while (status->Error_Code >= 0) {
217 		if (status->Error_Code == (code & MPI_IOCSTATUS_MASK))
218 			return status->Error_String;
219 		status++;
220 	}
221 	snprintf(buf, sizeof buf, "Unknown (0x%08x)", code);
222 	return buf;
223 }
224 
225 char *
226 mpt_ioc_diag(u_int32_t code)
227 {
228 	const struct Error_Map *status = IOC_Diag;
229 	static char buf[128];
230 	char *ptr = buf;
231 	char *end = &buf[128];
232 	buf[0] = '\0';
233 	ptr += snprintf(buf, sizeof buf, "(0x%08x)", code);
234 	while (status->Error_Code >= 0) {
235 		if ((status->Error_Code & code) != 0)
236 			ptr += snprintf(ptr, (size_t)(end-ptr), "%s ",
237 				status->Error_String);
238 		status++;
239 	}
240 	return buf;
241 }
242 
243 static char *
244 mpt_ioc_function(int code)
245 {
246 	const struct Error_Map *status = IOC_Func;
247 	static char buf[64];
248 	while (status->Error_Code >= 0) {
249 		if (status->Error_Code == code)
250 			return status->Error_String;
251 		status++;
252 	}
253 	snprintf(buf, sizeof buf, "Unknown (0x%08x)", code);
254 	return buf;
255 }
256 
257 static char *
258 mpt_ioc_event(int code)
259 {
260 	const struct Error_Map *status = IOC_Event;
261 	static char buf[64];
262 	while (status->Error_Code >= 0) {
263 		if (status->Error_Code == code)
264 			return status->Error_String;
265 		status++;
266 	}
267 	snprintf(buf, sizeof buf, "Unknown (0x%08x)", code);
268 	return buf;
269 }
270 
271 static char *
272 mpt_scsi_state(int code)
273 {
274 	const struct Error_Map *status = IOC_SCSIState;
275 	static char buf[128];
276 	char *ptr = buf;
277 	char *end = &buf[128];
278 	buf[0] = '\0';
279 	ptr += snprintf(buf, sizeof buf, "(0x%08x)", code);
280 	while (status->Error_Code >= 0) {
281 		if ((status->Error_Code & code) != 0)
282 			ptr += snprintf(ptr, (size_t)(end-ptr), "%s ",
283 				status->Error_String);
284 		status++;
285 	}
286 	return buf;
287 }
288 
289 static char *
290 mpt_scsi_status(int code)
291 {
292 	const struct Error_Map *status = IOC_SCSIStatus;
293 	static char buf[64];
294 	while (status->Error_Code >= 0) {
295 		if (status->Error_Code == code)
296 			return status->Error_String;
297 		status++;
298 	}
299 	snprintf(buf, sizeof buf, "Unknown (0x%08x)", code);
300 	return buf;
301 }
302 
303 static const char *
304 mpt_who(int who_init)
305 {
306 	const char *who;
307 
308 	switch (who_init) {
309 	case MPT_DB_INIT_NOONE:       who = "No One";        break;
310 	case MPT_DB_INIT_BIOS:        who = "BIOS";          break;
311 	case MPT_DB_INIT_ROMBIOS:     who = "ROM BIOS";      break;
312 	case MPT_DB_INIT_PCIPEER:     who = "PCI Peer";      break;
313 	case MPT_DB_INIT_HOST:        who = "Host Driver";   break;
314 	case MPT_DB_INIT_MANUFACTURE: who = "Manufacturing"; break;
315 	default:                      who = "Unknown";       break;
316 	}
317 	return who;
318 }
319 
320 static const char *
321 mpt_state(u_int32_t mb)
322 {
323 	const char *text;
324 
325 	switch (MPT_STATE(mb)) {
326 		case MPT_DB_STATE_RESET:  text = "Reset";   break;
327 		case MPT_DB_STATE_READY:  text = "Ready";   break;
328 		case MPT_DB_STATE_RUNNING:text = "Running"; break;
329 		case MPT_DB_STATE_FAULT:  text = "Fault";   break;
330 		default: 		  text = "Unknown"; break;
331 	}
332 	return text;
333 }
334 
335 static char *
336 mpt_scsi_tm_type(int code)
337 {
338 	const struct Error_Map *status = IOC_SCSITMType;
339 	static char buf[64];
340 	while (status->Error_Code >= 0) {
341 		if (status->Error_Code == code)
342 			return status->Error_String;
343 		status++;
344 	}
345 	snprintf(buf, sizeof buf, "Unknown (0x%08x)", code);
346 	return buf;
347 }
348 
349 void
350 mpt_print_db(u_int32_t mb)
351 {
352 
353 	printf("mpt mailbox: (0x%x) State %s  WhoInit %s\n",
354 	    mb, mpt_state(mb), mpt_who(MPT_WHO(mb)));
355 }
356 
357 /*****************************************************************************/
358 /*  Reply functions                                                          */
359 /*****************************************************************************/
360 static void
361 mpt_print_reply_hdr(MSG_DEFAULT_REPLY *msg)
362 {
363 
364 	printf("%s Reply @ %p\n", mpt_ioc_function(msg->Function), msg);
365 	printf("\tIOC Status    %s\n", mpt_ioc_status(msg->IOCStatus));
366 	printf("\tIOCLogInfo    0x%08x\n", msg->IOCLogInfo);
367 	printf("\tMsgLength     0x%02x\n", msg->MsgLength);
368 	printf("\tMsgFlags      0x%02x\n", msg->MsgFlags);
369 	printf("\tMsgContext    0x%08x\n", msg->MsgContext);
370 }
371 
372 static void
373 mpt_print_init_reply(MSG_IOC_INIT_REPLY *msg)
374 {
375 
376 	mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
377 	printf("\tWhoInit       %s\n", mpt_who(msg->WhoInit));
378 	printf("\tMaxDevices    0x%02x\n", msg->MaxDevices);
379 	printf("\tMaxBuses     0x%02x\n", msg->MaxBuses);
380 }
381 
382 static void
383 mpt_print_ioc_facts(MSG_IOC_FACTS_REPLY *msg)
384 {
385 
386 	mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
387 	printf("\tIOCNumber     %d\n",		msg->IOCNumber);
388 	printf("\tMaxChainDepth %d\n",		msg->MaxChainDepth);
389 	printf("\tWhoInit       %s\n",		mpt_who(msg->WhoInit));
390 	printf("\tBlockSize     %d\n",		msg->BlockSize);
391 	printf("\tFlags         %d\n",		msg->Flags);
392 	printf("\tReplyQueueDepth %d\n",	msg->ReplyQueueDepth);
393 	printf("\tReqFrameSize  0x%04x\n",	msg->RequestFrameSize);
394 	printf("\tFW Version    0x%08x\n",	msg->FWVersion.Word);
395 	printf("\tProduct ID    0x%04x\n",	msg->ProductID);
396 	printf("\tCredits       0x%04x\n",	msg->GlobalCredits);
397 	printf("\tPorts         %d\n",		msg->NumberOfPorts);
398 	printf("\tEventState    0x%02x\n",	msg->EventState);
399 	printf("\tHostMFA_HA    0x%08x\n",	msg->CurrentHostMfaHighAddr);
400 	printf("\tSenseBuf_HA   0x%08x\n",
401 	    msg->CurrentSenseBufferHighAddr);
402 	printf("\tRepFrameSize  0x%04x\n",	msg->CurReplyFrameSize);
403 	printf("\tMaxDevices    0x%02x\n",	msg->MaxDevices);
404 	printf("\tMaxBuses      0x%02x\n",	msg->MaxBuses);
405 	printf("\tFWImageSize   0x%04x\n",	msg->FWImageSize);
406 }
407 
408 static void
409 mpt_print_enable_reply(MSG_PORT_ENABLE_REPLY *msg)
410 {
411 
412 	mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
413 	printf("\tPort:         %d\n", msg->PortNumber);
414 }
415 
416 static void
417 mpt_print_scsi_io_reply(MSG_SCSI_IO_REPLY *msg)
418 {
419 
420 	mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
421 	printf("\tBus:          %d\n", msg->Bus);
422 	printf("\tTargetID      %d\n", msg->TargetID);
423 	printf("\tCDBLength     %d\n", msg->CDBLength);
424 	printf("\tSCSI Status:  %s\n", mpt_scsi_status(msg->SCSIStatus));
425 	printf("\tSCSI State:   %s\n", mpt_scsi_state(msg->SCSIState));
426 	printf("\tTransferCnt   0x%04x\n", msg->TransferCount);
427 	printf("\tSenseCnt      0x%04x\n", msg->SenseCount);
428 	printf("\tResponseInfo  0x%08x\n", msg->ResponseInfo);
429 }
430 
431 static void
432 mpt_print_event_notice(MSG_EVENT_NOTIFY_REPLY *msg)
433 {
434 
435 	mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
436 	printf("\tEvent:        %s\n", mpt_ioc_event(msg->Event));
437 	printf("\tEventContext  0x%04x\n", msg->EventContext);
438 	printf("\tAckRequired     %d\n", msg->AckRequired);
439 	printf("\tEventDataLength %d\n", msg->EventDataLength);
440 	printf("\tContinuation    %d\n", msg->MsgFlags & 0x80);
441 	switch(msg->Event) {
442 	case MPI_EVENT_LOG_DATA:
443 		printf("\tEvtLogData:   0x%04x\n", msg->Data[0]);
444 		break;
445 
446 	case MPI_EVENT_UNIT_ATTENTION:
447 		printf("\tTargetID:     0x%04x\n",
448 			msg->Data[0] & 0xff);
449 		printf("\tBus:          0x%04x\n",
450 			(msg->Data[0] >> 8) & 0xff);
451 		break;
452 
453 	case MPI_EVENT_IOC_BUS_RESET:
454 	case MPI_EVENT_EXT_BUS_RESET:
455 	case MPI_EVENT_RESCAN:
456 		printf("\tPort:           %d\n",
457 			(msg->Data[0] >> 8) & 0xff);
458 		break;
459 
460 	case MPI_EVENT_LINK_STATUS_CHANGE:
461 		printf("\tLinkState:    %d\n",
462 			msg->Data[0] & 0xff);
463 		printf("\tPort:         %d\n",
464 			(msg->Data[1] >> 8) & 0xff);
465 		break;
466 
467 	case MPI_EVENT_LOOP_STATE_CHANGE:
468 		printf("\tType:         %d\n",
469 			(msg->Data[0] >> 16) & 0xff);
470 		printf("\tChar3:      0x%02x\n",
471 			(msg->Data[0] >> 8) & 0xff);
472 		printf("\tChar4:      0x%02x\n",
473 			(msg->Data[0]     ) & 0xff);
474 		printf("\tPort:         %d\n",
475 			(msg->Data[1] >> 8) & 0xff);
476 		break;
477 
478 	case MPI_EVENT_LOGOUT:
479 		printf("\tN_PortId:   0x%04x\n", msg->Data[0]);
480 		printf("\tPort:         %d\n",
481 			(msg->Data[1] >> 8) & 0xff);
482 		break;
483 	}
484 
485 }
486 
487 void
488 mpt_print_reply(void *vmsg)
489 {
490 	MSG_DEFAULT_REPLY *msg = vmsg;
491 
492 	switch (msg->Function) {
493 	case MPI_FUNCTION_EVENT_NOTIFICATION:
494 		mpt_print_event_notice((MSG_EVENT_NOTIFY_REPLY *)msg);
495 		break;
496 	case MPI_FUNCTION_PORT_ENABLE:
497 		mpt_print_enable_reply((MSG_PORT_ENABLE_REPLY *)msg);
498 		break;
499 	case MPI_FUNCTION_IOC_FACTS:
500 		mpt_print_ioc_facts((MSG_IOC_FACTS_REPLY *)msg);
501 		break;
502 	case MPI_FUNCTION_IOC_INIT:
503 		mpt_print_init_reply((MSG_IOC_INIT_REPLY *)msg);
504 		break;
505 	case MPI_FUNCTION_SCSI_IO_REQUEST:
506 	case MPI_FUNCTION_RAID_SCSI_IO_PASSTHROUGH:
507 		mpt_print_scsi_io_reply((MSG_SCSI_IO_REPLY *)msg);
508 		break;
509 	default:
510 		mpt_print_reply_hdr((MSG_DEFAULT_REPLY *)msg);
511 		break;
512 	}
513 }
514 
515 /*****************************************************************************/
516 /*  Request functions                                                        */
517 /*****************************************************************************/
518 static void
519 mpt_print_request_hdr(MSG_REQUEST_HEADER *req)
520 {
521 
522 	printf("%s @ %p\n", mpt_ioc_function(req->Function), req);
523 	printf("\tChain Offset  0x%02x\n", req->ChainOffset);
524 	printf("\tMsgFlags      0x%02x\n", req->MsgFlags);
525 	printf("\tMsgContext    0x%08x\n", req->MsgContext);
526 }
527 
528 static void
529 mpt_print_scsi_io_request(MSG_SCSI_IO_REQUEST *orig_msg)
530 {
531 	MSG_SCSI_IO_REQUEST local, *msg = &local;
532 	int i;
533 
534 	bcopy(orig_msg, msg, sizeof (MSG_SCSI_IO_REQUEST));
535 	mpt_print_request_hdr((MSG_REQUEST_HEADER *)msg);
536 	printf("\tBus:                %d\n", msg->Bus);
537 	printf("\tTargetID            %d\n", msg->TargetID);
538 	printf("\tSenseBufferLength   %d\n", msg->SenseBufferLength);
539 	printf("\tLUN:              0x%jx\n", (uintmax_t)be64dec(msg->LUN));
540 	printf("\tControl           0x%08x ", msg->Control);
541 #define MPI_PRINT_FIELD(x)						\
542 	case MPI_SCSIIO_CONTROL_ ## x :					\
543 		printf(" " #x " ");					\
544 		break
545 
546 	switch (msg->Control & MPI_SCSIIO_CONTROL_DATADIRECTION_MASK) {
547 	MPI_PRINT_FIELD(NODATATRANSFER);
548 	MPI_PRINT_FIELD(WRITE);
549 	MPI_PRINT_FIELD(READ);
550 	default:
551 		printf(" Invalid DIR! ");
552 		break;
553 	}
554 	switch (msg->Control & MPI_SCSIIO_CONTROL_TASKATTRIBUTE_MASK) {
555 	MPI_PRINT_FIELD(SIMPLEQ);
556 	MPI_PRINT_FIELD(HEADOFQ);
557 	MPI_PRINT_FIELD(ORDEREDQ);
558 	MPI_PRINT_FIELD(ACAQ);
559 	MPI_PRINT_FIELD(UNTAGGED);
560 	MPI_PRINT_FIELD(NO_DISCONNECT);
561 	default:
562 		printf(" Unknown attribute! ");
563 		break;
564 	}
565 
566 	printf("\n");
567 #undef MPI_PRINT_FIELD
568 
569 	printf("\tDataLength\t0x%08x\n", msg->DataLength);
570 	printf("\tSenseBufAddr\t0x%08x\n", msg->SenseBufferLowAddr);
571 	printf("\tCDB[0:%d]\t", msg->CDBLength);
572 	for (i = 0; i < msg->CDBLength; i++)
573 		printf("%02x ", msg->CDB[i]);
574 	printf("\n");
575 
576 	if ((msg->Control & MPI_SCSIIO_CONTROL_DATADIRECTION_MASK) !=
577 	   MPI_SCSIIO_CONTROL_NODATATRANSFER ) {
578 		mpt_dump_sgl(&orig_msg->SGL,
579 		    ((char *)&orig_msg->SGL)-(char *)orig_msg);
580 	}
581 }
582 
583 static void
584 mpt_print_scsi_tmf_request(MSG_SCSI_TASK_MGMT *msg)
585 {
586 
587 	mpt_print_request_hdr((MSG_REQUEST_HEADER *)msg);
588 	printf("\tLun             0x%jx\n", (uintmax_t)be64dec(msg->LUN));
589 	printf("\tTaskType        %s\n", mpt_scsi_tm_type(msg->TaskType));
590 	printf("\tTaskMsgContext  0x%08x\n", msg->TaskMsgContext);
591 }
592 
593 static void
594 mpt_print_scsi_target_assist_request(PTR_MSG_TARGET_ASSIST_REQUEST msg)
595 {
596 
597 	mpt_print_request_hdr((MSG_REQUEST_HEADER *)msg);
598 	printf("\tStatusCode    0x%02x\n", msg->StatusCode);
599 	printf("\tTargetAssist  0x%02x\n", msg->TargetAssistFlags);
600 	printf("\tQueueTag      0x%04x\n", msg->QueueTag);
601 	printf("\tReplyWord     0x%08x\n", msg->ReplyWord);
602 	printf("\tLun           0x%jx\n", (uintmax_t)be64dec(msg->LUN));
603 	printf("\tRelativeOff   0x%08x\n", msg->RelativeOffset);
604 	printf("\tDataLength    0x%08x\n", msg->DataLength);
605 	mpt_dump_sgl(msg->SGL, 0);
606 }
607 
608 static void
609 mpt_print_scsi_target_status_send_request(MSG_TARGET_STATUS_SEND_REQUEST *msg)
610 {
611 	SGE_IO_UNION x;
612 
613 	mpt_print_request_hdr((MSG_REQUEST_HEADER *)msg);
614 	printf("\tStatusCode    0x%02x\n", msg->StatusCode);
615 	printf("\tStatusFlags   0x%02x\n", msg->StatusFlags);
616 	printf("\tQueueTag      0x%04x\n", msg->QueueTag);
617 	printf("\tReplyWord     0x%08x\n", msg->ReplyWord);
618 	printf("\tLun           0x%jx\n", (uintmax_t)be64dec(msg->LUN));
619 	x.u.Simple = msg->StatusDataSGE;
620 	mpt_dump_sgl(&x, 0);
621 }
622 
623 void
624 mpt_print_request(void *vreq)
625 {
626 	MSG_REQUEST_HEADER *req = vreq;
627 
628 	switch (req->Function) {
629 	case MPI_FUNCTION_SCSI_IO_REQUEST:
630 	case MPI_FUNCTION_RAID_SCSI_IO_PASSTHROUGH:
631 		mpt_print_scsi_io_request((MSG_SCSI_IO_REQUEST *)req);
632 		break;
633 	case MPI_FUNCTION_SCSI_TASK_MGMT:
634 		mpt_print_scsi_tmf_request((MSG_SCSI_TASK_MGMT *)req);
635 		break;
636 	case MPI_FUNCTION_TARGET_ASSIST:
637 		mpt_print_scsi_target_assist_request(
638 		    (PTR_MSG_TARGET_ASSIST_REQUEST)req);
639 		break;
640 	case MPI_FUNCTION_TARGET_STATUS_SEND:
641 		mpt_print_scsi_target_status_send_request(
642 		    (MSG_TARGET_STATUS_SEND_REQUEST *)req);
643 		break;
644 	default:
645 		mpt_print_request_hdr(req);
646 		break;
647 	}
648 }
649 
650 #if 0
651 typedef struct mpt_decode_entry {
652 	char    *name;
653 	u_int	 value;
654 	u_int	 mask;
655 } mpt_decode_entry_t;
656 
657 static int
658 mpt_decode_value(mpt_decode_entry_t *table, u_int num_entries,
659 		 const char *name, u_int value, u_int *cur_column,
660 		 u_int wrap_point)
661 {
662         int     printed;
663         u_int   printed_mask;
664 	u_int	dummy_column;
665 
666 	if (cur_column == NULL) {
667 		dummy_column = 0;
668 		cur_column = &dummy_column;
669 	}
670 
671 	if (*cur_column >= wrap_point) {
672 		printf("\n");
673 		*cur_column = 0;
674 	}
675 	printed = printf("%s[0x%x]", name, value);
676 	if (table == NULL) {
677 		printed += printf(" ");
678 		*cur_column += printed;
679 		return (printed);
680 	}
681 	printed_mask = 0;
682 	while (printed_mask != 0xFF) {
683 		int entry;
684 
685 		for (entry = 0; entry < num_entries; entry++) {
686 			if (((value & table[entry].mask)
687 			  != table[entry].value)
688 			 || ((printed_mask & table[entry].mask)
689 			  == table[entry].mask))
690 				continue;
691 
692 			printed += printf("%s%s",
693 					  printed_mask == 0 ? ":(" : "|",
694 					  table[entry].name);
695 			printed_mask |= table[entry].mask;
696 			break;
697                 }
698 		if (entry >= num_entries)
699 			break;
700         }
701         if (printed_mask != 0)
702 		printed += printf(") ");
703         else
704 		printed += printf(" ");
705 	*cur_column += printed;
706 	return (printed);
707 }
708 
709 static const mpt_decode_entry_t req_state_parse_table[] = {
710 	{ "REQ_FREE",		0x00, 0xff },
711 	{ "REQ_ALLOCATED",	0x01, 0x01 },
712 	{ "REQ_QUEUED",		0x02, 0x02 },
713 	{ "REQ_DONE",		0x04, 0x04 },
714 	{ "REQ_TIMEDOUT",	0x08, 0x08 },
715 	{ "REQ_NEED_WAKEUP",	0x10, 0x10 }
716 };
717 
718 static void
719 mpt_req_state(mpt_req_state_t state)
720 {
721 
722 	mpt_decode_value(req_state_parse_table,
723 			 NUM_ELEMENTS(req_state_parse_table),
724 			 "REQ_STATE", state, NULL, 80);
725 }
726 #endif
727 
728 #define	LAST_SGE	(		\
729 	MPI_SGE_FLAGS_END_OF_LIST |	\
730 	MPI_SGE_FLAGS_END_OF_BUFFER|	\
731 	MPI_SGE_FLAGS_LAST_ELEMENT)
732 void
733 mpt_dump_sgl(SGE_IO_UNION *su, int offset)
734 {
735 	SGE_SIMPLE32 *se = (SGE_SIMPLE32 *) su;
736 	const char allfox[4] = { 0xff, 0xff, 0xff, 0xff };
737 	void *nxtaddr = se;
738 	void *lim;
739 	int flags;
740 
741 	/*
742 	 * Can't be any bigger than this.
743 	 */
744 	lim = &((char *)se)[MPT_REQUEST_AREA - offset];
745 
746 	do {
747 		int iprt;
748 
749 		printf("\t");
750 		if (memcmp(se, allfox, 4) == 0) {
751 			uint32_t *nxt = (uint32_t *)se;
752 			printf("PAD  %p\n", se);
753 			nxtaddr = nxt + 1;
754 			se = nxtaddr;
755 			flags = 0;
756 			continue;
757 		}
758 		nxtaddr = se + 1;
759 		flags = MPI_SGE_GET_FLAGS(se->FlagsLength);
760 		switch (flags & MPI_SGE_FLAGS_ELEMENT_MASK) {
761 		case MPI_SGE_FLAGS_SIMPLE_ELEMENT:
762 			if (flags & MPI_SGE_FLAGS_64_BIT_ADDRESSING) {
763 				SGE_SIMPLE64 *se64 = (SGE_SIMPLE64 *)se;
764 				printf("SE64 %p: Addr=0x%08x%08x FlagsLength"
765 				    "=0x%0x\n", se64, se64->Address.High,
766 				    se64->Address.Low, se64->FlagsLength);
767 				nxtaddr = se64 + 1;
768 			} else {
769 				printf("SE32 %p: Addr=0x%0x FlagsLength=0x%0x"
770 	                            "\n", se, se->Address, se->FlagsLength);
771 			}
772 			printf(" ");
773 			break;
774 		case MPI_SGE_FLAGS_CHAIN_ELEMENT:
775 			if (flags & MPI_SGE_FLAGS_64_BIT_ADDRESSING) {
776 				SGE_CHAIN64 *ce64 = (SGE_CHAIN64 *) se;
777 				printf("CE64 %p: Addr=0x%08x%08x NxtChnO=0x%x "
778 				    "Flgs=0x%x Len=0x%0x\n", ce64,
779 				    ce64->Address.High, ce64->Address.Low,
780 				    ce64->NextChainOffset,
781 				    ce64->Flags, ce64->Length);
782 				nxtaddr = ce64 + 1;
783 			} else {
784 				SGE_CHAIN32 *ce = (SGE_CHAIN32 *) se;
785 				printf("CE32 %p: Addr=0x%0x NxtChnO=0x%x "
786 				    " Flgs=0x%x Len=0x%0x\n", ce, ce->Address,
787 				    ce->NextChainOffset, ce->Flags, ce->Length);
788 			}
789 			flags = 0;
790 			break;
791 		case MPI_SGE_FLAGS_TRANSACTION_ELEMENT:
792 			printf("TE32 @ %p\n", se);
793 			flags = 0;
794 			break;
795 		}
796 		iprt = 0;
797 #define MPT_PRINT_FLAG(x)						\
798 		if (flags & MPI_SGE_FLAGS_ ## x ) { 			\
799 			if (iprt == 0) {				\
800 				printf("\t");				\
801 			}						\
802 			printf(" ");					\
803 			printf( #x );					\
804 			iprt++;						\
805 		}
806 		MPT_PRINT_FLAG(LOCAL_ADDRESS);
807 		MPT_PRINT_FLAG(HOST_TO_IOC);
808 		MPT_PRINT_FLAG(64_BIT_ADDRESSING);
809 		MPT_PRINT_FLAG(LAST_ELEMENT);
810 		MPT_PRINT_FLAG(END_OF_BUFFER);
811 		MPT_PRINT_FLAG(END_OF_LIST);
812 #undef MPT_PRINT_FLAG
813 		if (iprt)
814 			printf("\n");
815 		se = nxtaddr;
816 		if ((flags & LAST_SGE) == LAST_SGE) {
817 			break;
818 		}
819 	} while ((flags & MPI_SGE_FLAGS_END_OF_LIST) == 0 && nxtaddr < lim);
820 }
821 
822 void
823 mpt_dump_data(struct mpt_softc *mpt, const char *msg, void *addr, int len)
824 {
825 	int offset;
826 	uint8_t *cp = addr;
827 
828 	mpt_prt(mpt, "%s:", msg);
829 	for (offset = 0; offset < len; offset++) {
830 		if ((offset & 0xf) == 0) {
831 			mpt_prtc(mpt, "\n");
832 		}
833 		mpt_prtc(mpt, " %02x", cp[offset]);
834 	}
835 	mpt_prtc(mpt, "\n");
836 }
837 
838 void
839 mpt_dump_request(struct mpt_softc *mpt, request_t *req)
840 {
841         uint32_t *pReq = req->req_vbuf;
842 	int o;
843 
844 	mpt_prt(mpt, "Send Request %d (%jx):",
845 	    req->index, (uintmax_t) req->req_pbuf);
846 	for (o = 0; o < mpt->ioc_facts.RequestFrameSize; o++) {
847 		if ((o & 0x7) == 0) {
848 			mpt_prtc(mpt, "\n");
849 			mpt_prt(mpt, " ");
850 		}
851 		mpt_prtc(mpt, " %08x", pReq[o]);
852 	}
853 	mpt_prtc(mpt, "\n");
854 }
855 
856 void
857 mpt_prt(struct mpt_softc *mpt, const char *fmt, ...)
858 {
859 	va_list ap;
860 
861 	printf("%s: ", device_get_nameunit(mpt->dev));
862 	va_start(ap, fmt);
863 	vprintf(fmt, ap);
864 	va_end(ap);
865 }
866 
867 void
868 mpt_prtc(struct mpt_softc *mpt, const char *fmt, ...)
869 {
870 	va_list ap;
871 
872 	va_start(ap, fmt);
873 	vprintf(fmt, ap);
874 	va_end(ap);
875 }
876