xref: /freebsd/sys/cam/cam.c (revision 3393f8daa3b4b18786cd585c1a37aa16dd03d410)
18b8a9b1dSJustin T. Gibbs /*
28b8a9b1dSJustin T. Gibbs  * Generic utility routines for the Common Access Method layer.
38b8a9b1dSJustin T. Gibbs  *
48b8a9b1dSJustin T. Gibbs  * Copyright (c) 1997 Justin T. Gibbs.
58b8a9b1dSJustin T. Gibbs  * All rights reserved.
68b8a9b1dSJustin T. Gibbs  *
78b8a9b1dSJustin T. Gibbs  * Redistribution and use in source and binary forms, with or without
88b8a9b1dSJustin T. Gibbs  * modification, are permitted provided that the following conditions
98b8a9b1dSJustin T. Gibbs  * are met:
108b8a9b1dSJustin T. Gibbs  * 1. Redistributions of source code must retain the above copyright
118b8a9b1dSJustin T. Gibbs  *    notice, this list of conditions, and the following disclaimer,
128b8a9b1dSJustin T. Gibbs  *    without modification, immediately at the beginning of the file.
138b8a9b1dSJustin T. Gibbs  * 2. The name of the author may not be used to endorse or promote products
148b8a9b1dSJustin T. Gibbs  *    derived from this software without specific prior written permission.
158b8a9b1dSJustin T. Gibbs  *
168b8a9b1dSJustin T. Gibbs  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
178b8a9b1dSJustin T. Gibbs  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
188b8a9b1dSJustin T. Gibbs  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
198b8a9b1dSJustin T. Gibbs  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
208b8a9b1dSJustin T. Gibbs  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
218b8a9b1dSJustin T. Gibbs  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
228b8a9b1dSJustin T. Gibbs  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
238b8a9b1dSJustin T. Gibbs  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
248b8a9b1dSJustin T. Gibbs  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
258b8a9b1dSJustin T. Gibbs  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
268b8a9b1dSJustin T. Gibbs  * SUCH DAMAGE.
278b8a9b1dSJustin T. Gibbs  *
28c3aac50fSPeter Wemm  * $FreeBSD$
298b8a9b1dSJustin T. Gibbs  */
308b8a9b1dSJustin T. Gibbs #include <sys/param.h>
318b8a9b1dSJustin T. Gibbs 
323393f8daSKenneth D. Merry #ifdef _KERNEL
333393f8daSKenneth D. Merry #include <sys/systm.h>
343393f8daSKenneth D. Merry #else /* _KERNEL */
353393f8daSKenneth D. Merry #include <stdlib.h>
363393f8daSKenneth D. Merry #include <stdio.h>
373393f8daSKenneth D. Merry #endif /* _KERNEL */
383393f8daSKenneth D. Merry 
398b8a9b1dSJustin T. Gibbs #include <cam/cam.h>
403393f8daSKenneth D. Merry #include <cam/cam_ccb.h>
413393f8daSKenneth D. Merry #include <cam/scsi/scsi_all.h>
423393f8daSKenneth D. Merry #include <sys/sbuf.h>
433393f8daSKenneth D. Merry 
443393f8daSKenneth D. Merry #ifdef _KERNEL
453393f8daSKenneth D. Merry #include <sys/libkern.h>
463393f8daSKenneth D. Merry #include <cam/cam_xpt.h>
473393f8daSKenneth D. Merry #endif
483393f8daSKenneth D. Merry 
493393f8daSKenneth D. Merry static int	camstatusentrycomp(const void *key, const void *member);
503393f8daSKenneth D. Merry 
513393f8daSKenneth D. Merry const struct cam_status_entry cam_status_table[] = {
523393f8daSKenneth D. Merry 	{ CAM_REQ_INPROG,	 "CCB request is in progress"		     },
533393f8daSKenneth D. Merry 	{ CAM_REQ_CMP,		 "CCB request completed without error"	     },
543393f8daSKenneth D. Merry 	{ CAM_REQ_ABORTED,	 "CCB request aborted by the host"	     },
553393f8daSKenneth D. Merry 	{ CAM_UA_ABORT,		 "Unable to abort CCB request"		     },
563393f8daSKenneth D. Merry 	{ CAM_REQ_CMP_ERR,	 "CCB request completed with an error"	     },
573393f8daSKenneth D. Merry 	{ CAM_BUSY,		 "CAM subsytem is busy"			     },
583393f8daSKenneth D. Merry 	{ CAM_REQ_INVALID,	 "CCB request was invalid"		     },
593393f8daSKenneth D. Merry 	{ CAM_PATH_INVALID,	 "Supplied Path ID is invalid"		     },
603393f8daSKenneth D. Merry 	{ CAM_DEV_NOT_THERE,	 "Device Not Present"			     },
613393f8daSKenneth D. Merry 	{ CAM_UA_TERMIO,	 "Unable to terminate I/O CCB request"	     },
623393f8daSKenneth D. Merry 	{ CAM_SEL_TIMEOUT,	 "Selection Timeout"			     },
633393f8daSKenneth D. Merry 	{ CAM_CMD_TIMEOUT,	 "Command timeout"			     },
643393f8daSKenneth D. Merry 	{ CAM_SCSI_STATUS_ERROR, "SCSI Status Error"			     },
653393f8daSKenneth D. Merry 	{ CAM_MSG_REJECT_REC,	 "Message Reject Reveived"		     },
663393f8daSKenneth D. Merry 	{ CAM_SCSI_BUS_RESET,	 "SCSI Bus Reset Sent/Received"		     },
673393f8daSKenneth D. Merry 	{ CAM_UNCOR_PARITY,	 "Uncorrectable parity/CRC error"	     },
683393f8daSKenneth D. Merry 	{ CAM_AUTOSENSE_FAIL,	 "Auto-Sense Retrieval Failed"		     },
693393f8daSKenneth D. Merry 	{ CAM_NO_HBA,		 "No HBA Detected"			     },
703393f8daSKenneth D. Merry 	{ CAM_DATA_RUN_ERR,	 "Data Overrun error"			     },
713393f8daSKenneth D. Merry 	{ CAM_UNEXP_BUSFREE,	 "Unexpected Bus Free"			     },
723393f8daSKenneth D. Merry 	{ CAM_SEQUENCE_FAIL,	 "Target Bus Phase Sequence Failure"	     },
733393f8daSKenneth D. Merry 	{ CAM_CCB_LEN_ERR,	 "CCB length supplied is inadequate"	     },
743393f8daSKenneth D. Merry 	{ CAM_PROVIDE_FAIL,	 "Unable to provide requested capability"    },
753393f8daSKenneth D. Merry 	{ CAM_BDR_SENT,		 "SCSI BDR Message Sent"		     },
763393f8daSKenneth D. Merry 	{ CAM_REQ_TERMIO,	 "CCB request terminated by the host"	     },
773393f8daSKenneth D. Merry 	{ CAM_UNREC_HBA_ERROR,	 "Unrecoverable Host Bus Adapter Error"	     },
783393f8daSKenneth D. Merry 	{ CAM_REQ_TOO_BIG,	 "The request was too large for this host"   },
793393f8daSKenneth D. Merry 	{ CAM_REQUEUE_REQ,	 "Unconditionally Re-queue Request",	     },
803393f8daSKenneth D. Merry 	{ CAM_IDE,		 "Initiator Detected Error Message Received" },
813393f8daSKenneth D. Merry 	{ CAM_RESRC_UNAVAIL,	 "Resource Unavailable"			     },
823393f8daSKenneth D. Merry 	{ CAM_UNACKED_EVENT,	 "Unacknowledged Event by Host"		     },
833393f8daSKenneth D. Merry 	{ CAM_MESSAGE_RECV,	 "Message Received in Host Target Mode"	     },
843393f8daSKenneth D. Merry 	{ CAM_INVALID_CDB,	 "Invalid CDB received in Host Target Mode"  },
853393f8daSKenneth D. Merry 	{ CAM_LUN_INVALID,	 "Invalid Lun"				     },
863393f8daSKenneth D. Merry 	{ CAM_TID_INVALID,	 "Invalid Target ID"			     },
873393f8daSKenneth D. Merry 	{ CAM_FUNC_NOTAVAIL,	 "Function Not Available"		     },
883393f8daSKenneth D. Merry 	{ CAM_NO_NEXUS,		 "Nexus Not Established"		     },
893393f8daSKenneth D. Merry 	{ CAM_IID_INVALID,	 "Invalid Initiator ID"			     },
903393f8daSKenneth D. Merry 	{ CAM_CDB_RECVD,	 "CDB Received"				     },
913393f8daSKenneth D. Merry 	{ CAM_LUN_ALRDY_ENA,	 "LUN Already Enabled for Target Mode"	     },
923393f8daSKenneth D. Merry 	{ CAM_SCSI_BUSY,	 "SCSI Bus Busy"			     },
933393f8daSKenneth D. Merry };
943393f8daSKenneth D. Merry 
953393f8daSKenneth D. Merry const int num_cam_status_entries =
963393f8daSKenneth D. Merry     sizeof(cam_status_table)/sizeof(*cam_status_table);
978b8a9b1dSJustin T. Gibbs 
988b8a9b1dSJustin T. Gibbs void
998b8a9b1dSJustin T. Gibbs cam_strvis(u_int8_t *dst, const u_int8_t *src, int srclen, int dstlen)
1008b8a9b1dSJustin T. Gibbs {
1018b8a9b1dSJustin T. Gibbs 
10253b062d3SJustin T. Gibbs 	/* Trim leading/trailing spaces, nulls. */
1038b8a9b1dSJustin T. Gibbs 	while (srclen > 0 && src[0] == ' ')
1048b8a9b1dSJustin T. Gibbs 		src++, srclen--;
10553b062d3SJustin T. Gibbs 	while (srclen > 0
10653b062d3SJustin T. Gibbs 	    && (src[srclen-1] == ' ' || src[srclen-1] == '\0'))
1078b8a9b1dSJustin T. Gibbs 		srclen--;
1088b8a9b1dSJustin T. Gibbs 
1098b8a9b1dSJustin T. Gibbs 	while (srclen > 0 && dstlen > 1) {
1108b8a9b1dSJustin T. Gibbs 		u_int8_t *cur_pos = dst;
1118b8a9b1dSJustin T. Gibbs 
1128b8a9b1dSJustin T. Gibbs 		if (*src < 0x20 || *src >= 0x80) {
1138b8a9b1dSJustin T. Gibbs 			/* SCSI-II Specifies that these should never occur. */
1148b8a9b1dSJustin T. Gibbs 			/* non-printable character */
1158b8a9b1dSJustin T. Gibbs 			if (dstlen > 4) {
1168b8a9b1dSJustin T. Gibbs 				*cur_pos++ = '\\';
1178b8a9b1dSJustin T. Gibbs 				*cur_pos++ = ((*src & 0300) >> 6) + '0';
1188b8a9b1dSJustin T. Gibbs 				*cur_pos++ = ((*src & 0070) >> 3) + '0';
1198b8a9b1dSJustin T. Gibbs 				*cur_pos++ = ((*src & 0007) >> 0) + '0';
1208b8a9b1dSJustin T. Gibbs 			} else {
1218b8a9b1dSJustin T. Gibbs 				*cur_pos++ = '?';
1228b8a9b1dSJustin T. Gibbs 			}
1238b8a9b1dSJustin T. Gibbs 		} else {
1248b8a9b1dSJustin T. Gibbs 			/* normal character */
1258b8a9b1dSJustin T. Gibbs 			*cur_pos++ = *src;
1268b8a9b1dSJustin T. Gibbs 		}
1278b8a9b1dSJustin T. Gibbs 		src++;
1288b8a9b1dSJustin T. Gibbs 		srclen--;
1298b8a9b1dSJustin T. Gibbs 		dstlen -= cur_pos - dst;
1308b8a9b1dSJustin T. Gibbs 		dst = cur_pos;
1318b8a9b1dSJustin T. Gibbs 	}
1328b8a9b1dSJustin T. Gibbs 	*dst = '\0';
1338b8a9b1dSJustin T. Gibbs }
1348b8a9b1dSJustin T. Gibbs 
1358b8a9b1dSJustin T. Gibbs /*
1368b8a9b1dSJustin T. Gibbs  * Compare string with pattern, returning 0 on match.
1378b8a9b1dSJustin T. Gibbs  * Short pattern matches trailing blanks in name,
1388b8a9b1dSJustin T. Gibbs  * wildcard '*' in pattern matches rest of name,
1398b8a9b1dSJustin T. Gibbs  * wildcard '?' matches a single non-space character.
1408b8a9b1dSJustin T. Gibbs  */
1418b8a9b1dSJustin T. Gibbs int
1428b8a9b1dSJustin T. Gibbs cam_strmatch(const u_int8_t *str, const u_int8_t *pattern, int str_len)
1438b8a9b1dSJustin T. Gibbs {
1448b8a9b1dSJustin T. Gibbs 
1458b8a9b1dSJustin T. Gibbs 	while (*pattern != '\0'&& str_len > 0) {
1468b8a9b1dSJustin T. Gibbs 
1478b8a9b1dSJustin T. Gibbs 		if (*pattern == '*') {
1488b8a9b1dSJustin T. Gibbs 			return (0);
1498b8a9b1dSJustin T. Gibbs 		}
1508b8a9b1dSJustin T. Gibbs 		if ((*pattern != *str)
1518b8a9b1dSJustin T. Gibbs 		 && (*pattern != '?' || *str == ' ')) {
1528b8a9b1dSJustin T. Gibbs 			return (1);
1538b8a9b1dSJustin T. Gibbs 		}
1548b8a9b1dSJustin T. Gibbs 		pattern++;
1558b8a9b1dSJustin T. Gibbs 		str++;
1568b8a9b1dSJustin T. Gibbs 		str_len--;
1578b8a9b1dSJustin T. Gibbs 	}
1588b8a9b1dSJustin T. Gibbs 	while (str_len > 0 && *str++ == ' ')
1598b8a9b1dSJustin T. Gibbs 		str_len--;
1608b8a9b1dSJustin T. Gibbs 
1618b8a9b1dSJustin T. Gibbs 	return (str_len);
1628b8a9b1dSJustin T. Gibbs }
1638b8a9b1dSJustin T. Gibbs 
1648b8a9b1dSJustin T. Gibbs caddr_t
1658b8a9b1dSJustin T. Gibbs cam_quirkmatch(caddr_t target, caddr_t quirk_table, int num_entries,
1668b8a9b1dSJustin T. Gibbs 	       int entry_size, cam_quirkmatch_t *comp_func)
1678b8a9b1dSJustin T. Gibbs {
1688b8a9b1dSJustin T. Gibbs 	for (; num_entries > 0; num_entries--, quirk_table += entry_size) {
1698b8a9b1dSJustin T. Gibbs 		if ((*comp_func)(target, quirk_table) == 0)
1708b8a9b1dSJustin T. Gibbs 			return (quirk_table);
1718b8a9b1dSJustin T. Gibbs 	}
1728b8a9b1dSJustin T. Gibbs 	return (NULL);
1738b8a9b1dSJustin T. Gibbs }
1743393f8daSKenneth D. Merry 
1753393f8daSKenneth D. Merry const struct cam_status_entry*
1763393f8daSKenneth D. Merry cam_fetch_status_entry(cam_status status)
1773393f8daSKenneth D. Merry {
1783393f8daSKenneth D. Merry 	status &= CAM_STATUS_MASK;
1793393f8daSKenneth D. Merry 	return (bsearch(&status, &cam_status_table,
1803393f8daSKenneth D. Merry 			num_cam_status_entries,
1813393f8daSKenneth D. Merry 			sizeof(*cam_status_table),
1823393f8daSKenneth D. Merry 			camstatusentrycomp));
1833393f8daSKenneth D. Merry }
1843393f8daSKenneth D. Merry 
1853393f8daSKenneth D. Merry static int
1863393f8daSKenneth D. Merry camstatusentrycomp(const void *key, const void *member)
1873393f8daSKenneth D. Merry {
1883393f8daSKenneth D. Merry 	cam_status status;
1893393f8daSKenneth D. Merry 	const struct cam_status_entry *table_entry;
1903393f8daSKenneth D. Merry 
1913393f8daSKenneth D. Merry 	status = *(const cam_status *)key;
1923393f8daSKenneth D. Merry 	table_entry = (const struct cam_status_entry *)member;
1933393f8daSKenneth D. Merry 
1943393f8daSKenneth D. Merry 	return (status - table_entry->status_code);
1953393f8daSKenneth D. Merry }
1963393f8daSKenneth D. Merry 
1973393f8daSKenneth D. Merry 
1983393f8daSKenneth D. Merry #ifdef _KERNEL
1993393f8daSKenneth D. Merry char *
2003393f8daSKenneth D. Merry cam_error_string(union ccb *ccb, char *str, int str_len,
2013393f8daSKenneth D. Merry 		 cam_error_string_flags flags,
2023393f8daSKenneth D. Merry 		 cam_error_proto_flags proto_flags)
2033393f8daSKenneth D. Merry #else /* !_KERNEL */
2043393f8daSKenneth D. Merry char *
2053393f8daSKenneth D. Merry cam_error_string(struct cam_device *device, union ccb *ccb, char *str,
2063393f8daSKenneth D. Merry 		 int str_len, cam_error_string_flags flags,
2073393f8daSKenneth D. Merry 		 cam_error_proto_flags proto_flags)
2083393f8daSKenneth D. Merry #endif /* _KERNEL/!_KERNEL */
2093393f8daSKenneth D. Merry {
2103393f8daSKenneth D. Merry 	char path_str[64];
2113393f8daSKenneth D. Merry 	struct sbuf sb;
2123393f8daSKenneth D. Merry 
2133393f8daSKenneth D. Merry 	if ((ccb == NULL)
2143393f8daSKenneth D. Merry 	 || (str == NULL)
2153393f8daSKenneth D. Merry 	 || (str_len <= 0))
2163393f8daSKenneth D. Merry 		return(NULL);
2173393f8daSKenneth D. Merry 
2183393f8daSKenneth D. Merry 	if (flags == CAM_ESF_NONE)
2193393f8daSKenneth D. Merry 		return(NULL);
2203393f8daSKenneth D. Merry 
2213393f8daSKenneth D. Merry 	switch (ccb->ccb_h.func_code) {
2223393f8daSKenneth D. Merry 		case XPT_SCSI_IO:
2233393f8daSKenneth D. Merry 			switch (proto_flags & CAM_EPF_LEVEL_MASK) {
2243393f8daSKenneth D. Merry 			case CAM_EPF_NONE:
2253393f8daSKenneth D. Merry 				break;
2263393f8daSKenneth D. Merry 			case CAM_EPF_ALL:
2273393f8daSKenneth D. Merry 			case CAM_EPF_NORMAL:
2283393f8daSKenneth D. Merry 				proto_flags |= CAM_ESF_PRINT_SENSE;
2293393f8daSKenneth D. Merry 				/* FALLTHROUGH */
2303393f8daSKenneth D. Merry 			case CAM_EPF_MINIMAL:
2313393f8daSKenneth D. Merry 				proto_flags |= CAM_ESF_PRINT_STATUS;
2323393f8daSKenneth D. Merry 			default:
2333393f8daSKenneth D. Merry 				break;
2343393f8daSKenneth D. Merry 			}
2353393f8daSKenneth D. Merry 			break;
2363393f8daSKenneth D. Merry 		default:
2373393f8daSKenneth D. Merry 			break;
2383393f8daSKenneth D. Merry 	}
2393393f8daSKenneth D. Merry #ifdef _KERNEL
2403393f8daSKenneth D. Merry 	xpt_path_string(ccb->csio.ccb_h.path, path_str, sizeof(path_str));
2413393f8daSKenneth D. Merry #else /* !_KERNEL */
2423393f8daSKenneth D. Merry 	cam_path_string(device, path_str, sizeof(path_str));
2433393f8daSKenneth D. Merry #endif /* _KERNEL/!_KERNEL */
2443393f8daSKenneth D. Merry 
2453393f8daSKenneth D. Merry 	sbuf_new(&sb, str, str_len, 0);
2463393f8daSKenneth D. Merry 
2473393f8daSKenneth D. Merry 	if (flags & CAM_ESF_COMMAND) {
2483393f8daSKenneth D. Merry 
2493393f8daSKenneth D. Merry 		sbuf_cat(&sb, path_str);
2503393f8daSKenneth D. Merry 
2513393f8daSKenneth D. Merry 		switch (ccb->ccb_h.func_code) {
2523393f8daSKenneth D. Merry 		case XPT_SCSI_IO:
2533393f8daSKenneth D. Merry #ifdef _KERNEL
2543393f8daSKenneth D. Merry 			scsi_command_string(&ccb->csio, &sb);
2553393f8daSKenneth D. Merry #else /* !_KERNEL */
2563393f8daSKenneth D. Merry 			scsi_command_string(device, &ccb->csio, &sb);
2573393f8daSKenneth D. Merry #endif /* _KERNEL/!_KERNEL */
2583393f8daSKenneth D. Merry 			sbuf_printf(&sb, "\n");
2593393f8daSKenneth D. Merry 
2603393f8daSKenneth D. Merry 			break;
2613393f8daSKenneth D. Merry 		default:
2623393f8daSKenneth D. Merry 			break;
2633393f8daSKenneth D. Merry 		}
2643393f8daSKenneth D. Merry 	}
2653393f8daSKenneth D. Merry 
2663393f8daSKenneth D. Merry 	if (flags & CAM_ESF_CAM_STATUS) {
2673393f8daSKenneth D. Merry 		cam_status status;
2683393f8daSKenneth D. Merry 		const struct cam_status_entry *entry;
2693393f8daSKenneth D. Merry 
2703393f8daSKenneth D. Merry 		sbuf_cat(&sb, path_str);
2713393f8daSKenneth D. Merry 
2723393f8daSKenneth D. Merry 		status = ccb->ccb_h.status & CAM_STATUS_MASK;
2733393f8daSKenneth D. Merry 
2743393f8daSKenneth D. Merry 		entry = cam_fetch_status_entry(status);
2753393f8daSKenneth D. Merry 
2763393f8daSKenneth D. Merry 		if (entry == NULL)
2773393f8daSKenneth D. Merry 			sbuf_printf(&sb, "CAM Status: Unknown (%#x)\n",
2783393f8daSKenneth D. Merry 				    ccb->ccb_h.status);
2793393f8daSKenneth D. Merry 		else
2803393f8daSKenneth D. Merry 			sbuf_printf(&sb, "CAM Status: %s\n",
2813393f8daSKenneth D. Merry 				    entry->status_text);
2823393f8daSKenneth D. Merry 	}
2833393f8daSKenneth D. Merry 
2843393f8daSKenneth D. Merry 	if (flags & CAM_ESF_PROTO_STATUS) {
2853393f8daSKenneth D. Merry 
2863393f8daSKenneth D. Merry 		switch (ccb->ccb_h.func_code) {
2873393f8daSKenneth D. Merry 		case XPT_SCSI_IO:
2883393f8daSKenneth D. Merry 			if ((ccb->ccb_h.status & CAM_STATUS_MASK) !=
2893393f8daSKenneth D. Merry 			     CAM_SCSI_STATUS_ERROR)
2903393f8daSKenneth D. Merry 				break;
2913393f8daSKenneth D. Merry 
2923393f8daSKenneth D. Merry 			if (proto_flags & CAM_ESF_PRINT_STATUS) {
2933393f8daSKenneth D. Merry 				sbuf_cat(&sb, path_str);
2943393f8daSKenneth D. Merry 				/*
2953393f8daSKenneth D. Merry 				 * Print out the SCSI status byte as long as
2963393f8daSKenneth D. Merry 				 * the user wants some protocol output.
2973393f8daSKenneth D. Merry 				 */
2983393f8daSKenneth D. Merry 				sbuf_printf(&sb, "SCSI Status: %s\n",
2993393f8daSKenneth D. Merry 					    scsi_status_string(&ccb->csio));
3003393f8daSKenneth D. Merry 			}
3013393f8daSKenneth D. Merry 
3023393f8daSKenneth D. Merry 			if ((proto_flags & CAM_ESF_PRINT_SENSE)
3033393f8daSKenneth D. Merry 			 && (ccb->csio.scsi_status == SCSI_STATUS_CHECK_COND)
3043393f8daSKenneth D. Merry 			 && (ccb->ccb_h.status & CAM_AUTOSNS_VALID)) {
3053393f8daSKenneth D. Merry 
3063393f8daSKenneth D. Merry #ifdef _KERNEL
3073393f8daSKenneth D. Merry 				scsi_sense_sbuf(&ccb->csio, &sb,
3083393f8daSKenneth D. Merry 						SSS_FLAG_NONE);
3093393f8daSKenneth D. Merry #else /* !_KERNEL */
3103393f8daSKenneth D. Merry 				scsi_sense_sbuf(device, &ccb->csio, &sb,
3113393f8daSKenneth D. Merry 						SSS_FLAG_NONE);
3123393f8daSKenneth D. Merry #endif /* _KERNEL/!_KERNEL */
3133393f8daSKenneth D. Merry 			}
3143393f8daSKenneth D. Merry 			break;
3153393f8daSKenneth D. Merry 		default:
3163393f8daSKenneth D. Merry 			break;
3173393f8daSKenneth D. Merry 		}
3183393f8daSKenneth D. Merry 	}
3193393f8daSKenneth D. Merry 
3203393f8daSKenneth D. Merry 	sbuf_finish(&sb);
3213393f8daSKenneth D. Merry 
3223393f8daSKenneth D. Merry 	return(sbuf_data(&sb));
3233393f8daSKenneth D. Merry }
3243393f8daSKenneth D. Merry 
3253393f8daSKenneth D. Merry #ifdef _KERNEL
3263393f8daSKenneth D. Merry 
3273393f8daSKenneth D. Merry void
3283393f8daSKenneth D. Merry cam_error_print(union ccb *ccb, cam_error_string_flags flags,
3293393f8daSKenneth D. Merry 		cam_error_proto_flags proto_flags)
3303393f8daSKenneth D. Merry {
3313393f8daSKenneth D. Merry 	char str[512];
3323393f8daSKenneth D. Merry 
3333393f8daSKenneth D. Merry 	printf("%s", cam_error_string(ccb, str, sizeof(str), flags,
3343393f8daSKenneth D. Merry 	       proto_flags));
3353393f8daSKenneth D. Merry }
3363393f8daSKenneth D. Merry 
3373393f8daSKenneth D. Merry #else /* !_KERNEL */
3383393f8daSKenneth D. Merry 
3393393f8daSKenneth D. Merry void
3403393f8daSKenneth D. Merry cam_error_print(struct cam_device *device, union ccb *ccb,
3413393f8daSKenneth D. Merry 		cam_error_string_flags flags, cam_error_proto_flags proto_flags,
3423393f8daSKenneth D. Merry 		FILE *ofile)
3433393f8daSKenneth D. Merry {
3443393f8daSKenneth D. Merry 	char str[512];
3453393f8daSKenneth D. Merry 
3463393f8daSKenneth D. Merry 	if ((device == NULL) || (ccb == NULL) || (ofile == NULL))
3473393f8daSKenneth D. Merry 		return;
3483393f8daSKenneth D. Merry 
3493393f8daSKenneth D. Merry 	fprintf(ofile, "%s", cam_error_string(device, ccb, str, sizeof(str),
3503393f8daSKenneth D. Merry 		flags, proto_flags));
3513393f8daSKenneth D. Merry }
3523393f8daSKenneth D. Merry 
3533393f8daSKenneth D. Merry #endif /* _KERNEL/!_KERNEL */
354