1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 /* 22 * Copyright 2012 DEY Storage Systems, Inc. All rights reserved. 23 * Copyright 2015 Nexenta Systems, Inc. All rights reserved. 24 * Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. 25 */ 26 27 #ifndef _SYS_BLKDEV_H 28 #define _SYS_BLKDEV_H 29 30 #include <sys/types.h> 31 #include <sys/ksynch.h> 32 #include <sys/ddi.h> 33 #include <sys/sunddi.h> 34 35 #ifdef __cplusplus 36 extern "C" { 37 #endif 38 39 /* 40 * This describes a fairly simple block device. The idea here is that 41 * these things want to take advantage of the common labelling support, 42 * but do not need all the capabilities of SCSA. So we make quite a few 43 * simplifications: 44 * 45 * 1) Device block size is a power of 2 greater or equal to 512 bytes. 46 * An optional physical block size can be reported if the underlying 47 * device uses larger block sizes internally, so that writes can be 48 * aligned properly. 49 * 50 * 2) Non-rotating media. We assume a simple linear layout. 51 * 52 * 3) Fixed queue depth, for each device. The adapter driver reports 53 * the queue depth at registration. We don't have any form of 54 * dynamic flow control. 55 * 56 * 4) Negligible power management support. The framework does not support 57 * fine grained power management. If the adapter driver wants to use 58 * such, it will need to manage power on its own. 59 * 60 * 5) Suspend/resume support managed by the adapter driver. We don't 61 * support suspend/resume directly. The adapter device driver will 62 * need to manage this on its own behalf. 63 * 64 * 6) No request priorities. Transfers are assumed to execute in 65 * roughly FIFO order. The adapter driver may reorder them, but the 66 * submitter has no control over that. 67 * 68 * 7) No request cancellation. Once submitted, the job completes or 69 * fails. It cannot be canceled. 70 * 71 * 8) Limited support for removable media. There is no support for 72 * locking bay doors or mechanised media bays. This could be 73 * added, but at present the only such interesting devices are 74 * covered by the SCSI disk driver. 75 */ 76 77 typedef struct bd_handle *bd_handle_t; 78 typedef struct bd_xfer bd_xfer_t; 79 typedef struct bd_drive bd_drive_t; 80 typedef struct bd_media bd_media_t; 81 typedef struct bd_ops bd_ops_t; 82 83 84 struct bd_xfer { 85 /* 86 * NB: If using DMA the br_ndmac will be non-zero. Otherwise 87 * the br_kaddr will be non-NULL. 88 */ 89 diskaddr_t x_blkno; 90 size_t x_nblks; 91 ddi_dma_handle_t x_dmah; 92 ddi_dma_cookie_t x_dmac; 93 unsigned x_ndmac; 94 caddr_t x_kaddr; 95 unsigned x_flags; 96 }; 97 98 #define BD_XFER_POLL (1U << 0) /* no interrupts (dump) */ 99 100 struct bd_drive { 101 uint32_t d_qsize; 102 uint32_t d_maxxfer; 103 boolean_t d_removable; 104 boolean_t d_hotpluggable; 105 int d_target; 106 int d_lun; 107 size_t d_vendor_len; 108 char *d_vendor; 109 size_t d_product_len; 110 char *d_product; 111 size_t d_model_len; 112 char *d_model; 113 size_t d_serial_len; 114 char *d_serial; 115 size_t d_revision_len; 116 char *d_revision; 117 }; 118 119 struct bd_media { 120 /* 121 * NB: The block size must be a power of two not less than 122 * DEV_BSIZE (512). Other values of the block size will 123 * simply not function and the media will be rejected. 124 * 125 * The block size must also divide evenly into the device's 126 * d_maxxfer field. If the maxxfer is a power of two larger 127 * than the block size, then this will automatically be 128 * satisfied. 129 * 130 * The physical block size (m_pblksize) must be 0 or a power 131 * of two not less than the block size. 132 */ 133 uint64_t m_nblks; 134 uint32_t m_blksize; 135 boolean_t m_readonly; 136 boolean_t m_solidstate; 137 uint32_t m_pblksize; 138 }; 139 140 #define BD_INFO_FLAG_REMOVABLE (1U << 0) 141 #define BD_INFO_FLAG_HOTPLUGGABLE (1U << 1) 142 #define BD_INFO_FLAG_READ_ONLY (1U << 2) 143 144 struct bd_ops { 145 int o_version; 146 void (*o_drive_info)(void *, bd_drive_t *); 147 int (*o_media_info)(void *, bd_media_t *); 148 int (*o_devid_init)(void *, dev_info_t *, ddi_devid_t *); 149 int (*o_sync_cache)(void *, bd_xfer_t *); 150 int (*o_read)(void *, bd_xfer_t *); 151 int (*o_write)(void *, bd_xfer_t *); 152 }; 153 154 #define BD_OPS_VERSION_0 0 155 156 struct bd_errstats { 157 /* these are managed by blkdev itself */ 158 kstat_named_t bd_softerrs; 159 kstat_named_t bd_harderrs; 160 kstat_named_t bd_transerrs; 161 kstat_named_t bd_model; 162 kstat_named_t bd_vid; 163 kstat_named_t bd_pid; 164 kstat_named_t bd_revision; 165 kstat_named_t bd_serial; 166 kstat_named_t bd_capacity; 167 168 /* the following are updated on behalf of the HW driver */ 169 kstat_named_t bd_rq_media_err; 170 kstat_named_t bd_rq_ntrdy_err; 171 kstat_named_t bd_rq_nodev_err; 172 kstat_named_t bd_rq_recov_err; 173 kstat_named_t bd_rq_illrq_err; 174 kstat_named_t bd_rq_pfa_err; 175 }; 176 177 #define BD_ERR_MEDIA 0 178 #define BD_ERR_NTRDY 1 179 #define BD_ERR_NODEV 2 180 #define BD_ERR_RECOV 3 181 #define BD_ERR_ILLRQ 4 182 #define BD_ERR_PFA 5 183 184 /* 185 * Note, one handler *per* address. Drivers with multiple targets at 186 * different addresses must use separate handles. 187 */ 188 bd_handle_t bd_alloc_handle(void *, bd_ops_t *, ddi_dma_attr_t *, int); 189 void bd_free_handle(bd_handle_t); 190 int bd_attach_handle(dev_info_t *, bd_handle_t); 191 int bd_detach_handle(bd_handle_t); 192 void bd_state_change(bd_handle_t); 193 void bd_xfer_done(bd_xfer_t *, int); 194 void bd_error(bd_xfer_t *, int); 195 void bd_mod_init(struct dev_ops *); 196 void bd_mod_fini(struct dev_ops *); 197 198 #ifdef __cplusplus 199 } 200 #endif 201 202 #endif /* _SYS_BLKDEV_H */ 203