uspace/lib/scsi/src/spc.c

   1 /*
   2  * Copyright (c) 2011 Jiri Svoboda
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * - Redistributions of source code must retain the above copyright
  10  *   notice, this list of conditions and the following disclaimer.
  11  * - Redistributions in binary form must reproduce the above copyright
  12  *   notice, this list of conditions and the following disclaimer in the
  13  *   documentation and/or other materials provided with the distribution.
  14  * - The name of the author may not be used to endorse or promote products
  15  *   derived from this software without specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 #include <stdint.h>
  30 #include <stdlib.h>
  31 #include <stddef.h>
  32 #include "scsi/spc.h"
  33
  34 /** String descriptions for SCSI peripheral device type.
  35  *
  36  * Only device types that we are ever likely to encounter are listed here.
  37  */
  38 const char *scsi_dev_type_str[SCSI_DEV_LIMIT] = {
  39         [SCSI_DEV_BLOCK]        = "Direct-Access Block Device (Disk)",
  40         [SCSI_DEV_STREAM]       = "Sequential-Access Device (Tape)",
  41         [SCSI_DEV_CD_DVD]       = "CD/DVD",
  42         [SCSI_DEV_CHANGER]      = "Media Changer",
  43         [SCSI_DEV_ENCLOSURE]    = "SCSI Enclosure",
  44         [SCSI_DEV_OSD]          = "Object Storage Device"
  45 };
  46
  47 const char *scsi_sense_key_str[SCSI_SK_LIMIT] = {
  48         [SCSI_SK_NO_SENSE]              = "No Sense",
  49         [SCSI_SK_RECOVERED_ERROR]       = "Recovered Error",
  50         [SCSI_SK_NOT_READY]             = "Not Ready",
  51         [SCSI_SK_MEDIUM_ERROR]          = "Medium Error",
  52         [SCSI_SK_HARDWARE_ERROR]        = "Hardware Error",
  53         [SCSI_SK_ILLEGAL_REQUEST]       = "Illegal Request",
  54         [SCSI_SK_UNIT_ATTENTION]        = "Unit Attention",
  55         [SCSI_SK_DATA_PROTECT]          = "Data Protect",
  56         [SCSI_SK_BLANK_CHECK]           = "Blank Check",
  57         [SCSI_SK_VENDOR_SPECIFIC]       = "Vendor-specific",
  58         [SCSI_SK_COPY_ABORTED]          = "Copy Aborted",
  59         [SCSI_SK_ABORTED_COMMAND]       = "Aborted Command",
  60         [SCSI_SK_VOLUME_OVERFLOW]       = "Volume Overflow",
  61         [SCSI_SK_MISCOMPARE]            = "Miscompare"
  62 };
  63
  64 /** Get peripheral device type string.
  65  *
  66  * Return string description of SCSI peripheral device type.
  67  * The returned string is valid indefinitely, the caller should
  68  * not attempt to free it.
  69  */
  70 const char *scsi_get_dev_type_str(unsigned dev_type)
  71 {
  72         if (dev_type >= SCSI_DEV_LIMIT || scsi_dev_type_str[dev_type] == NULL)
  73                 return "Unknown";
  74
  75         return scsi_dev_type_str[dev_type];
  76 }
  77
  78 /** Get sense key string.
  79  *
  80  * Return string description of SCSI sense key.
  81  * The returned string is valid indefinitely, the caller should
  82  * not attempt to free it.
  83  */
  84 const char *scsi_get_sense_key_str(unsigned sense_key)
  85 {
  86         if (sense_key >= SCSI_SK_LIMIT || scsi_sense_key_str[sense_key] == NULL)
  87                 return "Unknown";
  88
  89         return scsi_sense_key_str[sense_key];
  90 }