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 "scsi/spc.h"
  32
  33 /** String descriptions for SCSI peripheral device type.
  34  *
  35  * Only device types that we are ever likely to encounter are listed here.
  36  */
  37 const char *scsi_dev_type_str[SCSI_DEV_LIMIT] = {
  38         [SCSI_DEV_BLOCK]        = "Direct-Access Block Device (Disk)",
  39         [SCSI_DEV_STREAM]       = "Sequential-Access Device (Tape)",
  40         [SCSI_DEV_CD_DVD]       = "CD/DVD",
  41         [SCSI_DEV_CHANGER]      = "Media Changer",
  42         [SCSI_DEV_ENCLOSURE]    = "SCSI Enclosure",
  43         [SCSI_DEV_OSD]          = "Object Storage Device"
  44 };
  45
  46 const char *scsi_sense_key_str[SCSI_SK_LIMIT] = {
  47         [SCSI_SK_NO_SENSE]              = "No Sense",
  48         [SCSI_SK_RECOVERED_ERROR]       = "Recovered Error",
  49         [SCSI_SK_NOT_READY]             = "Not Ready",
  50         [SCSI_SK_MEDIUM_ERROR]          = "Medium Error",
  51         [SCSI_SK_HARDWARE_ERROR]        = "Hardware Error",
  52         [SCSI_SK_ILLEGAL_REQUEST]       = "Illegal Request",
  53         [SCSI_SK_UNIT_ATTENTION]        = "Unit Attention",
  54         [SCSI_SK_DATA_PROTECT]          = "Data Protect",
  55         [SCSI_SK_BLANK_CHECK]           = "Blank Check",
  56         [SCSI_SK_VENDOR_SPECIFIC]       = "Vendor-specific",
  57         [SCSI_SK_COPY_ABORTED]          = "Copy Aborted",
  58         [SCSI_SK_ABORTED_COMMAND]       = "Aborted Command",
  59         [SCSI_SK_VOLUME_OVERFLOW]       = "Volume Overflow",
  60         [SCSI_SK_MISCOMPARE]            = "Miscompare"
  61 };
  62
  63 /** Get peripheral device type string.
  64  *
  65  * Return string description of SCSI peripheral device type.
  66  * The returned string is valid indefinitely, the caller should
  67  * not attempt to free it.
  68  */
  69 const char *scsi_get_dev_type_str(unsigned dev_type)
  70 {
  71         if (dev_type >= SCSI_DEV_LIMIT || scsi_dev_type_str[dev_type] == NULL)
  72                 return "Unknown";
  73
  74         return scsi_dev_type_str[dev_type];
  75 }
  76
  77 /** Get sense key string.
  78  *
  79  * Return string description of SCSI sense key.
  80  * The returned string is valid indefinitely, the caller should
  81  * not attempt to free it.
  82  */
  83 const char *scsi_get_sense_key_str(unsigned sense_key)
  84 {
  85         if (sense_key >= SCSI_SK_LIMIT || scsi_sense_key_str[sense_key] == NULL)
  86                 return "Unknown";
  87
  88         return scsi_sense_key_str[sense_key];
  89 }
  90