[linux.git] / drivers / scsi / constants.c

// SPDX-License-Identifier: GPL-2.0
/*
 * ASCII values for a number of symbolic constants, printing functions,
 * etc.
 * Additions for SCSI 2 and Linux 2.2.x by D. Gilbert (990422)
 * Additions for SCSI 3+ (SPC-3 T10/1416-D Rev 07 3 May 2002)
 *   by D. Gilbert and aeb (20020609)
 * Updated to SPC-4 T10/1713-D Rev 36g, D. Gilbert 20130701
 */

#include <linux/blkdev.h>
#include <linux/module.h>
#include <linux/kernel.h>

#include <scsi/scsi.h>
#include <scsi/scsi_cmnd.h>
#include <scsi/scsi_device.h>
#include <scsi/scsi_host.h>
#include <scsi/scsi_eh.h>
#include <scsi/scsi_dbg.h>

/* Commands with service actions that change the command name */
#define THIRD_PARTY_COPY_OUT 0x83
#define THIRD_PARTY_COPY_IN 0x84

struct sa_name_list {
	int opcode;
	const struct value_name_pair *arr;
	int arr_sz;
};

struct value_name_pair {
	int value;
	const char * name;
};

static const char * cdb_byte0_names[] = {
/* 00-03 */ "Test Unit Ready", "Rezero Unit/Rewind", NULL, "Request Sense",
/* 04-07 */ "Format Unit/Medium", "Read Block Limits", NULL,
	    "Reassign Blocks",
/* 08-0d */ "Read(6)", NULL, "Write(6)", "Seek(6)", NULL, NULL,
/* 0e-12 */ NULL, "Read Reverse", "Write Filemarks", "Space", "Inquiry",
/* 13-16 */ "Verify(6)", "Recover Buffered Data", "Mode Select(6)",
	    "Reserve(6)",
/* 17-1a */ "Release(6)", "Copy", "Erase", "Mode Sense(6)",
/* 1b-1d */ "Start/Stop Unit", "Receive Diagnostic", "Send Diagnostic",
/* 1e-1f */ "Prevent/Allow Medium Removal", NULL,
/* 20-22 */  NULL, NULL, NULL,
/* 23-28 */ "Read Format Capacities", "Set Window",
	    "Read Capacity(10)", NULL, NULL, "Read(10)",
/* 29-2d */ "Read Generation", "Write(10)", "Seek(10)", "Erase(10)",
            "Read updated block",
/* 2e-31 */ "Write Verify(10)", "Verify(10)", "Search High", "Search Equal",
/* 32-34 */ "Search Low", "Set Limits", "Prefetch/Read Position",
/* 35-37 */ "Synchronize Cache(10)", "Lock/Unlock Cache(10)",
	    "Read Defect Data(10)",
/* 38-3c */ "Medium Scan", "Compare", "Copy Verify", "Write Buffer",
	    "Read Buffer",
/* 3d-3f */ "Update Block", "Read Long(10)",  "Write Long(10)",
/* 40-41 */ "Change Definition", "Write Same(10)",
/* 42-48 */ "Unmap/Read sub-channel", "Read TOC/PMA/ATIP",
	    "Read density support", "Play audio(10)", "Get configuration",
	    "Play audio msf", "Sanitize/Play audio track/index",
/* 49-4f */ "Play track relative(10)", "Get event status notification",
            "Pause/resume", "Log Select", "Log Sense", "Stop play/scan",
            NULL,
/* 50-55 */ "Xdwrite", "Xpwrite, Read disk info", "Xdread, Read track info",
            "Reserve track", "Send OPC info", "Mode Select(10)",
/* 56-5b */ "Reserve(10)", "Release(10)", "Repair track", "Read master cue",
            "Mode Sense(10)", "Close track/session",
/* 5c-5f */ "Read buffer capacity", "Send cue sheet", "Persistent reserve in",
            "Persistent reserve out",
/* 60-67 */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
/* 68-6f */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
/* 70-77 */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
/* 78-7f */ NULL, NULL, NULL, NULL, NULL, NULL, "Extended CDB",
	    "Variable length",
/* 80-84 */ "Xdwrite(16)", "Rebuild(16)", "Regenerate(16)",
	    "Third party copy out", "Third party copy in",
/* 85-89 */ "ATA command pass through(16)", "Access control in",
	    "Access control out", "Read(16)", "Compare and Write",
/* 8a-8f */ "Write(16)", "ORWrite", "Read attributes", "Write attributes",
            "Write and verify(16)", "Verify(16)",
/* 90-94 */ "Pre-fetch(16)", "Synchronize cache(16)",
            "Lock/unlock cache(16)", "Write same(16)", NULL,
/* 95-99 */ NULL, NULL, NULL, NULL, NULL,
/* 9a-9f */ NULL, NULL, NULL, "Service action bidirectional",
	    "Service action in(16)", "Service action out(16)",
/* a0-a5 */ "Report luns", "ATA command pass through(12)/Blank",
            "Security protocol in", "Maintenance in", "Maintenance out",
	    "Move medium/play audio(12)",
/* a6-a9 */ "Exchange medium", "Move medium attached", "Read(12)",
            "Play track relative(12)",
/* aa-ae */ "Write(12)", NULL, "Erase(12), Get Performance",
            "Read DVD structure", "Write and verify(12)",
/* af-b1 */ "Verify(12)", "Search data high(12)", "Search data equal(12)",
/* b2-b4 */ "Search data low(12)", "Set limits(12)",
            "Read element status attached",
/* b5-b6 */ "Security protocol out", "Send volume tag, set streaming",
/* b7-b9 */ "Read defect data(12)", "Read element status", "Read CD msf",
/* ba-bc */ "Redundancy group (in), Scan",
            "Redundancy group (out), Set cd-rom speed", "Spare (in), Play cd",
/* bd-bf */ "Spare (out), Mechanism status", "Volume set (in), Read cd",
            "Volume set (out), Send DVD structure",
};

static const struct value_name_pair maint_in_arr[] = {
	{0x5, "Report identifying information"},
	{0xa, "Report target port groups"},
	{0xb, "Report aliases"},
	{0xc, "Report supported operation codes"},
	{0xd, "Report supported task management functions"},
	{0xe, "Report priority"},
	{0xf, "Report timestamp"},
	{0x10, "Management protocol in"},
};
#define MAINT_IN_SZ ARRAY_SIZE(maint_in_arr)

static const struct value_name_pair maint_out_arr[] = {
	{0x6, "Set identifying information"},
	{0xa, "Set target port groups"},
	{0xb, "Change aliases"},
	{0xc, "Remove I_T nexus"},
	{0xe, "Set priority"},
	{0xf, "Set timestamp"},
	{0x10, "Management protocol out"},
};
#define MAINT_OUT_SZ ARRAY_SIZE(maint_out_arr)

static const struct value_name_pair serv_in12_arr[] = {
	{0x1, "Read media serial number"},
};
#define SERV_IN12_SZ ARRAY_SIZE(serv_in12_arr)

static const struct value_name_pair serv_out12_arr[] = {
	{-1, "dummy entry"},
};
#define SERV_OUT12_SZ ARRAY_SIZE(serv_out12_arr)

static const struct value_name_pair serv_bidi_arr[] = {
	{-1, "dummy entry"},
};
#define SERV_BIDI_SZ ARRAY_SIZE(serv_bidi_arr)

static const struct value_name_pair serv_in16_arr[] = {
	{0x10, "Read capacity(16)"},
	{0x11, "Read long(16)"},
	{0x12, "Get LBA status"},
	{0x13, "Report referrals"},
};
#define SERV_IN16_SZ ARRAY_SIZE(serv_in16_arr)

static const struct value_name_pair serv_out16_arr[] = {
	{0x11, "Write long(16)"},
	{0x1f, "Notify data transfer device(16)"},
};
#define SERV_OUT16_SZ ARRAY_SIZE(serv_out16_arr)

static const struct value_name_pair pr_in_arr[] = {
	{0x0, "Persistent reserve in, read keys"},
	{0x1, "Persistent reserve in, read reservation"},
	{0x2, "Persistent reserve in, report capabilities"},
	{0x3, "Persistent reserve in, read full status"},
};
#define PR_IN_SZ ARRAY_SIZE(pr_in_arr)

static const struct value_name_pair pr_out_arr[] = {
	{0x0, "Persistent reserve out, register"},
	{0x1, "Persistent reserve out, reserve"},
	{0x2, "Persistent reserve out, release"},
	{0x3, "Persistent reserve out, clear"},
	{0x4, "Persistent reserve out, preempt"},
	{0x5, "Persistent reserve out, preempt and abort"},
	{0x6, "Persistent reserve out, register and ignore existing key"},
	{0x7, "Persistent reserve out, register and move"},
};
#define PR_OUT_SZ ARRAY_SIZE(pr_out_arr)

/* SPC-4 rev 34 renamed the Extended Copy opcode to Third Party Copy Out.
   LID1 (List Identifier length: 1 byte) is the Extended Copy found in SPC-2
   and SPC-3 */
static const struct value_name_pair tpc_out_arr[] = {
	{0x0, "Extended copy(LID1)"},
	{0x1, "Extended copy(LID4)"},
	{0x10, "Populate token"},
	{0x11, "Write using token"},
	{0x1c, "Copy operation abort"},
};
#define TPC_OUT_SZ ARRAY_SIZE(tpc_out_arr)

static const struct value_name_pair tpc_in_arr[] = {
	{0x0, "Receive copy status(LID1)"},
	{0x1, "Receive copy data(LID1)"},
	{0x3, "Receive copy operating parameters"},
	{0x4, "Receive copy failure details(LID1)"},
	{0x5, "Receive copy status(LID4)"},
	{0x6, "Receive copy data(LID4)"},
	{0x7, "Receive ROD token information"},
	{0x8, "Report all ROD tokens"},
};
#define TPC_IN_SZ ARRAY_SIZE(tpc_in_arr)


static const struct value_name_pair variable_length_arr[] = {
	{0x1, "Rebuild(32)"},
	{0x2, "Regenerate(32)"},
	{0x3, "Xdread(32)"},
	{0x4, "Xdwrite(32)"},
	{0x5, "Xdwrite extended(32)"},
	{0x6, "Xpwrite(32)"},
	{0x7, "Xdwriteread(32)"},
	{0x8, "Xdwrite extended(64)"},
	{0x9, "Read(32)"},
	{0xa, "Verify(32)"},
	{0xb, "Write(32)"},
	{0xc, "Write an verify(32)"},
	{0xd, "Write same(32)"},
	{0x8801, "Format OSD"},
	{0x8802, "Create (osd)"},
	{0x8803, "List (osd)"},
	{0x8805, "Read (osd)"},
	{0x8806, "Write (osd)"},
	{0x8807, "Append (osd)"},
	{0x8808, "Flush (osd)"},
	{0x880a, "Remove (osd)"},
	{0x880b, "Create partition (osd)"},
	{0x880c, "Remove partition (osd)"},
	{0x880e, "Get attributes (osd)"},
	{0x880f, "Set attributes (osd)"},
	{0x8812, "Create and write (osd)"},
	{0x8815, "Create collection (osd)"},
	{0x8816, "Remove collection (osd)"},
	{0x8817, "List collection (osd)"},
	{0x8818, "Set key (osd)"},
	{0x8819, "Set master key (osd)"},
	{0x881a, "Flush collection (osd)"},
	{0x881b, "Flush partition (osd)"},
	{0x881c, "Flush OSD"},
	{0x8f7e, "Perform SCSI command (osd)"},
	{0x8f7f, "Perform task management function (osd)"},
};
#define VARIABLE_LENGTH_SZ ARRAY_SIZE(variable_length_arr)

static struct sa_name_list sa_names_arr[] = {
	{VARIABLE_LENGTH_CMD, variable_length_arr, VARIABLE_LENGTH_SZ},
	{MAINTENANCE_IN, maint_in_arr, MAINT_IN_SZ},
	{MAINTENANCE_OUT, maint_out_arr, MAINT_OUT_SZ},
	{PERSISTENT_RESERVE_IN, pr_in_arr, PR_IN_SZ},
	{PERSISTENT_RESERVE_OUT, pr_out_arr, PR_OUT_SZ},
	{SERVICE_ACTION_IN_12, serv_in12_arr, SERV_IN12_SZ},
	{SERVICE_ACTION_OUT_12, serv_out12_arr, SERV_OUT12_SZ},
	{SERVICE_ACTION_BIDIRECTIONAL, serv_bidi_arr, SERV_BIDI_SZ},
	{SERVICE_ACTION_IN_16, serv_in16_arr, SERV_IN16_SZ},
	{SERVICE_ACTION_OUT_16, serv_out16_arr, SERV_OUT16_SZ},
	{THIRD_PARTY_COPY_IN, tpc_in_arr, TPC_IN_SZ},
	{THIRD_PARTY_COPY_OUT, tpc_out_arr, TPC_OUT_SZ},
	{0, NULL, 0},
};

bool scsi_opcode_sa_name(int opcode, int service_action,
			 const char **cdb_name, const char **sa_name)
{
	struct sa_name_list *sa_name_ptr;
	const struct value_name_pair *arr = NULL;
	int arr_sz, k;

	*cdb_name = NULL;
	if (opcode >= VENDOR_SPECIFIC_CDB)
		return false;

	if (opcode < ARRAY_SIZE(cdb_byte0_names))
		*cdb_name = cdb_byte0_names[opcode];

	for (sa_name_ptr = sa_names_arr; sa_name_ptr->arr; ++sa_name_ptr) {
		if (sa_name_ptr->opcode == opcode) {
			arr = sa_name_ptr->arr;
			arr_sz = sa_name_ptr->arr_sz;
			break;
		}
	}
	if (!arr)
		return false;

	for (k = 0; k < arr_sz; ++k, ++arr) {
		if (service_action == arr->value)
			break;
	}
	if (k < arr_sz)
		*sa_name = arr->name;

	return true;
}

struct error_info {
	unsigned short code12;	/* 0x0302 looks better than 0x03,0x02 */
	unsigned short size;
};

/*
 * There are 700+ entries in this table. To save space, we don't store
 * (code, pointer) pairs, which would make sizeof(struct
 * error_info)==16 on 64 bits. Rather, the second element just stores
 * the size (including \0) of the corresponding string, and we use the
 * sum of these to get the appropriate offset into additional_text
 * defined below. This approach saves 12 bytes per entry.
 */
static const struct error_info additional[] =
{
#define SENSE_CODE(c, s) {c, sizeof(s)},
#include "sense_codes.h"
#undef SENSE_CODE
};

static const char *additional_text =
#define SENSE_CODE(c, s) s "\0"
#include "sense_codes.h"
#undef SENSE_CODE
	;

struct error_info2 {
	unsigned char code1, code2_min, code2_max;
	const char * str;
	const char * fmt;
};

static const struct error_info2 additional2[] =
{
	{0x40, 0x00, 0x7f, "Ram failure", ""},
	{0x40, 0x80, 0xff, "Diagnostic failure on component", ""},
	{0x41, 0x00, 0xff, "Data path failure", ""},
	{0x42, 0x00, 0xff, "Power-on or self-test failure", ""},
	{0x4D, 0x00, 0xff, "Tagged overlapped commands", "task tag "},
	{0x70, 0x00, 0xff, "Decompression exception", "short algorithm id of "},
	{0, 0, 0, NULL, NULL}
};

/* description of the sense key values */
static const char * const snstext[] = {
	"No Sense",	    /* 0: There is no sense information */
	"Recovered Error",  /* 1: The last command completed successfully
				  but used error correction */
	"Not Ready",	    /* 2: The addressed target is not ready */
	"Medium Error",	    /* 3: Data error detected on the medium */
	"Hardware Error",   /* 4: Controller or device failure */
	"Illegal Request",  /* 5: Error in request */
	"Unit Attention",   /* 6: Removable medium was changed, or
				  the target has been reset, or ... */
	"Data Protect",	    /* 7: Access to the data is blocked */
	"Blank Check",	    /* 8: Reached unexpected written or unwritten
				  region of the medium */
	"Vendor Specific(9)",
	"Copy Aborted",	    /* A: COPY or COMPARE was aborted */
	"Aborted Command",  /* B: The target aborted the command */
	"Equal",	    /* C: A SEARCH DATA command found data equal,
				  reserved in SPC-4 rev 36 */
	"Volume Overflow",  /* D: Medium full with still data to be written */
	"Miscompare",	    /* E: Source data and data on the medium
				  do not agree */
	"Completed",	    /* F: command completed sense data reported,
				  may occur for successful command */
};

/* Get sense key string or NULL if not available */
const char *
scsi_sense_key_string(unsigned char key)
{
	if (key < ARRAY_SIZE(snstext))
		return snstext[key];
	return NULL;
}
EXPORT_SYMBOL(scsi_sense_key_string);

/*
 * Get additional sense code string or NULL if not available.
 * This string may contain a "%x" and should be printed with ascq as arg.
 */
const char *
scsi_extd_sense_format(unsigned char asc, unsigned char ascq, const char **fmt)
{
	int i;
	unsigned short code = ((asc << 8) | ascq);
	unsigned offset = 0;

	*fmt = NULL;
	for (i = 0; i < ARRAY_SIZE(additional); i++) {
		if (additional[i].code12 == code)
			return additional_text + offset;
		offset += additional[i].size;
	}
	for (i = 0; additional2[i].fmt; i++) {
		if (additional2[i].code1 == asc &&
		    ascq >= additional2[i].code2_min &&
		    ascq <= additional2[i].code2_max) {
			*fmt = additional2[i].fmt;
			return additional2[i].str;
		}
	}
	return NULL;
}
EXPORT_SYMBOL(scsi_extd_sense_format);

static const char * const hostbyte_table[]={
"DID_OK", "DID_NO_CONNECT", "DID_BUS_BUSY", "DID_TIME_OUT", "DID_BAD_TARGET",
"DID_ABORT", "DID_PARITY", "DID_ERROR", "DID_RESET", "DID_BAD_INTR",
"DID_PASSTHROUGH", "DID_SOFT_ERROR", "DID_IMM_RETRY", "DID_REQUEUE",
"DID_TRANSPORT_DISRUPTED", "DID_TRANSPORT_FAILFAST", "DID_TARGET_FAILURE",
"DID_NEXUS_FAILURE", "DID_ALLOC_FAILURE", "DID_MEDIUM_ERROR" };

static const char * const driverbyte_table[]={
"DRIVER_OK", "DRIVER_BUSY", "DRIVER_SOFT",  "DRIVER_MEDIA", "DRIVER_ERROR",
"DRIVER_INVALID", "DRIVER_TIMEOUT", "DRIVER_HARD", "DRIVER_SENSE"};

const char *scsi_hostbyte_string(int result)
{
	const char *hb_string = NULL;
	int hb = host_byte(result);

	if (hb < ARRAY_SIZE(hostbyte_table))
		hb_string = hostbyte_table[hb];
	return hb_string;
}
EXPORT_SYMBOL(scsi_hostbyte_string);

const char *scsi_driverbyte_string(int result)
{
	const char *db_string = NULL;
	int db = driver_byte(result);

	if (db < ARRAY_SIZE(driverbyte_table))
		db_string = driverbyte_table[db];
	return db_string;
}
EXPORT_SYMBOL(scsi_driverbyte_string);

#define scsi_mlreturn_name(result)	{ result, #result }
static const struct value_name_pair scsi_mlreturn_arr[] = {
	scsi_mlreturn_name(NEEDS_RETRY),
	scsi_mlreturn_name(SUCCESS),
	scsi_mlreturn_name(FAILED),
	scsi_mlreturn_name(QUEUED),
	scsi_mlreturn_name(SOFT_ERROR),
	scsi_mlreturn_name(ADD_TO_MLQUEUE),
	scsi_mlreturn_name(TIMEOUT_ERROR),
	scsi_mlreturn_name(SCSI_RETURN_NOT_HANDLED),
	scsi_mlreturn_name(FAST_IO_FAIL)
};

const char *scsi_mlreturn_string(int result)
{
	const struct value_name_pair *arr = scsi_mlreturn_arr;
	int k;

	for (k = 0; k < ARRAY_SIZE(scsi_mlreturn_arr); ++k, ++arr) {
		if (result == arr->value)
			return arr->name;
	}
	return NULL;
}
EXPORT_SYMBOL(scsi_mlreturn_string);
Commit	Line	Data
b2441318	1	// SPDX-License-Identifier: GPL-2.0
655ee63c	2	/*
1da177e4 LT	3	* ASCII values for a number of symbolic constants, printing functions,
	4	* etc.
	5	* Additions for SCSI 2 and Linux 2.2.x by D. Gilbert (990422)
	6	* Additions for SCSI 3+ (SPC-3 T10/1416-D Rev 07 3 May 2002)
	7	* by D. Gilbert and aeb (20020609)
655ee63c	8	* Updated to SPC-4 T10/1713-D Rev 36g, D. Gilbert 20130701
1da177e4 LT	9	*/
1da177e4 LT	10
1da177e4 LT	11	#include <linux/blkdev.h>
	12	#include <linux/module.h>
	13	#include <linux/kernel.h>
	14
	15	#include <scsi/scsi.h>
beb40487	16	#include <scsi/scsi_cmnd.h>
1da177e4 LT	17	#include <scsi/scsi_device.h>
1da177e4 LT	18	#include <scsi/scsi_host.h>
1da177e4	19	#include <scsi/scsi_eh.h>
de540a53	20	#include <scsi/scsi_dbg.h>
1da177e4	21
1da177e4	22	/* Commands with service actions that change the command name */
655ee63c DG	23	#define THIRD_PARTY_COPY_OUT 0x83
655ee63c DG	24	#define THIRD_PARTY_COPY_IN 0x84
1da177e4	25
234d6778 HR	26	struct sa_name_list {
	27	int opcode;
	28	const struct value_name_pair *arr;
	29	int arr_sz;
	30	};
	31
	32	struct value_name_pair {
	33	int value;
	34	const char * name;
	35	};
1da177e4	36
1da177e4 LT	37	static const char * cdb_byte0_names[] = {
	38	/* 00-03 */ "Test Unit Ready", "Rezero Unit/Rewind", NULL, "Request Sense",
	39	/* 04-07 */ "Format Unit/Medium", "Read Block Limits", NULL,
70f23fd6	40	"Reassign Blocks",
a507c6a2	41	/* 08-0d */ "Read(6)", NULL, "Write(6)", "Seek(6)", NULL, NULL,
655ee63c	42	/* 0e-12 */ NULL, "Read Reverse", "Write Filemarks", "Space", "Inquiry",
a507c6a2 DG	43	/* 13-16 */ "Verify(6)", "Recover Buffered Data", "Mode Select(6)",
	44	"Reserve(6)",
	45	/* 17-1a */ "Release(6)", "Copy", "Erase", "Mode Sense(6)",
655ee63c	46	/* 1b-1d */ "Start/Stop Unit", "Receive Diagnostic", "Send Diagnostic",
1da177e4 LT	47	/* 1e-1f */ "Prevent/Allow Medium Removal", NULL,
	48	/* 20-22 */ NULL, NULL, NULL,
	49	/* 23-28 */ "Read Format Capacities", "Set Window",
a507c6a2 DG	50	"Read Capacity(10)", NULL, NULL, "Read(10)",
	51	/* 29-2d */ "Read Generation", "Write(10)", "Seek(10)", "Erase(10)",
	52	"Read updated block",
	53	/* 2e-31 */ "Write Verify(10)", "Verify(10)", "Search High", "Search Equal",
655ee63c	54	/* 32-34 */ "Search Low", "Set Limits", "Prefetch/Read Position",
a507c6a2	55	/* 35-37 */ "Synchronize Cache(10)", "Lock/Unlock Cache(10)",
655ee63c DG	56	"Read Defect Data(10)",
	57	/* 38-3c */ "Medium Scan", "Compare", "Copy Verify", "Write Buffer",
	58	"Read Buffer",
a507c6a2 DG	59	/* 3d-3f */ "Update Block", "Read Long(10)", "Write Long(10)",
a507c6a2 DG	60	/* 40-41 */ "Change Definition", "Write Same(10)",
b4567ca6 DG	61	/* 42-48 */ "Unmap/Read sub-channel", "Read TOC/PMA/ATIP",
b4567ca6 DG	62	"Read density support", "Play audio(10)", "Get configuration",
655ee63c	63	"Play audio msf", "Sanitize/Play audio track/index",
a507c6a2	64	/* 49-4f */ "Play track relative(10)", "Get event status notification",
1da177e4 LT	65	"Pause/resume", "Log Select", "Log Sense", "Stop play/scan",
	66	NULL,
	67	/* 50-55 */ "Xdwrite", "Xpwrite, Read disk info", "Xdread, Read track info",
a507c6a2 DG	68	"Reserve track", "Send OPC info", "Mode Select(10)",
	69	/* 56-5b */ "Reserve(10)", "Release(10)", "Repair track", "Read master cue",
	70	"Mode Sense(10)", "Close track/session",
1da177e4 LT	71	/* 5c-5f */ "Read buffer capacity", "Send cue sheet", "Persistent reserve in",
	72	"Persistent reserve out",
	73	/* 60-67 */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
	74	/* 68-6f */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
	75	/* 70-77 */ NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
b4567ca6 DG	76	/* 78-7f */ NULL, NULL, NULL, NULL, NULL, NULL, "Extended CDB",
b4567ca6 DG	77	"Variable length",
655ee63c DG	78	/* 80-84 */ "Xdwrite(16)", "Rebuild(16)", "Regenerate(16)",
655ee63c DG	79	"Third party copy out", "Third party copy in",
a507c6a2	80	/* 85-89 */ "ATA command pass through(16)", "Access control in",
655ee63c	81	"Access control out", "Read(16)", "Compare and Write",
b4567ca6	82	/* 8a-8f */ "Write(16)", "ORWrite", "Read attributes", "Write attributes",
a507c6a2 DG	83	"Write and verify(16)", "Verify(16)",
	84	/* 90-94 */ "Pre-fetch(16)", "Synchronize cache(16)",
	85	"Lock/unlock cache(16)", "Write same(16)", NULL,
1da177e4	86	/* 95-99 */ NULL, NULL, NULL, NULL, NULL,
655ee63c DG	87	/* 9a-9f */ NULL, NULL, NULL, "Service action bidirectional",
655ee63c DG	88	"Service action in(16)", "Service action out(16)",
a507c6a2 DG	89	/* a0-a5 */ "Report luns", "ATA command pass through(12)/Blank",
	90	"Security protocol in", "Maintenance in", "Maintenance out",
	91	"Move medium/play audio(12)",
1da177e4 LT	92	/* a6-a9 */ "Exchange medium", "Move medium attached", "Read(12)",
	93	"Play track relative(12)",
	94	/* aa-ae */ "Write(12)", NULL, "Erase(12), Get Performance",
	95	"Read DVD structure", "Write and verify(12)",
	96	/* af-b1 */ "Verify(12)", "Search data high(12)", "Search data equal(12)",
	97	/* b2-b4 */ "Search data low(12)", "Set limits(12)",
	98	"Read element status attached",
a507c6a2	99	/* b5-b6 */ "Security protocol out", "Send volume tag, set streaming",
1da177e4 LT	100	/* b7-b9 */ "Read defect data(12)", "Read element status", "Read CD msf",
1da177e4 LT	101	/* ba-bc */ "Redundancy group (in), Scan",
a507c6a2 DG	102	"Redundancy group (out), Set cd-rom speed", "Spare (in), Play cd",
	103	/* bd-bf */ "Spare (out), Mechanism status", "Volume set (in), Read cd",
	104	"Volume set (out), Send DVD structure",
1da177e4 LT	105	};
1da177e4 LT	106
1da177e4	107	static const struct value_name_pair maint_in_arr[] = {
b4567ca6	108	{0x5, "Report identifying information"},
1da177e4 LT	109	{0xa, "Report target port groups"},
	110	{0xb, "Report aliases"},
	111	{0xc, "Report supported operation codes"},
	112	{0xd, "Report supported task management functions"},
	113	{0xe, "Report priority"},
a507c6a2	114	{0xf, "Report timestamp"},
b4567ca6	115	{0x10, "Management protocol in"},
1da177e4	116	};
6391a113	117	#define MAINT_IN_SZ ARRAY_SIZE(maint_in_arr)
1da177e4 LT	118
1da177e4 LT	119	static const struct value_name_pair maint_out_arr[] = {
b4567ca6	120	{0x6, "Set identifying information"},
1da177e4 LT	121	{0xa, "Set target port groups"},
1da177e4 LT	122	{0xb, "Change aliases"},
655ee63c	123	{0xc, "Remove I_T nexus"},
1da177e4	124	{0xe, "Set priority"},
b4567ca6 DG	125	{0xf, "Set timestamp"},
b4567ca6 DG	126	{0x10, "Management protocol out"},
1da177e4	127	};
6391a113	128	#define MAINT_OUT_SZ ARRAY_SIZE(maint_out_arr)
1da177e4 LT	129
	130	static const struct value_name_pair serv_in12_arr[] = {
	131	{0x1, "Read media serial number"},
	132	};
6391a113	133	#define SERV_IN12_SZ ARRAY_SIZE(serv_in12_arr)
1da177e4 LT	134
	135	static const struct value_name_pair serv_out12_arr[] = {
	136	{-1, "dummy entry"},
	137	};
6391a113	138	#define SERV_OUT12_SZ ARRAY_SIZE(serv_out12_arr)
1da177e4	139
655ee63c DG	140	static const struct value_name_pair serv_bidi_arr[] = {
	141	{-1, "dummy entry"},
	142	};
	143	#define SERV_BIDI_SZ ARRAY_SIZE(serv_bidi_arr)
	144
1da177e4 LT	145	static const struct value_name_pair serv_in16_arr[] = {
	146	{0x10, "Read capacity(16)"},
	147	{0x11, "Read long(16)"},
f57e4502	148	{0x12, "Get LBA status"},
655ee63c	149	{0x13, "Report referrals"},
1da177e4	150	};
6391a113	151	#define SERV_IN16_SZ ARRAY_SIZE(serv_in16_arr)
1da177e4 LT	152
	153	static const struct value_name_pair serv_out16_arr[] = {
	154	{0x11, "Write long(16)"},
	155	{0x1f, "Notify data transfer device(16)"},
	156	};
6391a113	157	#define SERV_OUT16_SZ ARRAY_SIZE(serv_out16_arr)
1da177e4	158
655ee63c DG	159	static const struct value_name_pair pr_in_arr[] = {
	160	{0x0, "Persistent reserve in, read keys"},
	161	{0x1, "Persistent reserve in, read reservation"},
	162	{0x2, "Persistent reserve in, report capabilities"},
	163	{0x3, "Persistent reserve in, read full status"},
	164	};
	165	#define PR_IN_SZ ARRAY_SIZE(pr_in_arr)
	166
	167	static const struct value_name_pair pr_out_arr[] = {
	168	{0x0, "Persistent reserve out, register"},
	169	{0x1, "Persistent reserve out, reserve"},
	170	{0x2, "Persistent reserve out, release"},
	171	{0x3, "Persistent reserve out, clear"},
	172	{0x4, "Persistent reserve out, preempt"},
	173	{0x5, "Persistent reserve out, preempt and abort"},
	174	{0x6, "Persistent reserve out, register and ignore existing key"},
	175	{0x7, "Persistent reserve out, register and move"},
	176	};
	177	#define PR_OUT_SZ ARRAY_SIZE(pr_out_arr)
	178
	179	/* SPC-4 rev 34 renamed the Extended Copy opcode to Third Party Copy Out.
	180	LID1 (List Identifier length: 1 byte) is the Extended Copy found in SPC-2
	181	and SPC-3 */
	182	static const struct value_name_pair tpc_out_arr[] = {
	183	{0x0, "Extended copy(LID1)"},
	184	{0x1, "Extended copy(LID4)"},
	185	{0x10, "Populate token"},
	186	{0x11, "Write using token"},
	187	{0x1c, "Copy operation abort"},
	188	};
	189	#define TPC_OUT_SZ ARRAY_SIZE(tpc_out_arr)
	190
	191	static const struct value_name_pair tpc_in_arr[] = {
	192	{0x0, "Receive copy status(LID1)"},
	193	{0x1, "Receive copy data(LID1)"},
	194	{0x3, "Receive copy operating parameters"},
	195	{0x4, "Receive copy failure details(LID1)"},
	196	{0x5, "Receive copy status(LID4)"},
	197	{0x6, "Receive copy data(LID4)"},
	198	{0x7, "Receive ROD token information"},
	199	{0x8, "Report all ROD tokens"},
	200	};
	201	#define TPC_IN_SZ ARRAY_SIZE(tpc_in_arr)
	202
	203
1da177e4 LT	204	static const struct value_name_pair variable_length_arr[] = {
	205	{0x1, "Rebuild(32)"},
	206	{0x2, "Regenerate(32)"},
	207	{0x3, "Xdread(32)"},
	208	{0x4, "Xdwrite(32)"},
	209	{0x5, "Xdwrite extended(32)"},
	210	{0x6, "Xpwrite(32)"},
	211	{0x7, "Xdwriteread(32)"},
	212	{0x8, "Xdwrite extended(64)"},
	213	{0x9, "Read(32)"},
	214	{0xa, "Verify(32)"},
	215	{0xb, "Write(32)"},
	216	{0xc, "Write an verify(32)"},
	217	{0xd, "Write same(32)"},
	218	{0x8801, "Format OSD"},
	219	{0x8802, "Create (osd)"},
	220	{0x8803, "List (osd)"},
	221	{0x8805, "Read (osd)"},
	222	{0x8806, "Write (osd)"},
	223	{0x8807, "Append (osd)"},
	224	{0x8808, "Flush (osd)"},
	225	{0x880a, "Remove (osd)"},
	226	{0x880b, "Create partition (osd)"},
	227	{0x880c, "Remove partition (osd)"},
	228	{0x880e, "Get attributes (osd)"},
	229	{0x880f, "Set attributes (osd)"},
	230	{0x8812, "Create and write (osd)"},
	231	{0x8815, "Create collection (osd)"},
	232	{0x8816, "Remove collection (osd)"},
	233	{0x8817, "List collection (osd)"},
	234	{0x8818, "Set key (osd)"},
	235	{0x8819, "Set master key (osd)"},
	236	{0x881a, "Flush collection (osd)"},
	237	{0x881b, "Flush partition (osd)"},
	238	{0x881c, "Flush OSD"},
	239	{0x8f7e, "Perform SCSI command (osd)"},
	240	{0x8f7f, "Perform task management function (osd)"},
	241	};
6391a113	242	#define VARIABLE_LENGTH_SZ ARRAY_SIZE(variable_length_arr)
1da177e4	243
6033f979 HR	244	static struct sa_name_list sa_names_arr[] = {
	245	{VARIABLE_LENGTH_CMD, variable_length_arr, VARIABLE_LENGTH_SZ},
	246	{MAINTENANCE_IN, maint_in_arr, MAINT_IN_SZ},
	247	{MAINTENANCE_OUT, maint_out_arr, MAINT_OUT_SZ},
	248	{PERSISTENT_RESERVE_IN, pr_in_arr, PR_IN_SZ},
	249	{PERSISTENT_RESERVE_OUT, pr_out_arr, PR_OUT_SZ},
	250	{SERVICE_ACTION_IN_12, serv_in12_arr, SERV_IN12_SZ},
	251	{SERVICE_ACTION_OUT_12, serv_out12_arr, SERV_OUT12_SZ},
	252	{SERVICE_ACTION_BIDIRECTIONAL, serv_bidi_arr, SERV_BIDI_SZ},
	253	{SERVICE_ACTION_IN_16, serv_in16_arr, SERV_IN16_SZ},
	254	{SERVICE_ACTION_OUT_16, serv_out16_arr, SERV_OUT16_SZ},
	255	{THIRD_PARTY_COPY_IN, tpc_in_arr, TPC_IN_SZ},
	256	{THIRD_PARTY_COPY_OUT, tpc_out_arr, TPC_OUT_SZ},
	257	{0, NULL, 0},
	258	};
	259
9e5ed2a5 HR	260	bool scsi_opcode_sa_name(int opcode, int service_action,
9e5ed2a5 HR	261	const char cdb_name, const char sa_name)
1da177e4	262	{
6033f979 HR	263	struct sa_name_list *sa_name_ptr;
	264	const struct value_name_pair *arr = NULL;
	265	int arr_sz, k;
	266
2478a736 HR	267	*cdb_name = NULL;
	268	if (opcode >= VENDOR_SPECIFIC_CDB)
	269	return false;
	270
	271	if (opcode < ARRAY_SIZE(cdb_byte0_names))
	272	*cdb_name = cdb_byte0_names[opcode];
	273
6033f979 HR	274	for (sa_name_ptr = sa_names_arr; sa_name_ptr->arr; ++sa_name_ptr) {
	275	if (sa_name_ptr->opcode == opcode) {
	276	arr = sa_name_ptr->arr;
	277	arr_sz = sa_name_ptr->arr_sz;
	278	break;
	279	}
	280	}
	281	if (!arr)
	282	return false;
1da177e4 LT	283
	284	for (k = 0; k < arr_sz; ++k, ++arr) {
	285	if (service_action == arr->value)
	286	break;
	287	}
6033f979 HR	288	if (k < arr_sz)
	289	*sa_name = arr->name;
	290
	291	return true;
1da177e4 LT	292	}
1da177e4 LT	293
1da177e4 LT	294	struct error_info {
1da177e4 LT	295	unsigned short code12; /* 0x0302 looks better than 0x03,0x02 */
e1f0bce3	296	unsigned short size;
1da177e4 LT	297	};
1da177e4 LT	298
e1f0bce3 RV	299	/*
	300	* There are 700+ entries in this table. To save space, we don't store
	301	* (code, pointer) pairs, which would make sizeof(struct
	302	* error_info)==16 on 64 bits. Rather, the second element just stores
	303	* the size (including \0) of the corresponding string, and we use the
	304	* sum of these to get the appropriate offset into additional_text
	305	* defined below. This approach saves 12 bytes per entry.
	306	*/
62d42a62	307	static const struct error_info additional[] =
1da177e4	308	{
e1f0bce3	309	#define SENSE_CODE(c, s) {c, sizeof(s)},
9d99a2e3 RV	310	#include "sense_codes.h"
9d99a2e3 RV	311	#undef SENSE_CODE
1da177e4 LT	312	};
1da177e4 LT	313
e1f0bce3 RV	314	static const char *additional_text =
	315	#define SENSE_CODE(c, s) s "\0"
	316	#include "sense_codes.h"
	317	#undef SENSE_CODE
	318	;
	319
1da177e4 LT	320	struct error_info2 {
1da177e4 LT	321	unsigned char code1, code2_min, code2_max;
d811b848	322	const char * str;
1da177e4 LT	323	const char * fmt;
	324	};
	325
0ad78200	326	static const struct error_info2 additional2[] =
1da177e4	327	{
d811b848 HR	328	{0x40, 0x00, 0x7f, "Ram failure", ""},
	329	{0x40, 0x80, 0xff, "Diagnostic failure on component", ""},
	330	{0x41, 0x00, 0xff, "Data path failure", ""},
	331	{0x42, 0x00, 0xff, "Power-on or self-test failure", ""},
	332	{0x4D, 0x00, 0xff, "Tagged overlapped commands", "task tag "},
	333	{0x70, 0x00, 0xff, "Decompression exception", "short algorithm id of "},
	334	{0, 0, 0, NULL, NULL}
1da177e4 LT	335	};
	336
	337	/* description of the sense key values */
0ad78200	338	static const char * const snstext[] = {
1da177e4 LT	339	"No Sense", /* 0: There is no sense information */
	340	"Recovered Error", /* 1: The last command completed successfully
	341	but used error correction */
	342	"Not Ready", /* 2: The addressed target is not ready */
	343	"Medium Error", /* 3: Data error detected on the medium */
	344	"Hardware Error", /* 4: Controller or device failure */
	345	"Illegal Request", /* 5: Error in request */
	346	"Unit Attention", /* 6: Removable medium was changed, or
	347	the target has been reset, or ... */
	348	"Data Protect", /* 7: Access to the data is blocked */
	349	"Blank Check", /* 8: Reached unexpected written or unwritten
	350	region of the medium */
	351	"Vendor Specific(9)",
	352	"Copy Aborted", /* A: COPY or COMPARE was aborted */
	353	"Aborted Command", /* B: The target aborted the command */
655ee63c DG	354	"Equal", /* C: A SEARCH DATA command found data equal,
655ee63c DG	355	reserved in SPC-4 rev 36 */
1da177e4 LT	356	"Volume Overflow", /* D: Medium full with still data to be written */
	357	"Miscompare", /* E: Source data and data on the medium
	358	do not agree */
655ee63c DG	359	"Completed", /* F: command completed sense data reported,
655ee63c DG	360	may occur for successful command */
1da177e4	361	};
1da177e4 LT	362
	363	/* Get sense key string or NULL if not available */
	364	const char *
a87eeb90 TD	365	scsi_sense_key_string(unsigned char key)
	366	{
	367	if (key < ARRAY_SIZE(snstext))
1da177e4	368	return snstext[key];
1da177e4 LT	369	return NULL;
	370	}
	371	EXPORT_SYMBOL(scsi_sense_key_string);
	372
	373	/*
	374	* Get additional sense code string or NULL if not available.
	375	* This string may contain a "%x" and should be printed with ascq as arg.
	376	*/
	377	const char *
d811b848 HR	378	scsi_extd_sense_format(unsigned char asc, unsigned char ascq, const char **fmt)
d811b848 HR	379	{
1da177e4 LT	380	int i;
1da177e4 LT	381	unsigned short code = ((asc << 8) \| ascq);
e1f0bce3	382	unsigned offset = 0;
1da177e4	383
249b15ba	384	*fmt = NULL;
e1f0bce3	385	for (i = 0; i < ARRAY_SIZE(additional); i++) {
1da177e4	386	if (additional[i].code12 == code)
e1f0bce3 RV	387	return additional_text + offset;
	388	offset += additional[i].size;
	389	}
b4567ca6	390	for (i = 0; additional2[i].fmt; i++) {
1da177e4	391	if (additional2[i].code1 == asc &&
b4567ca6	392	ascq >= additional2[i].code2_min &&
d811b848 HR	393	ascq <= additional2[i].code2_max) {
	394	*fmt = additional2[i].fmt;
	395	return additional2[i].str;
	396	}
b4567ca6	397	}
1da177e4 LT	398	return NULL;
	399	}
	400	EXPORT_SYMBOL(scsi_extd_sense_format);
	401
0ad78200	402	static const char * const hostbyte_table[]={
6391a113	403	"DID_OK", "DID_NO_CONNECT", "DID_BUS_BUSY", "DID_TIME_OUT", "DID_BAD_TARGET",
1da177e4	404	"DID_ABORT", "DID_PARITY", "DID_ERROR", "DID_RESET", "DID_BAD_INTR",
a4dfaa6f	405	"DID_PASSTHROUGH", "DID_SOFT_ERROR", "DID_IMM_RETRY", "DID_REQUEUE",
f1ba8a4f	406	"DID_TRANSPORT_DISRUPTED", "DID_TRANSPORT_FAILFAST", "DID_TARGET_FAILURE",
1b55940b	407	"DID_NEXUS_FAILURE", "DID_ALLOC_FAILURE", "DID_MEDIUM_ERROR" };
1da177e4	408
0ad78200	409	static const char * const driverbyte_table[]={
6391a113	410	"DRIVER_OK", "DRIVER_BUSY", "DRIVER_SOFT", "DRIVER_MEDIA", "DRIVER_ERROR",
1da177e4	411	"DRIVER_INVALID", "DRIVER_TIMEOUT", "DRIVER_HARD", "DRIVER_SENSE"};
1da177e4	412
3cc958cc	413	const char *scsi_hostbyte_string(int result)
1da177e4	414	{
3cc958cc	415	const char *hb_string = NULL;
684b7fe9	416	int hb = host_byte(result);
1da177e4	417
3cc958cc HR	418	if (hb < ARRAY_SIZE(hostbyte_table))
3cc958cc HR	419	hb_string = hostbyte_table[hb];
3cc958cc	420	return hb_string;
1da177e4	421	}
3cc958cc	422	EXPORT_SYMBOL(scsi_hostbyte_string);
684b7fe9	423
3cc958cc HR	424	const char *scsi_driverbyte_string(int result)
	425	{
	426	const char *db_string = NULL;
3cc958cc HR	427	int db = driver_byte(result);
	428
	429	if (db < ARRAY_SIZE(driverbyte_table))
	430	db_string = driverbyte_table[db];
3cc958cc HR	431	return db_string;
	432	}
	433	EXPORT_SYMBOL(scsi_driverbyte_string);
684b7fe9	434
c11c004b HR	435	#define scsi_mlreturn_name(result) { result, #result }
	436	static const struct value_name_pair scsi_mlreturn_arr[] = {
	437	scsi_mlreturn_name(NEEDS_RETRY),
	438	scsi_mlreturn_name(SUCCESS),
	439	scsi_mlreturn_name(FAILED),
	440	scsi_mlreturn_name(QUEUED),
	441	scsi_mlreturn_name(SOFT_ERROR),
	442	scsi_mlreturn_name(ADD_TO_MLQUEUE),
	443	scsi_mlreturn_name(TIMEOUT_ERROR),
	444	scsi_mlreturn_name(SCSI_RETURN_NOT_HANDLED),
	445	scsi_mlreturn_name(FAST_IO_FAIL)
	446	};
c11c004b HR	447
	448	const char *scsi_mlreturn_string(int result)
	449	{
c11c004b HR	450	const struct value_name_pair *arr = scsi_mlreturn_arr;
	451	int k;
	452
	453	for (k = 0; k < ARRAY_SIZE(scsi_mlreturn_arr); ++k, ++arr) {
	454	if (result == arr->value)
	455	return arr->name;
	456	}
c11c004b HR	457	return NULL;
	458	}
	459	EXPORT_SYMBOL(scsi_mlreturn_string);