1 /*- 2 * BSD LICENSE 3 * 4 * Copyright (C) 2008-2012 Daisuke Aoyama <aoyama@peach.ne.jp>. 5 * Copyright (c) Intel Corporation. 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 12 * * Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * * Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in 16 * the documentation and/or other materials provided with the 17 * distribution. 18 * * Neither the name of Intel Corporation nor the names of its 19 * contributors may be used to endorse or promote products derived 20 * from this software without specific prior written permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 33 */ 34 35 #ifndef SPDK_SCSI_INTERNAL_H 36 #define SPDK_SCSI_INTERNAL_H 37 38 #include "spdk/stdinc.h" 39 40 #include "spdk/bdev.h" 41 #include "spdk/scsi.h" 42 #include "spdk/scsi_spec.h" 43 #include "spdk/trace.h" 44 #include "spdk/dif.h" 45 46 #include "spdk/log.h" 47 48 enum { 49 SPDK_SCSI_TASK_UNKNOWN = -1, 50 SPDK_SCSI_TASK_COMPLETE, 51 SPDK_SCSI_TASK_PENDING, 52 }; 53 54 struct spdk_scsi_port { 55 uint8_t is_used; 56 uint64_t id; 57 uint16_t index; 58 uint16_t transport_id_len; 59 char transport_id[SPDK_SCSI_MAX_TRANSPORT_ID_LENGTH]; 60 char name[SPDK_SCSI_PORT_MAX_NAME_LENGTH]; 61 }; 62 63 /* Registrant with I_T nextus */ 64 struct spdk_scsi_pr_registrant { 65 uint64_t rkey; 66 uint16_t relative_target_port_id; 67 uint16_t transport_id_len; 68 char transport_id[SPDK_SCSI_MAX_TRANSPORT_ID_LENGTH]; 69 char initiator_port_name[SPDK_SCSI_PORT_MAX_NAME_LENGTH]; 70 char target_port_name[SPDK_SCSI_PORT_MAX_NAME_LENGTH]; 71 struct spdk_scsi_port *initiator_port; 72 struct spdk_scsi_port *target_port; 73 TAILQ_ENTRY(spdk_scsi_pr_registrant) link; 74 }; 75 76 #define SCSI_SPC2_RESERVE 0x00000001U 77 78 /* Reservation with LU_SCOPE */ 79 struct spdk_scsi_pr_reservation { 80 uint32_t flags; 81 struct spdk_scsi_pr_registrant *holder; 82 enum spdk_scsi_pr_type_code rtype; 83 uint64_t crkey; 84 }; 85 86 struct spdk_scsi_dev { 87 int id; 88 int is_allocated; 89 bool removed; 90 spdk_scsi_dev_destruct_cb_t remove_cb; 91 void *remove_ctx; 92 93 char name[SPDK_SCSI_DEV_MAX_NAME + 1]; 94 95 struct spdk_scsi_lun *lun[SPDK_SCSI_DEV_MAX_LUN]; 96 97 int num_ports; 98 struct spdk_scsi_port port[SPDK_SCSI_DEV_MAX_PORTS]; 99 100 uint8_t protocol_id; 101 }; 102 103 struct spdk_scsi_lun_desc { 104 struct spdk_scsi_lun *lun; 105 spdk_scsi_lun_remove_cb_t hotremove_cb; 106 void *hotremove_ctx; 107 TAILQ_ENTRY(spdk_scsi_lun_desc) link; 108 }; 109 110 struct spdk_scsi_lun { 111 /** LUN id for this logical unit. */ 112 int id; 113 114 /** Pointer to the SCSI device containing this LUN. */ 115 struct spdk_scsi_dev *dev; 116 117 /** The bdev associated with this LUN. */ 118 struct spdk_bdev *bdev; 119 120 /** Descriptor for opened block device. */ 121 struct spdk_bdev_desc *bdev_desc; 122 123 /** The thread which opens this LUN. */ 124 struct spdk_thread *thread; 125 126 /** I/O channel for the bdev associated with this LUN. */ 127 struct spdk_io_channel *io_channel; 128 129 /** The reference number for this LUN, thus we can correctly free the io_channel */ 130 uint32_t ref; 131 132 /** Poller to release the resource of the lun when it is hot removed */ 133 struct spdk_poller *hotremove_poller; 134 135 /** The LUN is removed */ 136 bool removed; 137 138 /** Callback to be fired when LUN removal is first triggered. */ 139 void (*hotremove_cb)(const struct spdk_scsi_lun *lun, void *arg); 140 141 /** Argument for hotremove_cb */ 142 void *hotremove_ctx; 143 144 /** Callback to be fired when the bdev size of related LUN has changed. */ 145 void (*resize_cb)(const struct spdk_scsi_lun *, void *); 146 147 /** Argument for resize_cb */ 148 void *resize_ctx; 149 150 /** Registrant head for I_T nexus */ 151 TAILQ_HEAD(, spdk_scsi_pr_registrant) reg_head; 152 /** Persistent Reservation Generation */ 153 uint32_t pr_generation; 154 /** Reservation for the LUN */ 155 struct spdk_scsi_pr_reservation reservation; 156 /** Reservation holder for SPC2 RESERVE(6) and RESERVE(10) */ 157 struct spdk_scsi_pr_registrant scsi2_holder; 158 159 /** List of open descriptors for this LUN. */ 160 TAILQ_HEAD(, spdk_scsi_lun_desc) open_descs; 161 162 /** submitted tasks */ 163 TAILQ_HEAD(tasks, spdk_scsi_task) tasks; 164 165 /** pending tasks */ 166 TAILQ_HEAD(pending_tasks, spdk_scsi_task) pending_tasks; 167 168 /** submitted management tasks */ 169 TAILQ_HEAD(mgmt_tasks, spdk_scsi_task) mgmt_tasks; 170 171 /** pending management tasks */ 172 TAILQ_HEAD(pending_mgmt_tasks, spdk_scsi_task) pending_mgmt_tasks; 173 174 /** poller to check completion of tasks prior to reset */ 175 struct spdk_poller *reset_poller; 176 }; 177 178 struct spdk_scsi_lun *scsi_lun_construct(const char *bdev_name, 179 void (*resize_cb)(const struct spdk_scsi_lun *, void *), 180 void *resize_ctx, 181 void (*hotremove_cb)(const struct spdk_scsi_lun *, void *), 182 void *hotremove_ctx); 183 void scsi_lun_destruct(struct spdk_scsi_lun *lun); 184 185 void scsi_lun_execute_task(struct spdk_scsi_lun *lun, struct spdk_scsi_task *task); 186 void scsi_lun_execute_mgmt_task(struct spdk_scsi_lun *lun, struct spdk_scsi_task *task); 187 bool scsi_lun_has_pending_mgmt_tasks(const struct spdk_scsi_lun *lun, 188 const struct spdk_scsi_port *initiator_port); 189 void scsi_lun_complete_task(struct spdk_scsi_lun *lun, struct spdk_scsi_task *task); 190 void scsi_lun_complete_reset_task(struct spdk_scsi_lun *lun, struct spdk_scsi_task *task); 191 bool scsi_lun_has_pending_tasks(const struct spdk_scsi_lun *lun, 192 const struct spdk_scsi_port *initiator_port); 193 int scsi_lun_allocate_io_channel(struct spdk_scsi_lun *lun); 194 void scsi_lun_free_io_channel(struct spdk_scsi_lun *lun); 195 196 struct spdk_scsi_dev *scsi_dev_get_list(void); 197 198 int scsi_port_construct(struct spdk_scsi_port *port, uint64_t id, 199 uint16_t index, const char *name); 200 void scsi_port_destruct(struct spdk_scsi_port *port); 201 202 int bdev_scsi_execute(struct spdk_scsi_task *task); 203 void bdev_scsi_reset(struct spdk_scsi_task *task); 204 205 bool bdev_scsi_get_dif_ctx(struct spdk_bdev *bdev, struct spdk_scsi_task *task, 206 struct spdk_dif_ctx *dif_ctx); 207 208 int scsi_pr_out(struct spdk_scsi_task *task, uint8_t *cdb, uint8_t *data, uint16_t data_len); 209 int scsi_pr_in(struct spdk_scsi_task *task, uint8_t *cdb, uint8_t *data, uint16_t data_len); 210 int scsi_pr_check(struct spdk_scsi_task *task); 211 212 int scsi2_reserve(struct spdk_scsi_task *task, uint8_t *cdb); 213 int scsi2_release(struct spdk_scsi_task *task); 214 int scsi2_reserve_check(struct spdk_scsi_task *task); 215 216 struct spdk_scsi_globals { 217 pthread_mutex_t mutex; 218 }; 219 220 extern struct spdk_scsi_globals g_scsi; 221 222 #endif /* SPDK_SCSI_INTERNAL_H */ 223