]> git.proxmox.com Git - mirror_ubuntu-disco-kernel.git/blame - drivers/s390/block/dasd_eckd.h
projects / mirror_ubuntu-disco-kernel.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
License cleanup: add SPDX GPL-2.0 license identifier to files with no license
[mirror_ubuntu-disco-kernel.git] / drivers / s390 / block / dasd_eckd.h
CommitLineData
b2441318 1/* SPDX-License-Identifier: GPL-2.0 */
138c014d 2/*
1da177e4 3 * Author(s)......: Holger Smolinski <Holger.Smolinski@de.ibm.com>
138c014d 4 * Horst Hummel <Horst.Hummel@de.ibm.com>
1da177e4 5 * Bugreports.to..: <Linux390@de.ibm.com>
a53c8fab 6 * Copyright IBM Corp. 1999, 2000
1da177e4 7 *
1da177e4
LT		 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
196339f1 30#define DASD_ECKD_CCW_SNID 0x34
1da177e4
LT		 31#define DASD_ECKD_CCW_RSSD 0x3e
32#define DASD_ECKD_CCW_LOCATE_RECORD 0x47
45f186be 33#define DASD_ECKD_CCW_LOCATE_RECORD_EXT 0x4b
20c64468 34#define DASD_ECKD_CCW_SNSS 0x54
1da177e4
LT		 35#define DASD_ECKD_CCW_DEFINE_EXTENT 0x63
36#define DASD_ECKD_CCW_WRITE_MT 0x85
37#define DASD_ECKD_CCW_READ_MT 0x86
38#define DASD_ECKD_CCW_WRITE_KD_MT 0x8d
39#define DASD_ECKD_CCW_READ_KD_MT 0x8e
8fd57520 40#define DASD_ECKD_CCW_READ_COUNT_MT 0x92
1da177e4 41#define DASD_ECKD_CCW_RELEASE 0x94
e4dbb0f2 42#define DASD_ECKD_CCW_WRITE_FULL_TRACK 0x95
1da177e4
LT		 43#define DASD_ECKD_CCW_READ_CKD_MT 0x9e
44#define DASD_ECKD_CCW_WRITE_CKD_MT 0x9d
f3eb5384
SW		 45#define DASD_ECKD_CCW_WRITE_TRACK_DATA 0xA5
46#define DASD_ECKD_CCW_READ_TRACK_DATA 0xA6
1da177e4 47#define DASD_ECKD_CCW_RESERVE 0xB4
e4dbb0f2 48#define DASD_ECKD_CCW_READ_TRACK 0xDE
8e09f215 49#define DASD_ECKD_CCW_PFX 0xE7
f3eb5384 50#define DASD_ECKD_CCW_PFX_READ 0xEA
8e09f215 51#define DASD_ECKD_CCW_RSCK 0xF9
a4d26c6a 52#define DASD_ECKD_CCW_RCD 0xFA
1da177e4
LT		 53
54/*
40545573 55 * Perform Subsystem Function / Sub-Orders
1da177e4 56 */
5db8440c
SH		 57#define PSF_ORDER_PRSSD 0x18
58#define PSF_ORDER_CUIR_RESPONSE 0x1A
5a3b7b11 59#define PSF_SUBORDER_QHA 0x1C
5db8440c
SH		 60#define PSF_ORDER_SSC 0x1D
61
62/*
63 * CUIR response condition codes
64 */
65#define PSF_CUIR_INVALID 0x00
66#define PSF_CUIR_COMPLETED 0x01
67#define PSF_CUIR_NOT_SUPPORTED 0x02
68#define PSF_CUIR_ERROR_IN_REQ 0x03
69#define PSF_CUIR_DENIED 0x04
70#define PSF_CUIR_LAST_PATH 0x05
71#define PSF_CUIR_DEVICE_ONLINE 0x06
72#define PSF_CUIR_VARY_FAILURE 0x07
73#define PSF_CUIR_SOFTWARE_FAILURE 0x08
74#define PSF_CUIR_NOT_RECOGNIZED 0x09
75
76/*
77 * CUIR codes
78 */
79#define CUIR_QUIESCE 0x01
80#define CUIR_RESUME 0x02
81
82/*
83 * attention message definitions
84 */
85#define ATTENTION_LENGTH_CUIR 0x0e
86#define ATTENTION_FORMAT_CUIR 0x01
1da177e4 87
5a3b7b11
SH		 88#define DASD_ECKD_PG_GROUPED 0x10
89
b44b0ab3
SW		 90/*
91 * Size that is reportet for large volumes in the old 16-bit no_cyl field
92 */
93#define LV_COMPAT_CYL 0xFFFE
94
ef19298b
SW		 95
96#define FCX_MAX_DATA_FACTOR 65536
a4d26c6a 97#define DASD_ECKD_RCD_DATA_SIZE 256
ef19298b 98
a521b048
SH		 99#define DASD_ECKD_PATH_THRHLD 256
100#define DASD_ECKD_PATH_INTERVAL 300
ef19298b 101
1da177e4
LT		 102/*****************************************************************************
103 * SECTION: Type Definitions
104 ****************************************************************************/
105
106struct eckd_count {
107 __u16 cyl;
108 __u16 head;
109 __u8 record;
110 __u8 kl;
111 __u16 dl;
112} __attribute__ ((packed));
113
114struct ch_t {
115 __u16 cyl;
116 __u16 head;
117} __attribute__ ((packed));
118
119struct chs_t {
120 __u16 cyl;
121 __u16 head;
122 __u32 sector;
123} __attribute__ ((packed));
124
125struct chr_t {
126 __u16 cyl;
127 __u16 head;
128 __u8 record;
129} __attribute__ ((packed));
130
131struct geom_t {
132 __u16 cyl;
133 __u16 head;
134 __u32 sector;
135} __attribute__ ((packed));
136
137struct eckd_home {
138 __u8 skip_control[14];
139 __u16 cell_number;
140 __u8 physical_addr[3];
141 __u8 flag;
142 struct ch_t track_addr;
143 __u8 reserved;
144 __u8 key_length;
145 __u8 reserved2[2];
146} __attribute__ ((packed));
147
148struct DE_eckd_data {
149 struct {
150 unsigned char perm:2; /* Permissions on this extent */
151 unsigned char reserved:1;
152 unsigned char seek:2; /* Seek control */
153 unsigned char auth:2; /* Access authorization */
154 unsigned char pci:1; /* PCI Fetch mode */
155 } __attribute__ ((packed)) mask;
156 struct {
157 unsigned char mode:2; /* Architecture mode */
158 unsigned char ckd:1; /* CKD Conversion */
159 unsigned char operation:3; /* Operation mode */
160 unsigned char cfw:1; /* Cache fast write */
161 unsigned char dfw:1; /* DASD fast write */
162 } __attribute__ ((packed)) attributes;
163 __u16 blk_size; /* Blocksize */
164 __u16 fast_write_id;
165 __u8 ga_additional; /* Global Attributes Additional */
166 __u8 ga_extended; /* Global Attributes Extended */
167 struct ch_t beg_ext;
168 struct ch_t end_ext;
7bf76f01 169 unsigned long ep_sys_time; /* Ext Parameter - System Time Stamp */
1da177e4
LT		 170 __u8 ep_format; /* Extended Parameter format byte */
171 __u8 ep_prio; /* Extended Parameter priority I/O byte */
f3eb5384
SW		 172 __u8 ep_reserved1; /* Extended Parameter Reserved */
173 __u8 ep_rec_per_track; /* Number of records on a track */
174 __u8 ep_reserved[4]; /* Extended Parameter Reserved */
1da177e4
LT		 175} __attribute__ ((packed));
176
177struct LO_eckd_data {
178 struct {
179 unsigned char orientation:2;
180 unsigned char operation:6;
181 } __attribute__ ((packed)) operation;
182 struct {
183 unsigned char last_bytes_used:1;
184 unsigned char reserved:6;
185 unsigned char read_count_suffix:1;
186 } __attribute__ ((packed)) auxiliary;
187 __u8 unused;
188 __u8 count;
189 struct ch_t seek_addr;
190 struct chr_t search_arg;
191 __u8 sector;
192 __u16 length;
193} __attribute__ ((packed));
194
f3eb5384
SW		 195struct LRE_eckd_data {
196 struct {
197 unsigned char orientation:2;
198 unsigned char operation:6;
199 } __attribute__ ((packed)) operation;
200 struct {
201 unsigned char length_valid:1;
202 unsigned char length_scope:1;
203 unsigned char imbedded_ccw_valid:1;
204 unsigned char check_bytes:2;
205 unsigned char imbedded_count_valid:1;
206 unsigned char reserved:1;
207 unsigned char read_count_suffix:1;
208 } __attribute__ ((packed)) auxiliary;
209 __u8 imbedded_ccw;
210 __u8 count;
211 struct ch_t seek_addr;
212 struct chr_t search_arg;
213 __u8 sector;
214 __u16 length;
215 __u8 imbedded_count;
216 __u8 extended_operation;
217 __u16 extended_parameter_length;
218 __u8 extended_parameter[0];
219} __attribute__ ((packed));
220
8e09f215
SW		 221/* Prefix data for format 0x00 and 0x01 */
222struct PFX_eckd_data {
223 unsigned char format;
224 struct {
f3eb5384 225 unsigned char define_extent:1;
8e09f215
SW		 226 unsigned char time_stamp:1;
227 unsigned char verify_base:1;
228 unsigned char hyper_pav:1;
229 unsigned char reserved:4;
230 } __attribute__ ((packed)) validity;
231 __u8 base_address;
232 __u8 aux;
233 __u8 base_lss;
234 __u8 reserved[7];
f3eb5384
SW		 235 struct DE_eckd_data define_extent;
236 struct LRE_eckd_data locate_record;
8e09f215
SW		 237} __attribute__ ((packed));
238
1da177e4
LT		 239struct dasd_eckd_characteristics {
240 __u16 cu_type;
241 struct {
242 unsigned char support:2;
243 unsigned char async:1;
244 unsigned char reserved:1;
245 unsigned char cache_info:1;
246 unsigned char model:3;
247 } __attribute__ ((packed)) cu_model;
248 __u16 dev_type;
249 __u8 dev_model;
250 struct {
251 unsigned char mult_burst:1;
252 unsigned char RT_in_LR:1;
253 unsigned char reserved1:1;
254 unsigned char RD_IN_LR:1;
255 unsigned char reserved2:4;
256 unsigned char reserved3:8;
257 unsigned char defect_wr:1;
138c014d 258 unsigned char XRC_supported:1;
1da177e4
LT		 259 unsigned char reserved4:1;
260 unsigned char striping:1;
261 unsigned char reserved5:4;
262 unsigned char cfw:1;
263 unsigned char reserved6:2;
264 unsigned char cache:1;
265 unsigned char dual_copy:1;
266 unsigned char dfw:1;
267 unsigned char reset_alleg:1;
268 unsigned char sense_down:1;
269 } __attribute__ ((packed)) facilities;
270 __u8 dev_class;
271 __u8 unit_type;
272 __u16 no_cyl;
273 __u16 trk_per_cyl;
274 __u8 sec_per_trk;
275 __u8 byte_per_track[3];
276 __u16 home_bytes;
277 __u8 formula;
278 union {
279 struct {
280 __u8 f1;
281 __u16 f2;
282 __u16 f3;
283 } __attribute__ ((packed)) f_0x01;
284 struct {
285 __u8 f1;
286 __u8 f2;
287 __u8 f3;
288 __u8 f4;
289 __u8 f5;
290 } __attribute__ ((packed)) f_0x02;
291 } __attribute__ ((packed)) factors;
292 __u16 first_alt_trk;
293 __u16 no_alt_trk;
294 __u16 first_dia_trk;
295 __u16 no_dia_trk;
296 __u16 first_sup_trk;
297 __u16 no_sup_trk;
298 __u8 MDR_ID;
299 __u8 OBR_ID;
300 __u8 director;
301 __u8 rd_trk_set;
302 __u16 max_rec_zero;
303 __u8 reserved1;
304 __u8 RWANY_in_LR;
305 __u8 factor6;
306 __u8 factor7;
307 __u8 factor8;
308 __u8 reserved2[3];
b44b0ab3
SW		 309 __u8 reserved3[6];
310 __u32 long_no_cyl;
1da177e4
LT		 311} __attribute__ ((packed));
312
4abb08c2
SW		 313/* elements of the configuration data */
314struct dasd_ned {
1da177e4 315 struct {
4abb08c2
SW		 316 __u8 identifier:2;
317 __u8 token_id:1;
318 __u8 sno_valid:1;
319 __u8 subst_sno:1;
320 __u8 recNED:1;
321 __u8 emuNED:1;
322 __u8 reserved:1;
323 } __attribute__ ((packed)) flags;
324 __u8 descriptor;
325 __u8 dev_class;
326 __u8 reserved;
327 __u8 dev_type[6];
328 __u8 dev_model[3];
329 __u8 HDA_manufacturer[3];
330 __u8 HDA_location[2];
331 __u8 HDA_seqno[12];
332 __u8 ID;
333 __u8 unit_addr;
334} __attribute__ ((packed));
335
336struct dasd_sneq {
1da177e4 337 struct {
4abb08c2
SW		 338 __u8 identifier:2;
339 __u8 reserved:6;
340 } __attribute__ ((packed)) flags;
341 __u8 res1;
342 __u16 format;
343 __u8 res2[4]; /* byte 4- 7 */
344 __u8 sua_flags; /* byte 8 */
345 __u8 base_unit_addr; /* byte 9 */
346 __u8 res3[22]; /* byte 10-31 */
347} __attribute__ ((packed));
348
349struct vd_sneq {
1da177e4 350 struct {
4abb08c2
SW		 351 __u8 identifier:2;
352 __u8 reserved:6;
353 } __attribute__ ((packed)) flags;
354 __u8 res1;
355 __u16 format;
356 __u8 res2[4]; /* byte 4- 7 */
357 __u8 uit[16]; /* byte 8-23 */
358 __u8 res3[8]; /* byte 24-31 */
359} __attribute__ ((packed));
360
361struct dasd_gneq {
1da177e4 362 struct {
4abb08c2
SW		 363 __u8 identifier:2;
364 __u8 reserved:6;
365 } __attribute__ ((packed)) flags;
b179b037
SH		 366 __u8 record_selector;
367 __u8 reserved[4];
7c8faa86
SH		 368 struct {
369 __u8 value:2;
370 __u8 number:6;
371 } __attribute__ ((packed)) timeout;
372 __u8 reserved3;
4abb08c2
SW		 373 __u16 subsystemID;
374 __u8 reserved2[22];
1da177e4
LT		 375} __attribute__ ((packed));
376
8e09f215
SW		 377struct dasd_rssd_features {
378 char feature[256];
379} __attribute__((packed));
380
5db8440c
SH		 381struct dasd_rssd_messages {
382 __u16 length;
383 __u8 format;
384 __u8 code;
385 __u32 message_id;
386 __u8 flags;
387 char messages[4087];
388} __packed;
389
390struct dasd_cuir_message {
391 __u16 length;
392 __u8 format;
393 __u8 code;
394 __u32 message_id;
395 __u8 flags;
396 __u8 neq_map[3];
397 __u8 ned_map;
398 __u8 record_selector;
399} __packed;
400
401struct dasd_psf_cuir_response {
402 __u8 order;
403 __u8 flags;
404 __u8 cc;
405 __u8 chpid;
406 __u16 device_nr;
407 __u16 reserved;
408 __u32 message_id;
409 __u64 system_id;
410 __u8 cssid;
411 __u8 ssid;
412} __packed;
8e09f215 413
5a3b7b11
SH		 414struct dasd_ckd_path_group_entry {
415 __u8 status_flags;
416 __u8 pgid[11];
417 __u8 sysplex_name[8];
418 __u32 timestamp;
419 __u32 cylinder;
420 __u8 reserved[4];
421} __packed;
422
423struct dasd_ckd_host_information {
424 __u8 access_flags;
425 __u8 entry_size;
426 __u16 entry_count;
427 __u8 entry[16390];
428} __packed;
429
430struct dasd_psf_query_host_access {
431 __u8 access_flag;
432 __u8 version;
433 __u16 CKD_length;
434 __u16 SCSI_length;
435 __u8 unused[10];
436 __u8 host_access_information[16394];
437} __packed;
438
1da177e4 439/*
138c014d 440 * Perform Subsystem Function - Prepare for Read Subsystem Data
1da177e4
LT		 441 */
442struct dasd_psf_prssd_data {
443 unsigned char order;
444 unsigned char flags;
5a3b7b11
SH		 445 unsigned char reserved1;
446 unsigned char reserved2;
447 unsigned char lss;
448 unsigned char volume;
1da177e4 449 unsigned char suborder;
49fd38bd 450 unsigned char varies[5];
1da177e4
LT		 451} __attribute__ ((packed));
452
40545573
HH		 453/*
454 * Perform Subsystem Function - Set Subsystem Characteristics
455 */
456struct dasd_psf_ssc_data {
457 unsigned char order;
458 unsigned char flags;
459 unsigned char cu_type[4];
460 unsigned char suborder;
461 unsigned char reserved[59];
462} __attribute__((packed));
463
8e09f215
SW		 464
465/*
466 * some structures and definitions for alias handling
467 */
468struct dasd_unit_address_configuration {
469 struct {
470 char ua_type;
471 char base_ua;
472 } unit[256];
473} __attribute__((packed));
474
475
476#define MAX_DEVICES_PER_LCU 256
477
478/* flags on the LCU */
479#define NEED_UAC_UPDATE 0x01
480#define UPDATE_PENDING 0x02
481
482enum pavtype {NO_PAV, BASE_PAV, HYPER_PAV};
483
484
485struct alias_root {
486 struct list_head serverlist;
487 spinlock_t lock;
488};
489
490struct alias_server {
491 struct list_head server;
492 struct dasd_uid uid;
493 struct list_head lculist;
494};
495
496struct summary_unit_check_work_data {
497 char reason;
498 struct dasd_device *device;
499 struct work_struct worker;
500};
501
502struct read_uac_work_data {
503 struct dasd_device *device;
504 struct delayed_work dwork;
505};
506
507struct alias_lcu {
508 struct list_head lcu;
509 struct dasd_uid uid;
510 enum pavtype pav;
511 char flags;
512 spinlock_t lock;
513 struct list_head grouplist;
514 struct list_head active_devices;
515 struct list_head inactive_devices;
516 struct dasd_unit_address_configuration *uac;
517 struct summary_unit_check_work_data suc_data;
518 struct read_uac_work_data ruac_data;
519 struct dasd_ccw_req *rsu_cqr;
f4ac1d02 520 struct completion lcu_setup;
8e09f215
SW		 521};
522
523struct alias_pav_group {
524 struct list_head group;
525 struct dasd_uid uid;
526 struct alias_lcu *lcu;
527 struct list_head baselist;
528 struct list_head aliaslist;
529 struct dasd_device *next;
530};
531
b179b037
SH		 532struct dasd_conf_data {
533 struct dasd_ned neds[5];
534 u8 reserved[64];
535 struct dasd_gneq gneq;
536} __packed;
537
8e09f215
SW		 538struct dasd_eckd_private {
539 struct dasd_eckd_characteristics rdc_data;
4abb08c2
SW		 540 u8 *conf_data;
541 int conf_len;
c9346151 542
4abb08c2
SW		 543 /* pointers to specific parts in the conf_data */
544 struct dasd_ned *ned;
545 struct dasd_sneq *sneq;
546 struct vd_sneq *vdsneq;
547 struct dasd_gneq *gneq;
548
8e09f215
SW		 549 struct eckd_count count_area[5];
550 int init_cqr_status;
551 int uses_cdl;
552 struct attrib_data_t attrib; /* e.g. cache operations */
553 struct dasd_rssd_features features;
b44b0ab3 554 u32 real_cyl;
8e09f215
SW		 555
556 /* alias managemnet */
557 struct dasd_uid uid;
558 struct alias_pav_group *pavgroup;
559 struct alias_lcu *lcu;
560 int count;
ef19298b
SW		 561
562 u32 fcx_max_data;
59a9ed5f 563 char suc_reason;
8e09f215
SW		 564};
565
566
567
568int dasd_alias_make_device_known_to_lcu(struct dasd_device *);
569void dasd_alias_disconnect_device_from_lcu(struct dasd_device *);
570int dasd_alias_add_device(struct dasd_device *);
571int dasd_alias_remove_device(struct dasd_device *);
572struct dasd_device *dasd_alias_get_start_dev(struct dasd_device *);
59a9ed5f 573void dasd_alias_handle_summary_unit_check(struct work_struct *);
8e09f215 574void dasd_eckd_reset_ccw_to_base_io(struct dasd_ccw_req *);
f4ac1d02
SW		 575void dasd_alias_lcu_setup_complete(struct dasd_device *);
576void dasd_alias_wait_for_lcu_setup(struct dasd_device *);
501183f2 577int dasd_alias_update_add_device(struct dasd_device *);
1da177e4 578#endif /* DASD_ECKD_H */
Ubuntu Disco kernel mirror for Proxmox VE and PMG