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 2016 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 #define BD_XFER_MHD_TKOWN (1U << 1)
100 #define BD_XFER_MHD_RELEASE (1U << 2)
101 #define BD_XFER_MHD_STATUS (1U << 3)
102 #define BD_XFER_MHD_QRESERVE (1U << 4)
103 #define BD_XFER_MHD_ENFAILFAST (1U << 5)
104
105 struct bd_drive {
106 uint32_t d_qsize;
107 uint32_t d_maxxfer;
108 boolean_t d_removable;
109 boolean_t d_hotpluggable;
110 int d_target;
111 int d_lun;
112 size_t d_vendor_len;
113 char *d_vendor;
114 size_t d_product_len;
115 char *d_product;
116 size_t d_model_len;
117 char *d_model;
118 size_t d_serial_len;
119 char *d_serial;
120 size_t d_revision_len;
121 char *d_revision;
122 uint8_t d_eui64[8];
123 };
124
125 struct bd_media {
126 /*
127 * NB: The block size must be a power of two not less than
128 * DEV_BSIZE (512). Other values of the block size will
129 * simply not function and the media will be rejected.
130 *
131 * The block size must also divide evenly into the device's
132 * d_maxxfer field. If the maxxfer is a power of two larger
133 * than the block size, then this will automatically be
134 * satisfied.
135 *
136 * The physical block size (m_pblksize) must be 0 or a power
137 * of two not less than the block size.
138 */
139 uint64_t m_nblks;
140 uint32_t m_blksize;
141 boolean_t m_readonly;
142 boolean_t m_solidstate;
143 uint32_t m_pblksize;
144 };
145
146 #define BD_INFO_FLAG_REMOVABLE (1U << 0)
147 #define BD_INFO_FLAG_HOTPLUGGABLE (1U << 1)
148 #define BD_INFO_FLAG_READ_ONLY (1U << 2)
149
150 struct bd_ops {
151 int o_version;
152 void (*o_drive_info)(void *, bd_drive_t *);
153 int (*o_media_info)(void *, bd_media_t *);
154 int (*o_devid_init)(void *, dev_info_t *, ddi_devid_t *);
155 int (*o_sync_cache)(void *, bd_xfer_t *);
156 int (*o_read)(void *, bd_xfer_t *);
157 int (*o_write)(void *, bd_xfer_t *);
158 int (*o_reserve)(void *, bd_xfer_t *);
159 };
160
161 #define BD_OPS_VERSION_0 0
162
163 struct bd_errstats {
164 /* these are managed by blkdev itself */
165 kstat_named_t bd_softerrs;
166 kstat_named_t bd_harderrs;
167 kstat_named_t bd_transerrs;
168 kstat_named_t bd_model;
169 kstat_named_t bd_vid;
170 kstat_named_t bd_pid;
171 kstat_named_t bd_revision;
172 kstat_named_t bd_serial;
173 kstat_named_t bd_capacity;
174
175 /* the following are updated on behalf of the HW driver */
176 kstat_named_t bd_rq_media_err;
177 kstat_named_t bd_rq_ntrdy_err;
178 kstat_named_t bd_rq_nodev_err;
179 kstat_named_t bd_rq_recov_err;
180 kstat_named_t bd_rq_illrq_err;
181 kstat_named_t bd_rq_pfa_err;
182 };
183
184 #define BD_ERR_MEDIA 0
185 #define BD_ERR_NTRDY 1
186 #define BD_ERR_NODEV 2
187 #define BD_ERR_RECOV 3
188 #define BD_ERR_ILLRQ 4
189 #define BD_ERR_PFA 5
190
191 /*
192 * Note, one handler *per* address. Drivers with multiple targets at
193 * different addresses must use separate handles.
194 */
195 bd_handle_t bd_alloc_handle(void *, bd_ops_t *, ddi_dma_attr_t *, int);
196 void bd_free_handle(bd_handle_t);
197 int bd_attach_handle(dev_info_t *, bd_handle_t);
198 int bd_detach_handle(bd_handle_t);
199 void bd_state_change(bd_handle_t);
200 void bd_xfer_done(bd_xfer_t *, int);
201 void bd_error(bd_xfer_t *, int);
202 void bd_mod_init(struct dev_ops *);
203 void bd_mod_fini(struct dev_ops *);
204
205 #ifdef __cplusplus
206 }
207 #endif
208
209 #endif /* _SYS_BLKDEV_H */