xref: /linux/drivers/s390/block/dasd_eckd.h (revision cdb138080b78146d1cdadba9f5dadbeb97445b91)
1 /*
2  * File...........: linux/drivers/s390/block/dasd_eckd.h
3  * Author(s)......: Holger Smolinski <Holger.Smolinski@de.ibm.com>
4  *		    Horst Hummel <Horst.Hummel@de.ibm.com>
5  * Bugreports.to..: <Linux390@de.ibm.com>
6  * (C) IBM Corporation, IBM Deutschland Entwicklung GmbH, 1999,2000
7  *
8  */
9 
10 #ifndef DASD_ECKD_H
11 #define DASD_ECKD_H
12 
13 /*****************************************************************************
14  * SECTION: CCW Definitions
15  ****************************************************************************/
16 #define DASD_ECKD_CCW_WRITE		 0x05
17 #define DASD_ECKD_CCW_READ		 0x06
18 #define DASD_ECKD_CCW_WRITE_HOME_ADDRESS 0x09
19 #define DASD_ECKD_CCW_READ_HOME_ADDRESS	 0x0a
20 #define DASD_ECKD_CCW_WRITE_KD		 0x0d
21 #define DASD_ECKD_CCW_READ_KD		 0x0e
22 #define DASD_ECKD_CCW_ERASE		 0x11
23 #define DASD_ECKD_CCW_READ_COUNT	 0x12
24 #define DASD_ECKD_CCW_SLCK		 0x14
25 #define DASD_ECKD_CCW_WRITE_RECORD_ZERO	 0x15
26 #define DASD_ECKD_CCW_READ_RECORD_ZERO	 0x16
27 #define DASD_ECKD_CCW_WRITE_CKD		 0x1d
28 #define DASD_ECKD_CCW_READ_CKD		 0x1e
29 #define DASD_ECKD_CCW_PSF		 0x27
30 #define DASD_ECKD_CCW_RSSD		 0x3e
31 #define DASD_ECKD_CCW_LOCATE_RECORD	 0x47
32 #define DASD_ECKD_CCW_SNSS		 0x54
33 #define DASD_ECKD_CCW_DEFINE_EXTENT	 0x63
34 #define DASD_ECKD_CCW_WRITE_MT		 0x85
35 #define DASD_ECKD_CCW_READ_MT		 0x86
36 #define DASD_ECKD_CCW_WRITE_KD_MT	 0x8d
37 #define DASD_ECKD_CCW_READ_KD_MT	 0x8e
38 #define DASD_ECKD_CCW_RELEASE		 0x94
39 #define DASD_ECKD_CCW_READ_CKD_MT	 0x9e
40 #define DASD_ECKD_CCW_WRITE_CKD_MT	 0x9d
41 #define DASD_ECKD_CCW_WRITE_TRACK_DATA	 0xA5
42 #define DASD_ECKD_CCW_READ_TRACK_DATA	 0xA6
43 #define DASD_ECKD_CCW_RESERVE		 0xB4
44 #define DASD_ECKD_CCW_PFX		 0xE7
45 #define DASD_ECKD_CCW_PFX_READ		 0xEA
46 #define DASD_ECKD_CCW_RSCK		 0xF9
47 
48 /*
49  * Perform Subsystem Function / Sub-Orders
50  */
51 #define PSF_ORDER_PRSSD 0x18
52 #define PSF_ORDER_SSC	0x1D
53 
54 /*
55  * Size that is reportet for large volumes in the old 16-bit no_cyl field
56  */
57 #define LV_COMPAT_CYL 0xFFFE
58 
59 /*****************************************************************************
60  * SECTION: Type Definitions
61  ****************************************************************************/
62 
63 struct eckd_count {
64 	__u16 cyl;
65 	__u16 head;
66 	__u8 record;
67 	__u8 kl;
68 	__u16 dl;
69 } __attribute__ ((packed));
70 
71 struct ch_t {
72 	__u16 cyl;
73 	__u16 head;
74 } __attribute__ ((packed));
75 
76 struct chs_t {
77 	__u16 cyl;
78 	__u16 head;
79 	__u32 sector;
80 } __attribute__ ((packed));
81 
82 struct chr_t {
83 	__u16 cyl;
84 	__u16 head;
85 	__u8 record;
86 } __attribute__ ((packed));
87 
88 struct geom_t {
89 	__u16 cyl;
90 	__u16 head;
91 	__u32 sector;
92 } __attribute__ ((packed));
93 
94 struct eckd_home {
95 	__u8 skip_control[14];
96 	__u16 cell_number;
97 	__u8 physical_addr[3];
98 	__u8 flag;
99 	struct ch_t track_addr;
100 	__u8 reserved;
101 	__u8 key_length;
102 	__u8 reserved2[2];
103 } __attribute__ ((packed));
104 
105 struct DE_eckd_data {
106 	struct {
107 		unsigned char perm:2;	/* Permissions on this extent */
108 		unsigned char reserved:1;
109 		unsigned char seek:2;	/* Seek control */
110 		unsigned char auth:2;	/* Access authorization */
111 		unsigned char pci:1;	/* PCI Fetch mode */
112 	} __attribute__ ((packed)) mask;
113 	struct {
114 		unsigned char mode:2;	/* Architecture mode */
115 		unsigned char ckd:1;	/* CKD Conversion */
116 		unsigned char operation:3;	/* Operation mode */
117 		unsigned char cfw:1;	/* Cache fast write */
118 		unsigned char dfw:1;	/* DASD fast write */
119 	} __attribute__ ((packed)) attributes;
120 	__u16 blk_size;		/* Blocksize */
121 	__u16 fast_write_id;
122 	__u8 ga_additional;	/* Global Attributes Additional */
123 	__u8 ga_extended;	/* Global Attributes Extended	*/
124 	struct ch_t beg_ext;
125 	struct ch_t end_ext;
126 	unsigned long long ep_sys_time; /* Ext Parameter - System Time Stamp */
127 	__u8 ep_format;        /* Extended Parameter format byte       */
128 	__u8 ep_prio;          /* Extended Parameter priority I/O byte */
129 	__u8 ep_reserved1;     /* Extended Parameter Reserved	       */
130 	__u8 ep_rec_per_track; /* Number of records on a track	       */
131 	__u8 ep_reserved[4];   /* Extended Parameter Reserved	       */
132 } __attribute__ ((packed));
133 
134 struct LO_eckd_data {
135 	struct {
136 		unsigned char orientation:2;
137 		unsigned char operation:6;
138 	} __attribute__ ((packed)) operation;
139 	struct {
140 		unsigned char last_bytes_used:1;
141 		unsigned char reserved:6;
142 		unsigned char read_count_suffix:1;
143 	} __attribute__ ((packed)) auxiliary;
144 	__u8 unused;
145 	__u8 count;
146 	struct ch_t seek_addr;
147 	struct chr_t search_arg;
148 	__u8 sector;
149 	__u16 length;
150 } __attribute__ ((packed));
151 
152 struct LRE_eckd_data {
153 	struct {
154 		unsigned char orientation:2;
155 		unsigned char operation:6;
156 	} __attribute__ ((packed)) operation;
157 	struct {
158 		unsigned char length_valid:1;
159 		unsigned char length_scope:1;
160 		unsigned char imbedded_ccw_valid:1;
161 		unsigned char check_bytes:2;
162 		unsigned char imbedded_count_valid:1;
163 		unsigned char reserved:1;
164 		unsigned char read_count_suffix:1;
165 	} __attribute__ ((packed)) auxiliary;
166 	__u8 imbedded_ccw;
167 	__u8 count;
168 	struct ch_t seek_addr;
169 	struct chr_t search_arg;
170 	__u8 sector;
171 	__u16 length;
172 	__u8 imbedded_count;
173 	__u8 extended_operation;
174 	__u16 extended_parameter_length;
175 	__u8 extended_parameter[0];
176 } __attribute__ ((packed));
177 
178 /* Prefix data for format 0x00 and 0x01 */
179 struct PFX_eckd_data {
180 	unsigned char format;
181 	struct {
182 		unsigned char define_extent:1;
183 		unsigned char time_stamp:1;
184 		unsigned char verify_base:1;
185 		unsigned char hyper_pav:1;
186 		unsigned char reserved:4;
187 	} __attribute__ ((packed)) validity;
188 	__u8 base_address;
189 	__u8 aux;
190 	__u8 base_lss;
191 	__u8 reserved[7];
192 	struct DE_eckd_data define_extent;
193 	struct LRE_eckd_data locate_record;
194 } __attribute__ ((packed));
195 
196 struct dasd_eckd_characteristics {
197 	__u16 cu_type;
198 	struct {
199 		unsigned char support:2;
200 		unsigned char async:1;
201 		unsigned char reserved:1;
202 		unsigned char cache_info:1;
203 		unsigned char model:3;
204 	} __attribute__ ((packed)) cu_model;
205 	__u16 dev_type;
206 	__u8 dev_model;
207 	struct {
208 		unsigned char mult_burst:1;
209 		unsigned char RT_in_LR:1;
210 		unsigned char reserved1:1;
211 		unsigned char RD_IN_LR:1;
212 		unsigned char reserved2:4;
213 		unsigned char reserved3:8;
214 		unsigned char defect_wr:1;
215 		unsigned char XRC_supported:1;
216 		unsigned char reserved4:1;
217 		unsigned char striping:1;
218 		unsigned char reserved5:4;
219 		unsigned char cfw:1;
220 		unsigned char reserved6:2;
221 		unsigned char cache:1;
222 		unsigned char dual_copy:1;
223 		unsigned char dfw:1;
224 		unsigned char reset_alleg:1;
225 		unsigned char sense_down:1;
226 	} __attribute__ ((packed)) facilities;
227 	__u8 dev_class;
228 	__u8 unit_type;
229 	__u16 no_cyl;
230 	__u16 trk_per_cyl;
231 	__u8 sec_per_trk;
232 	__u8 byte_per_track[3];
233 	__u16 home_bytes;
234 	__u8 formula;
235 	union {
236 		struct {
237 			__u8 f1;
238 			__u16 f2;
239 			__u16 f3;
240 		} __attribute__ ((packed)) f_0x01;
241 		struct {
242 			__u8 f1;
243 			__u8 f2;
244 			__u8 f3;
245 			__u8 f4;
246 			__u8 f5;
247 		} __attribute__ ((packed)) f_0x02;
248 	} __attribute__ ((packed)) factors;
249 	__u16 first_alt_trk;
250 	__u16 no_alt_trk;
251 	__u16 first_dia_trk;
252 	__u16 no_dia_trk;
253 	__u16 first_sup_trk;
254 	__u16 no_sup_trk;
255 	__u8 MDR_ID;
256 	__u8 OBR_ID;
257 	__u8 director;
258 	__u8 rd_trk_set;
259 	__u16 max_rec_zero;
260 	__u8 reserved1;
261 	__u8 RWANY_in_LR;
262 	__u8 factor6;
263 	__u8 factor7;
264 	__u8 factor8;
265 	__u8 reserved2[3];
266 	__u8 reserved3[6];
267 	__u32 long_no_cyl;
268 } __attribute__ ((packed));
269 
270 /* elements of the configuration data */
271 struct dasd_ned {
272 	struct {
273 		__u8 identifier:2;
274 		__u8 token_id:1;
275 		__u8 sno_valid:1;
276 		__u8 subst_sno:1;
277 		__u8 recNED:1;
278 		__u8 emuNED:1;
279 		__u8 reserved:1;
280 	} __attribute__ ((packed)) flags;
281 	__u8 descriptor;
282 	__u8 dev_class;
283 	__u8 reserved;
284 	__u8 dev_type[6];
285 	__u8 dev_model[3];
286 	__u8 HDA_manufacturer[3];
287 	__u8 HDA_location[2];
288 	__u8 HDA_seqno[12];
289 	__u8 ID;
290 	__u8 unit_addr;
291 } __attribute__ ((packed));
292 
293 struct dasd_sneq {
294 	struct {
295 		__u8 identifier:2;
296 		__u8 reserved:6;
297 	} __attribute__ ((packed)) flags;
298 	__u8 res1;
299 	__u16 format;
300 	__u8 res2[4];		/* byte  4- 7 */
301 	__u8 sua_flags;		/* byte  8    */
302 	__u8 base_unit_addr;	/* byte  9    */
303 	__u8 res3[22];		/* byte 10-31 */
304 } __attribute__ ((packed));
305 
306 struct vd_sneq {
307 	struct {
308 		__u8 identifier:2;
309 		__u8 reserved:6;
310 	} __attribute__ ((packed)) flags;
311 	__u8 res1;
312 	__u16 format;
313 	__u8 res2[4];	/* byte  4- 7 */
314 	__u8 uit[16];	/* byte  8-23 */
315 	__u8 res3[8];	/* byte 24-31 */
316 } __attribute__ ((packed));
317 
318 struct dasd_gneq {
319 	struct {
320 		__u8 identifier:2;
321 		__u8 reserved:6;
322 	} __attribute__ ((packed)) flags;
323 	__u8 reserved[5];
324 	struct {
325 		__u8 value:2;
326 		__u8 number:6;
327 	} __attribute__ ((packed)) timeout;
328 	__u8 reserved3;
329 	__u16 subsystemID;
330 	__u8 reserved2[22];
331 } __attribute__ ((packed));
332 
333 struct dasd_eckd_path {
334 	__u8 opm;
335 	__u8 ppm;
336 	__u8 npm;
337 };
338 
339 struct dasd_rssd_features {
340 	char feature[256];
341 } __attribute__((packed));
342 
343 
344 /*
345  * Perform Subsystem Function - Prepare for Read Subsystem Data
346  */
347 struct dasd_psf_prssd_data {
348 	unsigned char order;
349 	unsigned char flags;
350 	unsigned char reserved[4];
351 	unsigned char suborder;
352 	unsigned char varies[5];
353 } __attribute__ ((packed));
354 
355 /*
356  * Perform Subsystem Function - Set Subsystem Characteristics
357  */
358 struct dasd_psf_ssc_data {
359 	unsigned char order;
360 	unsigned char flags;
361 	unsigned char cu_type[4];
362 	unsigned char suborder;
363 	unsigned char reserved[59];
364 } __attribute__((packed));
365 
366 
367 /*
368  * some structures and definitions for alias handling
369  */
370 struct dasd_unit_address_configuration {
371 	struct {
372 		char ua_type;
373 		char base_ua;
374 	} unit[256];
375 } __attribute__((packed));
376 
377 
378 #define MAX_DEVICES_PER_LCU 256
379 
380 /* flags on the LCU  */
381 #define NEED_UAC_UPDATE  0x01
382 #define UPDATE_PENDING	0x02
383 
384 enum pavtype {NO_PAV, BASE_PAV, HYPER_PAV};
385 
386 
387 struct alias_root {
388 	struct list_head serverlist;
389 	spinlock_t lock;
390 };
391 
392 struct alias_server {
393 	struct list_head server;
394 	struct dasd_uid uid;
395 	struct list_head lculist;
396 };
397 
398 struct summary_unit_check_work_data {
399 	char reason;
400 	struct dasd_device *device;
401 	struct work_struct worker;
402 };
403 
404 struct read_uac_work_data {
405 	struct dasd_device *device;
406 	struct delayed_work dwork;
407 };
408 
409 struct alias_lcu {
410 	struct list_head lcu;
411 	struct dasd_uid uid;
412 	enum pavtype pav;
413 	char flags;
414 	spinlock_t lock;
415 	struct list_head grouplist;
416 	struct list_head active_devices;
417 	struct list_head inactive_devices;
418 	struct dasd_unit_address_configuration *uac;
419 	struct summary_unit_check_work_data suc_data;
420 	struct read_uac_work_data ruac_data;
421 	struct dasd_ccw_req *rsu_cqr;
422 	struct completion lcu_setup;
423 };
424 
425 struct alias_pav_group {
426 	struct list_head group;
427 	struct dasd_uid uid;
428 	struct alias_lcu *lcu;
429 	struct list_head baselist;
430 	struct list_head aliaslist;
431 	struct dasd_device *next;
432 };
433 
434 struct dasd_eckd_private {
435 	struct dasd_eckd_characteristics rdc_data;
436 	u8 *conf_data;
437 	int conf_len;
438 	/* pointers to specific parts in the conf_data */
439 	struct dasd_ned *ned;
440 	struct dasd_sneq *sneq;
441 	struct vd_sneq *vdsneq;
442 	struct dasd_gneq *gneq;
443 
444 	struct dasd_eckd_path path_data;
445 	struct eckd_count count_area[5];
446 	int init_cqr_status;
447 	int uses_cdl;
448 	struct attrib_data_t attrib;	/* e.g. cache operations */
449 	struct dasd_rssd_features features;
450 	u32 real_cyl;
451 
452 	/* alias managemnet */
453 	struct dasd_uid uid;
454 	struct alias_pav_group *pavgroup;
455 	struct alias_lcu *lcu;
456 	int count;
457 };
458 
459 
460 
461 int dasd_alias_make_device_known_to_lcu(struct dasd_device *);
462 void dasd_alias_disconnect_device_from_lcu(struct dasd_device *);
463 int dasd_alias_add_device(struct dasd_device *);
464 int dasd_alias_remove_device(struct dasd_device *);
465 struct dasd_device *dasd_alias_get_start_dev(struct dasd_device *);
466 void dasd_alias_handle_summary_unit_check(struct dasd_device *, struct irb *);
467 void dasd_eckd_reset_ccw_to_base_io(struct dasd_ccw_req *);
468 void dasd_alias_lcu_setup_complete(struct dasd_device *);
469 void dasd_alias_wait_for_lcu_setup(struct dasd_device *);
470 int dasd_alias_update_add_device(struct dasd_device *);
471 #endif				/* DASD_ECKD_H */
472