linux-headers (unknown)
1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2 /*
3 * I2O user space accessible structures/APIs
4 *
5 * (c) Copyright 1999, 2000 Red Hat Software
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
11 *
12 *************************************************************************
13 *
14 * This header file defines the I2O APIs that are available to both
15 * the kernel and user level applications. Kernel specific structures
16 * are defined in i2o_osm. OSMs should include _only_ i2o_osm.h which
17 * automatically includes this file.
18 *
19 */
20
21 #ifndef _I2O_DEV_H
22 #define _I2O_DEV_H
23
24 /* How many controllers are we allowing */
25 #define MAX_I2O_CONTROLLERS 32
26
27 #include <linux/ioctl.h>
28 #include <linux/types.h>
29
30 /*
31 * I2O Control IOCTLs and structures
32 */
33 #define I2O_MAGIC_NUMBER 'i'
34 #define I2OGETIOPS _IOR(I2O_MAGIC_NUMBER,0,__u8[MAX_I2O_CONTROLLERS])
35 #define I2OHRTGET _IOWR(I2O_MAGIC_NUMBER,1,struct i2o_cmd_hrtlct)
36 #define I2OLCTGET _IOWR(I2O_MAGIC_NUMBER,2,struct i2o_cmd_hrtlct)
37 #define I2OPARMSET _IOWR(I2O_MAGIC_NUMBER,3,struct i2o_cmd_psetget)
38 #define I2OPARMGET _IOWR(I2O_MAGIC_NUMBER,4,struct i2o_cmd_psetget)
39 #define I2OSWDL _IOWR(I2O_MAGIC_NUMBER,5,struct i2o_sw_xfer)
40 #define I2OSWUL _IOWR(I2O_MAGIC_NUMBER,6,struct i2o_sw_xfer)
41 #define I2OSWDEL _IOWR(I2O_MAGIC_NUMBER,7,struct i2o_sw_xfer)
42 #define I2OVALIDATE _IOR(I2O_MAGIC_NUMBER,8,__u32)
43 #define I2OHTML _IOWR(I2O_MAGIC_NUMBER,9,struct i2o_html)
44 #define I2OEVTREG _IOW(I2O_MAGIC_NUMBER,10,struct i2o_evt_id)
45 #define I2OEVTGET _IOR(I2O_MAGIC_NUMBER,11,struct i2o_evt_info)
46 #define I2OPASSTHRU _IOR(I2O_MAGIC_NUMBER,12,struct i2o_cmd_passthru)
47 #define I2OPASSTHRU32 _IOR(I2O_MAGIC_NUMBER,12,struct i2o_cmd_passthru32)
48
49 struct i2o_cmd_passthru32 {
50 unsigned int iop; /* IOP unit number */
51 __u32 msg; /* message */
52 };
53
54 struct i2o_cmd_passthru {
55 unsigned int iop; /* IOP unit number */
56 void *msg; /* message */
57 };
58
59 struct i2o_cmd_hrtlct {
60 unsigned int iop; /* IOP unit number */
61 void *resbuf; /* Buffer for result */
62 unsigned int *reslen; /* Buffer length in bytes */
63 };
64
65 struct i2o_cmd_psetget {
66 unsigned int iop; /* IOP unit number */
67 unsigned int tid; /* Target device TID */
68 void *opbuf; /* Operation List buffer */
69 unsigned int oplen; /* Operation List buffer length in bytes */
70 void *resbuf; /* Result List buffer */
71 unsigned int *reslen; /* Result List buffer length in bytes */
72 };
73
74 struct i2o_sw_xfer {
75 unsigned int iop; /* IOP unit number */
76 unsigned char flags; /* Flags field */
77 unsigned char sw_type; /* Software type */
78 unsigned int sw_id; /* Software ID */
79 void *buf; /* Pointer to software buffer */
80 unsigned int *swlen; /* Length of software data */
81 unsigned int *maxfrag; /* Maximum fragment count */
82 unsigned int *curfrag; /* Current fragment count */
83 };
84
85 struct i2o_html {
86 unsigned int iop; /* IOP unit number */
87 unsigned int tid; /* Target device ID */
88 unsigned int page; /* HTML page */
89 void *resbuf; /* Buffer for reply HTML page */
90 unsigned int *reslen; /* Length in bytes of reply buffer */
91 void *qbuf; /* Pointer to HTTP query string */
92 unsigned int qlen; /* Length in bytes of query string buffer */
93 };
94
95 #define I2O_EVT_Q_LEN 32
96
97 struct i2o_evt_id {
98 unsigned int iop;
99 unsigned int tid;
100 unsigned int evt_mask;
101 };
102
103 /* Event data size = frame size - message header + evt indicator */
104 #define I2O_EVT_DATA_SIZE 88
105
106 struct i2o_evt_info {
107 struct i2o_evt_id id;
108 unsigned char evt_data[I2O_EVT_DATA_SIZE];
109 unsigned int data_size;
110 };
111
112 struct i2o_evt_get {
113 struct i2o_evt_info info;
114 int pending;
115 int lost;
116 };
117
118 typedef struct i2o_sg_io_hdr {
119 unsigned int flags; /* see I2O_DPT_SG_IO_FLAGS */
120 } i2o_sg_io_hdr_t;
121
122 /**************************************************************************
123 * HRT related constants and structures
124 **************************************************************************/
125 #define I2O_BUS_LOCAL 0
126 #define I2O_BUS_ISA 1
127 #define I2O_BUS_EISA 2
128 /* was I2O_BUS_MCA 3 */
129 #define I2O_BUS_PCI 4
130 #define I2O_BUS_PCMCIA 5
131 #define I2O_BUS_NUBUS 6
132 #define I2O_BUS_CARDBUS 7
133 #define I2O_BUS_UNKNOWN 0x80
134
135 typedef struct _i2o_pci_bus {
136 __u8 PciFunctionNumber;
137 __u8 PciDeviceNumber;
138 __u8 PciBusNumber;
139 __u8 reserved;
140 __u16 PciVendorID;
141 __u16 PciDeviceID;
142 } i2o_pci_bus;
143
144 typedef struct _i2o_local_bus {
145 __u16 LbBaseIOPort;
146 __u16 reserved;
147 __u32 LbBaseMemoryAddress;
148 } i2o_local_bus;
149
150 typedef struct _i2o_isa_bus {
151 __u16 IsaBaseIOPort;
152 __u8 CSN;
153 __u8 reserved;
154 __u32 IsaBaseMemoryAddress;
155 } i2o_isa_bus;
156
157 typedef struct _i2o_eisa_bus_info {
158 __u16 EisaBaseIOPort;
159 __u8 reserved;
160 __u8 EisaSlotNumber;
161 __u32 EisaBaseMemoryAddress;
162 } i2o_eisa_bus;
163
164 typedef struct _i2o_mca_bus {
165 __u16 McaBaseIOPort;
166 __u8 reserved;
167 __u8 McaSlotNumber;
168 __u32 McaBaseMemoryAddress;
169 } i2o_mca_bus;
170
171 typedef struct _i2o_other_bus {
172 __u16 BaseIOPort;
173 __u16 reserved;
174 __u32 BaseMemoryAddress;
175 } i2o_other_bus;
176
177 typedef struct _i2o_hrt_entry {
178 __u32 adapter_id;
179 __u32 parent_tid:12;
180 __u32 state:4;
181 __u32 bus_num:8;
182 __u32 bus_type:8;
183 union {
184 i2o_pci_bus pci_bus;
185 i2o_local_bus local_bus;
186 i2o_isa_bus isa_bus;
187 i2o_eisa_bus eisa_bus;
188 i2o_mca_bus mca_bus;
189 i2o_other_bus other_bus;
190 } bus;
191 } i2o_hrt_entry;
192
193 typedef struct _i2o_hrt {
194 __u16 num_entries;
195 __u8 entry_len;
196 __u8 hrt_version;
197 __u32 change_ind;
198 i2o_hrt_entry hrt_entry[1];
199 } i2o_hrt;
200
201 typedef struct _i2o_lct_entry {
202 __u32 entry_size:16;
203 __u32 tid:12;
204 __u32 reserved:4;
205 __u32 change_ind;
206 __u32 device_flags;
207 __u32 class_id:12;
208 __u32 version:4;
209 __u32 vendor_id:16;
210 __u32 sub_class;
211 __u32 user_tid:12;
212 __u32 parent_tid:12;
213 __u32 bios_info:8;
214 __u8 identity_tag[8];
215 __u32 event_capabilities;
216 } i2o_lct_entry;
217
218 typedef struct _i2o_lct {
219 __u32 table_size:16;
220 __u32 boot_tid:12;
221 __u32 lct_ver:4;
222 __u32 iop_flags;
223 __u32 change_ind;
224 i2o_lct_entry lct_entry[1];
225 } i2o_lct;
226
227 typedef struct _i2o_status_block {
228 __u16 org_id;
229 __u16 reserved;
230 __u16 iop_id:12;
231 __u16 reserved1:4;
232 __u16 host_unit_id;
233 __u16 segment_number:12;
234 __u16 i2o_version:4;
235 __u8 iop_state;
236 __u8 msg_type;
237 __u16 inbound_frame_size;
238 __u8 init_code;
239 __u8 reserved2;
240 __u32 max_inbound_frames;
241 __u32 cur_inbound_frames;
242 __u32 max_outbound_frames;
243 char product_id[24];
244 __u32 expected_lct_size;
245 __u32 iop_capabilities;
246 __u32 desired_mem_size;
247 __u32 current_mem_size;
248 __u32 current_mem_base;
249 __u32 desired_io_size;
250 __u32 current_io_size;
251 __u32 current_io_base;
252 __u32 reserved3:24;
253 __u32 cmd_status:8;
254 } i2o_status_block;
255
256 /* Event indicator mask flags */
257 #define I2O_EVT_IND_STATE_CHANGE 0x80000000
258 #define I2O_EVT_IND_GENERAL_WARNING 0x40000000
259 #define I2O_EVT_IND_CONFIGURATION_FLAG 0x20000000
260 #define I2O_EVT_IND_LOCK_RELEASE 0x10000000
261 #define I2O_EVT_IND_CAPABILITY_CHANGE 0x08000000
262 #define I2O_EVT_IND_DEVICE_RESET 0x04000000
263 #define I2O_EVT_IND_EVT_MASK_MODIFIED 0x02000000
264 #define I2O_EVT_IND_FIELD_MODIFIED 0x01000000
265 #define I2O_EVT_IND_VENDOR_EVT 0x00800000
266 #define I2O_EVT_IND_DEVICE_STATE 0x00400000
267
268 /* Executive event indicitors */
269 #define I2O_EVT_IND_EXEC_RESOURCE_LIMITS 0x00000001
270 #define I2O_EVT_IND_EXEC_CONNECTION_FAIL 0x00000002
271 #define I2O_EVT_IND_EXEC_ADAPTER_FAULT 0x00000004
272 #define I2O_EVT_IND_EXEC_POWER_FAIL 0x00000008
273 #define I2O_EVT_IND_EXEC_RESET_PENDING 0x00000010
274 #define I2O_EVT_IND_EXEC_RESET_IMMINENT 0x00000020
275 #define I2O_EVT_IND_EXEC_HW_FAIL 0x00000040
276 #define I2O_EVT_IND_EXEC_XCT_CHANGE 0x00000080
277 #define I2O_EVT_IND_EXEC_NEW_LCT_ENTRY 0x00000100
278 #define I2O_EVT_IND_EXEC_MODIFIED_LCT 0x00000200
279 #define I2O_EVT_IND_EXEC_DDM_AVAILABILITY 0x00000400
280
281 /* Random Block Storage Event Indicators */
282 #define I2O_EVT_IND_BSA_VOLUME_LOAD 0x00000001
283 #define I2O_EVT_IND_BSA_VOLUME_UNLOAD 0x00000002
284 #define I2O_EVT_IND_BSA_VOLUME_UNLOAD_REQ 0x00000004
285 #define I2O_EVT_IND_BSA_CAPACITY_CHANGE 0x00000008
286 #define I2O_EVT_IND_BSA_SCSI_SMART 0x00000010
287
288 /* Event data for generic events */
289 #define I2O_EVT_STATE_CHANGE_NORMAL 0x00
290 #define I2O_EVT_STATE_CHANGE_SUSPENDED 0x01
291 #define I2O_EVT_STATE_CHANGE_RESTART 0x02
292 #define I2O_EVT_STATE_CHANGE_NA_RECOVER 0x03
293 #define I2O_EVT_STATE_CHANGE_NA_NO_RECOVER 0x04
294 #define I2O_EVT_STATE_CHANGE_QUIESCE_REQUEST 0x05
295 #define I2O_EVT_STATE_CHANGE_FAILED 0x10
296 #define I2O_EVT_STATE_CHANGE_FAULTED 0x11
297
298 #define I2O_EVT_GEN_WARNING_NORMAL 0x00
299 #define I2O_EVT_GEN_WARNING_ERROR_THRESHOLD 0x01
300 #define I2O_EVT_GEN_WARNING_MEDIA_FAULT 0x02
301
302 #define I2O_EVT_CAPABILITY_OTHER 0x01
303 #define I2O_EVT_CAPABILITY_CHANGED 0x02
304
305 #define I2O_EVT_SENSOR_STATE_CHANGED 0x01
306
307 /*
308 * I2O classes / subclasses
309 */
310
311 /* Class ID and Code Assignments
312 * (LCT.ClassID.Version field)
313 */
314 #define I2O_CLASS_VERSION_10 0x00
315 #define I2O_CLASS_VERSION_11 0x01
316
317 /* Class code names
318 * (from v1.5 Table 6-1 Class Code Assignments.)
319 */
320
321 #define I2O_CLASS_EXECUTIVE 0x000
322 #define I2O_CLASS_DDM 0x001
323 #define I2O_CLASS_RANDOM_BLOCK_STORAGE 0x010
324 #define I2O_CLASS_SEQUENTIAL_STORAGE 0x011
325 #define I2O_CLASS_LAN 0x020
326 #define I2O_CLASS_WAN 0x030
327 #define I2O_CLASS_FIBRE_CHANNEL_PORT 0x040
328 #define I2O_CLASS_FIBRE_CHANNEL_PERIPHERAL 0x041
329 #define I2O_CLASS_SCSI_PERIPHERAL 0x051
330 #define I2O_CLASS_ATE_PORT 0x060
331 #define I2O_CLASS_ATE_PERIPHERAL 0x061
332 #define I2O_CLASS_FLOPPY_CONTROLLER 0x070
333 #define I2O_CLASS_FLOPPY_DEVICE 0x071
334 #define I2O_CLASS_BUS_ADAPTER 0x080
335 #define I2O_CLASS_PEER_TRANSPORT_AGENT 0x090
336 #define I2O_CLASS_PEER_TRANSPORT 0x091
337 #define I2O_CLASS_END 0xfff
338
339 /*
340 * Rest of 0x092 - 0x09f reserved for peer-to-peer classes
341 */
342
343 #define I2O_CLASS_MATCH_ANYCLASS 0xffffffff
344
345 /*
346 * Subclasses
347 */
348
349 #define I2O_SUBCLASS_i960 0x001
350 #define I2O_SUBCLASS_HDM 0x020
351 #define I2O_SUBCLASS_ISM 0x021
352
353 /* Operation functions */
354
355 #define I2O_PARAMS_FIELD_GET 0x0001
356 #define I2O_PARAMS_LIST_GET 0x0002
357 #define I2O_PARAMS_MORE_GET 0x0003
358 #define I2O_PARAMS_SIZE_GET 0x0004
359 #define I2O_PARAMS_TABLE_GET 0x0005
360 #define I2O_PARAMS_FIELD_SET 0x0006
361 #define I2O_PARAMS_LIST_SET 0x0007
362 #define I2O_PARAMS_ROW_ADD 0x0008
363 #define I2O_PARAMS_ROW_DELETE 0x0009
364 #define I2O_PARAMS_TABLE_CLEAR 0x000A
365
366 /*
367 * I2O serial number conventions / formats
368 * (circa v1.5)
369 */
370
371 #define I2O_SNFORMAT_UNKNOWN 0
372 #define I2O_SNFORMAT_BINARY 1
373 #define I2O_SNFORMAT_ASCII 2
374 #define I2O_SNFORMAT_UNICODE 3
375 #define I2O_SNFORMAT_LAN48_MAC 4
376 #define I2O_SNFORMAT_WAN 5
377
378 /*
379 * Plus new in v2.0 (Yellowstone pdf doc)
380 */
381
382 #define I2O_SNFORMAT_LAN64_MAC 6
383 #define I2O_SNFORMAT_DDM 7
384 #define I2O_SNFORMAT_IEEE_REG64 8
385 #define I2O_SNFORMAT_IEEE_REG128 9
386 #define I2O_SNFORMAT_UNKNOWN2 0xff
387
388 /*
389 * I2O Get Status State values
390 */
391
392 #define ADAPTER_STATE_INITIALIZING 0x01
393 #define ADAPTER_STATE_RESET 0x02
394 #define ADAPTER_STATE_HOLD 0x04
395 #define ADAPTER_STATE_READY 0x05
396 #define ADAPTER_STATE_OPERATIONAL 0x08
397 #define ADAPTER_STATE_FAILED 0x10
398 #define ADAPTER_STATE_FAULTED 0x11
399
400 /*
401 * Software module types
402 */
403 #define I2O_SOFTWARE_MODULE_IRTOS 0x11
404 #define I2O_SOFTWARE_MODULE_IOP_PRIVATE 0x22
405 #define I2O_SOFTWARE_MODULE_IOP_CONFIG 0x23
406
407 /*
408 * Vendors
409 */
410 #define I2O_VENDOR_DPT 0x001b
411
412 /*
413 * DPT / Adaptec specific values for i2o_sg_io_hdr flags.
414 */
415 #define I2O_DPT_SG_FLAG_INTERPRET 0x00010000
416 #define I2O_DPT_SG_FLAG_PHYSICAL 0x00020000
417
418 #define I2O_DPT_FLASH_FRAG_SIZE 0x10000
419 #define I2O_DPT_FLASH_READ 0x0101
420 #define I2O_DPT_FLASH_WRITE 0x0102
421
422 #endif /* _I2O_DEV_H */
Browse
Usage
Versions