1275c9da8Seschrock /* 2275c9da8Seschrock * CDDL HEADER START 3275c9da8Seschrock * 4275c9da8Seschrock * The contents of this file are subject to the terms of the 5275c9da8Seschrock * Common Development and Distribution License (the "License"). 6275c9da8Seschrock * You may not use this file except in compliance with the License. 7275c9da8Seschrock * 8275c9da8Seschrock * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9275c9da8Seschrock * or http://www.opensolaris.org/os/licensing. 10275c9da8Seschrock * See the License for the specific language governing permissions 11275c9da8Seschrock * and limitations under the License. 12275c9da8Seschrock * 13275c9da8Seschrock * When distributing Covered Code, include this CDDL HEADER in each 14275c9da8Seschrock * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15275c9da8Seschrock * If applicable, add the following below this CDDL HEADER, with the 16275c9da8Seschrock * fields enclosed by brackets "[]" replaced with your own identifying 17275c9da8Seschrock * information: Portions Copyright [yyyy] [name of copyright owner] 18275c9da8Seschrock * 19275c9da8Seschrock * CDDL HEADER END 20275c9da8Seschrock */ 21275c9da8Seschrock 22275c9da8Seschrock /* 23ac88567aSHyon Kim * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved. 24b75e7d76SRobert Mustacchi * Copyright (c) 2017, Joyent, Inc. 25275c9da8Seschrock */ 26275c9da8Seschrock 27275c9da8Seschrock #ifndef _LIBSCSI_H 28275c9da8Seschrock #define _LIBSCSI_H 29275c9da8Seschrock 30275c9da8Seschrock #ifdef __cplusplus 31275c9da8Seschrock extern "C" { 32275c9da8Seschrock #endif 33275c9da8Seschrock 34275c9da8Seschrock #include <sys/types.h> 35275c9da8Seschrock #include <sys/sysmacros.h> 36275c9da8Seschrock #include <sys/scsi/impl/spc3_types.h> 37275c9da8Seschrock #include <stdarg.h> 38275c9da8Seschrock 39275c9da8Seschrock #define LIBSCSI_VERSION 1 40275c9da8Seschrock #define LIBSCSI_STATUS_INVALID ((sam4_status_t)-1) 41275c9da8Seschrock #define LIBSCSI_DEFAULT_ENGINE_PATH "/usr/lib/scsi/plugins/scsi/engines" 42275c9da8Seschrock #define LIBSCSI_DEFAULT_ENGINE "uscsi" 43275c9da8Seschrock 44275c9da8Seschrock /* 45275c9da8Seschrock * Flags for action creation. Selected to avoid overlap with the uscsi 46275c9da8Seschrock * flags with similar or identical meaning. 47275c9da8Seschrock */ 48275c9da8Seschrock #define LIBSCSI_AF_READ 0x80000000 49275c9da8Seschrock #define LIBSCSI_AF_WRITE 0x40000000 50275c9da8Seschrock #define LIBSCSI_AF_SILENT 0x20000000 51275c9da8Seschrock #define LIBSCSI_AF_DIAGNOSE 0x10000000 52275c9da8Seschrock #define LIBSCSI_AF_ISOLATE 0x08000000 53275c9da8Seschrock #define LIBSCSI_AF_RQSENSE 0x04000000 54275c9da8Seschrock 55275c9da8Seschrock typedef enum libscsi_errno { 56275c9da8Seschrock ESCSI_NONE, /* no error */ 57275c9da8Seschrock ESCSI_NOMEM, /* no memory */ 58275c9da8Seschrock ESCSI_ZERO_LENGTH, /* zero-length allocation requested */ 59275c9da8Seschrock ESCSI_VERSION, /* library version mismatch */ 60275c9da8Seschrock ESCSI_BADTARGET, /* invalid target specification */ 61275c9da8Seschrock ESCSI_BADCMD, /* invalid SCSI command */ 62275c9da8Seschrock ESCSI_BADENGINE, /* engine library corrupt */ 63275c9da8Seschrock ESCSI_NOENGINE, /* engine library not found */ 64275c9da8Seschrock ESCSI_ENGINE_INIT, /* engine initialization failed */ 65275c9da8Seschrock ESCSI_ENGINE_VER, /* engine version mismatch */ 66275c9da8Seschrock ESCSI_ENGINE_BADPATH, /* engine path contains no usable components */ 67275c9da8Seschrock ESCSI_BADFLAGS, /* incorrect action flags */ 68275c9da8Seschrock ESCSI_BOGUSFLAGS, /* unknown flag value */ 69275c9da8Seschrock ESCSI_BADLENGTH, /* buffer length overflow */ 70275c9da8Seschrock ESCSI_NEEDBUF, /* missing required buffer */ 71275c9da8Seschrock ESCSI_IO, /* I/O operation failed */ 72275c9da8Seschrock ESCSI_SYS, /* system call failed */ 73275c9da8Seschrock ESCSI_PERM, /* insufficient permissions */ 74275c9da8Seschrock ESCSI_RANGE, /* parameter outside valid range */ 75275c9da8Seschrock ESCSI_NOTSUP, /* operation not supported */ 76275c9da8Seschrock ESCSI_UNKNOWN, /* error of unknown type */ 77275c9da8Seschrock ESCSI_INQUIRY_FAILED, /* initial inquiry command failed */ 78275c9da8Seschrock ESCSI_MAX /* maximum libscsi errno value */ 79275c9da8Seschrock } libscsi_errno_t; 80275c9da8Seschrock 81275c9da8Seschrock struct libscsi_hdl; 82275c9da8Seschrock typedef struct libscsi_hdl libscsi_hdl_t; 83275c9da8Seschrock 84275c9da8Seschrock struct libscsi_target; 85275c9da8Seschrock typedef struct libscsi_target libscsi_target_t; 86275c9da8Seschrock 87275c9da8Seschrock typedef struct libscsi_status { 88275c9da8Seschrock uint64_t lss_status; /* SCSI status of this command */ 89275c9da8Seschrock size_t lss_sense_len; /* Length in bytes of sense data */ 90275c9da8Seschrock uint8_t *lss_sense_data; /* Pointer to sense data */ 91275c9da8Seschrock } libscsi_status_t; 92275c9da8Seschrock 93275c9da8Seschrock struct libscsi_action; 94275c9da8Seschrock typedef struct libscsi_action libscsi_action_t; 95275c9da8Seschrock 96275c9da8Seschrock typedef struct libscsi_engine_ops { 97275c9da8Seschrock void *(*lseo_open)(libscsi_hdl_t *, const void *); 98275c9da8Seschrock void (*lseo_close)(libscsi_hdl_t *, void *); 99275c9da8Seschrock int (*lseo_exec)(libscsi_hdl_t *, void *, libscsi_action_t *); 100275c9da8Seschrock void (*lseo_target_name)(libscsi_hdl_t *, void *, char *, size_t); 101*0b4d6575SRobert Mustacchi int (*lseo_max_transfer)(libscsi_hdl_t *, void *, size_t *); 102275c9da8Seschrock } libscsi_engine_ops_t; 103275c9da8Seschrock 104275c9da8Seschrock typedef struct libscsi_engine { 105275c9da8Seschrock const char *lse_name; 106275c9da8Seschrock uint_t lse_libversion; 107275c9da8Seschrock const libscsi_engine_ops_t *lse_ops; 108275c9da8Seschrock } libscsi_engine_t; 109275c9da8Seschrock 110275c9da8Seschrock extern libscsi_hdl_t *libscsi_init(uint_t, libscsi_errno_t *); 111275c9da8Seschrock extern void libscsi_fini(libscsi_hdl_t *); 112275c9da8Seschrock 113275c9da8Seschrock extern libscsi_target_t *libscsi_open(libscsi_hdl_t *, const char *, 114275c9da8Seschrock const void *); 115275c9da8Seschrock extern void libscsi_close(libscsi_hdl_t *, libscsi_target_t *); 116275c9da8Seschrock extern libscsi_hdl_t *libscsi_get_handle(libscsi_target_t *); 117275c9da8Seschrock 118275c9da8Seschrock extern const char *libscsi_vendor(libscsi_target_t *); 119275c9da8Seschrock extern const char *libscsi_product(libscsi_target_t *); 120275c9da8Seschrock extern const char *libscsi_revision(libscsi_target_t *); 121*0b4d6575SRobert Mustacchi extern int libscsi_max_transfer(libscsi_target_t *, size_t *); 122275c9da8Seschrock 123275c9da8Seschrock extern libscsi_errno_t libscsi_errno(libscsi_hdl_t *); 124275c9da8Seschrock extern const char *libscsi_errmsg(libscsi_hdl_t *); 125275c9da8Seschrock extern const char *libscsi_strerror(libscsi_errno_t); 126275c9da8Seschrock extern const char *libscsi_errname(libscsi_errno_t); 127275c9da8Seschrock extern libscsi_errno_t libscsi_errcode(const char *); 128275c9da8Seschrock 129275c9da8Seschrock extern libscsi_action_t *libscsi_action_alloc(libscsi_hdl_t *, spc3_cmd_t, 130275c9da8Seschrock uint_t, void *, size_t); 131b75e7d76SRobert Mustacchi extern libscsi_action_t *libscsi_action_alloc_vendor(libscsi_hdl_t *, 132b75e7d76SRobert Mustacchi spc3_cmd_t, size_t, uint_t, void *, size_t); 133275c9da8Seschrock extern sam4_status_t libscsi_action_get_status(const libscsi_action_t *); 134275c9da8Seschrock extern void libscsi_action_set_timeout(libscsi_action_t *, uint32_t); 135b75e7d76SRobert Mustacchi extern size_t libscsi_action_get_cdblen(const libscsi_action_t *); 136275c9da8Seschrock extern uint32_t libscsi_action_get_timeout(const libscsi_action_t *); 137275c9da8Seschrock extern uint_t libscsi_action_get_flags(const libscsi_action_t *); 138275c9da8Seschrock extern uint8_t *libscsi_action_get_cdb(const libscsi_action_t *); 139275c9da8Seschrock extern int libscsi_action_get_buffer(const libscsi_action_t *, 140275c9da8Seschrock uint8_t **, size_t *, size_t *); 141275c9da8Seschrock extern int libscsi_action_get_sense(const libscsi_action_t *, 142275c9da8Seschrock uint8_t **, size_t *, size_t *); 143275c9da8Seschrock extern int libscsi_action_parse_sense(const libscsi_action_t *, uint64_t *, 144275c9da8Seschrock uint64_t *, uint64_t *, diskaddr_t *); 145275c9da8Seschrock extern void libscsi_action_set_status(libscsi_action_t *, sam4_status_t); 146275c9da8Seschrock extern int libscsi_action_set_datalen(libscsi_action_t *, size_t); 147275c9da8Seschrock extern int libscsi_action_set_senselen(libscsi_action_t *, size_t); 148275c9da8Seschrock extern int libscsi_exec(libscsi_action_t *, libscsi_target_t *); 149275c9da8Seschrock extern void libscsi_action_free(libscsi_action_t *); 150275c9da8Seschrock 151275c9da8Seschrock extern const char *libscsi_sense_key_name(uint64_t); 152275c9da8Seschrock extern const char *libscsi_sense_code_name(uint64_t, uint64_t); 153275c9da8Seschrock 154275c9da8Seschrock /* 155275c9da8Seschrock * Interfaces for engine providers 156275c9da8Seschrock */ 157275c9da8Seschrock extern void *libscsi_alloc(libscsi_hdl_t *, size_t); 158275c9da8Seschrock extern void *libscsi_zalloc(libscsi_hdl_t *, size_t); 159275c9da8Seschrock extern char *libscsi_strdup(libscsi_hdl_t *, const char *); 160275c9da8Seschrock extern void libscsi_free(libscsi_hdl_t *, void *); 161275c9da8Seschrock extern libscsi_status_t *libscsi_status_alloc(libscsi_hdl_t *, size_t); 162275c9da8Seschrock extern int libscsi_status_fill(libscsi_hdl_t *, libscsi_status_t *, 163275c9da8Seschrock uint16_t, size_t); 164275c9da8Seschrock extern void libscsi_status_free(libscsi_hdl_t *, libscsi_status_t *); 165275c9da8Seschrock 166275c9da8Seschrock extern int libscsi_set_errno(libscsi_hdl_t *, libscsi_errno_t); 167275c9da8Seschrock extern int libscsi_verror(libscsi_hdl_t *, libscsi_errno_t, const char *, 168275c9da8Seschrock va_list); 169275c9da8Seschrock extern int libscsi_error(libscsi_hdl_t *, libscsi_errno_t, const char *, ...); 170275c9da8Seschrock 171275c9da8Seschrock typedef const libscsi_engine_t *(*libscsi_engine_init_f)(libscsi_hdl_t *); 172275c9da8Seschrock 173275c9da8Seschrock /* 174275c9da8Seschrock * Generic SCSI utility functions. 175275c9da8Seschrock */ 176275c9da8Seschrock extern size_t libscsi_cmd_cdblen(libscsi_hdl_t *, uint8_t); 177275c9da8Seschrock 178275c9da8Seschrock #ifdef __cplusplus 179275c9da8Seschrock } 180275c9da8Seschrock #endif 181275c9da8Seschrock 182275c9da8Seschrock #endif /* _LIBSCSI_H */ 183