dasd_eckd.h (16748B)
1/* SPDX-License-Identifier: GPL-2.0 */ 2/* 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 * Copyright IBM Corp. 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_SNID 0x34 31#define DASD_ECKD_CCW_RSSD 0x3e 32#define DASD_ECKD_CCW_LOCATE_RECORD 0x47 33#define DASD_ECKD_CCW_LOCATE_RECORD_EXT 0x4b 34#define DASD_ECKD_CCW_SNSS 0x54 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 40#define DASD_ECKD_CCW_READ_COUNT_MT 0x92 41#define DASD_ECKD_CCW_RELEASE 0x94 42#define DASD_ECKD_CCW_WRITE_FULL_TRACK 0x95 43#define DASD_ECKD_CCW_READ_CKD_MT 0x9e 44#define DASD_ECKD_CCW_WRITE_CKD_MT 0x9d 45#define DASD_ECKD_CCW_WRITE_TRACK_DATA 0xA5 46#define DASD_ECKD_CCW_READ_TRACK_DATA 0xA6 47#define DASD_ECKD_CCW_RESERVE 0xB4 48#define DASD_ECKD_CCW_READ_TRACK 0xDE 49#define DASD_ECKD_CCW_PFX 0xE7 50#define DASD_ECKD_CCW_PFX_READ 0xEA 51#define DASD_ECKD_CCW_RSCK 0xF9 52#define DASD_ECKD_CCW_RCD 0xFA 53#define DASD_ECKD_CCW_DSO 0xF7 54 55/* Define Subsystem Function / Orders */ 56#define DSO_ORDER_RAS 0x81 57 58/* 59 * Perform Subsystem Function / Orders 60 */ 61#define PSF_ORDER_PRSSD 0x18 62#define PSF_ORDER_CUIR_RESPONSE 0x1A 63#define PSF_ORDER_SSC 0x1D 64 65/* 66 * Perform Subsystem Function / Sub-Orders 67 */ 68#define PSF_SUBORDER_QHA 0x1C /* Query Host Access */ 69#define PSF_SUBORDER_VSQ 0x52 /* Volume Storage Query */ 70#define PSF_SUBORDER_LCQ 0x53 /* Logical Configuration Query */ 71 72/* 73 * CUIR response condition codes 74 */ 75#define PSF_CUIR_INVALID 0x00 76#define PSF_CUIR_COMPLETED 0x01 77#define PSF_CUIR_NOT_SUPPORTED 0x02 78#define PSF_CUIR_ERROR_IN_REQ 0x03 79#define PSF_CUIR_DENIED 0x04 80#define PSF_CUIR_LAST_PATH 0x05 81#define PSF_CUIR_DEVICE_ONLINE 0x06 82#define PSF_CUIR_VARY_FAILURE 0x07 83#define PSF_CUIR_SOFTWARE_FAILURE 0x08 84#define PSF_CUIR_NOT_RECOGNIZED 0x09 85 86/* 87 * CUIR codes 88 */ 89#define CUIR_QUIESCE 0x01 90#define CUIR_RESUME 0x02 91 92/* 93 * Out-of-space (OOS) Codes 94 */ 95#define REPO_WARN 0x01 96#define REPO_EXHAUST 0x02 97#define POOL_WARN 0x03 98#define POOL_EXHAUST 0x04 99#define REPO_RELIEVE 0x05 100#define POOL_RELIEVE 0x06 101 102/* 103 * attention message definitions 104 */ 105#define ATTENTION_LENGTH_CUIR 0x0e 106#define ATTENTION_FORMAT_CUIR 0x01 107#define ATTENTION_LENGTH_OOS 0x10 108#define ATTENTION_FORMAT_OOS 0x06 109 110#define DASD_ECKD_PG_GROUPED 0x10 111 112/* 113 * Size that is reported for large volumes in the old 16-bit no_cyl field 114 */ 115#define LV_COMPAT_CYL 0xFFFE 116 117 118#define FCX_MAX_DATA_FACTOR 65536 119#define DASD_ECKD_RCD_DATA_SIZE 256 120 121#define DASD_ECKD_PATH_THRHLD 256 122#define DASD_ECKD_PATH_INTERVAL 300 123 124/* 125 * Maximum number of blocks to be chained 126 */ 127#define DASD_ECKD_MAX_BLOCKS 190 128#define DASD_ECKD_MAX_BLOCKS_RAW 256 129 130/***************************************************************************** 131 * SECTION: Type Definitions 132 ****************************************************************************/ 133 134struct eckd_count { 135 __u16 cyl; 136 __u16 head; 137 __u8 record; 138 __u8 kl; 139 __u16 dl; 140} __attribute__ ((packed)); 141 142struct ch_t { 143 __u16 cyl; 144 __u16 head; 145} __attribute__ ((packed)); 146 147struct chr_t { 148 __u16 cyl; 149 __u16 head; 150 __u8 record; 151} __attribute__ ((packed)); 152 153struct DE_eckd_data { 154 struct { 155 unsigned char perm:2; /* Permissions on this extent */ 156 unsigned char reserved:1; 157 unsigned char seek:2; /* Seek control */ 158 unsigned char auth:2; /* Access authorization */ 159 unsigned char pci:1; /* PCI Fetch mode */ 160 } __attribute__ ((packed)) mask; 161 struct { 162 unsigned char mode:2; /* Architecture mode */ 163 unsigned char ckd:1; /* CKD Conversion */ 164 unsigned char operation:3; /* Operation mode */ 165 unsigned char cfw:1; /* Cache fast write */ 166 unsigned char dfw:1; /* DASD fast write */ 167 } __attribute__ ((packed)) attributes; 168 __u16 blk_size; /* Blocksize */ 169 __u16 fast_write_id; 170 __u8 ga_additional; /* Global Attributes Additional */ 171 __u8 ga_extended; /* Global Attributes Extended */ 172 struct ch_t beg_ext; 173 struct ch_t end_ext; 174 unsigned long ep_sys_time; /* Ext Parameter - System Time Stamp */ 175 __u8 ep_format; /* Extended Parameter format byte */ 176 __u8 ep_prio; /* Extended Parameter priority I/O byte */ 177 __u8 ep_reserved1; /* Extended Parameter Reserved */ 178 __u8 ep_rec_per_track; /* Number of records on a track */ 179 __u8 ep_reserved[4]; /* Extended Parameter Reserved */ 180} __attribute__ ((packed)); 181 182struct LO_eckd_data { 183 struct { 184 unsigned char orientation:2; 185 unsigned char operation:6; 186 } __attribute__ ((packed)) operation; 187 struct { 188 unsigned char last_bytes_used:1; 189 unsigned char reserved:6; 190 unsigned char read_count_suffix:1; 191 } __attribute__ ((packed)) auxiliary; 192 __u8 unused; 193 __u8 count; 194 struct ch_t seek_addr; 195 struct chr_t search_arg; 196 __u8 sector; 197 __u16 length; 198} __attribute__ ((packed)); 199 200struct LRE_eckd_data { 201 struct { 202 unsigned char orientation:2; 203 unsigned char operation:6; 204 } __attribute__ ((packed)) operation; 205 struct { 206 unsigned char length_valid:1; 207 unsigned char length_scope:1; 208 unsigned char imbedded_ccw_valid:1; 209 unsigned char check_bytes:2; 210 unsigned char imbedded_count_valid:1; 211 unsigned char reserved:1; 212 unsigned char read_count_suffix:1; 213 } __attribute__ ((packed)) auxiliary; 214 __u8 imbedded_ccw; 215 __u8 count; 216 struct ch_t seek_addr; 217 struct chr_t search_arg; 218 __u8 sector; 219 __u16 length; 220 __u8 imbedded_count; 221 __u8 extended_operation; 222 __u16 extended_parameter_length; 223 __u8 extended_parameter[]; 224} __attribute__ ((packed)); 225 226/* Prefix data for format 0x00 and 0x01 */ 227struct PFX_eckd_data { 228 unsigned char format; 229 struct { 230 unsigned char define_extent:1; 231 unsigned char time_stamp:1; 232 unsigned char verify_base:1; 233 unsigned char hyper_pav:1; 234 unsigned char reserved:4; 235 } __attribute__ ((packed)) validity; 236 __u8 base_address; 237 __u8 aux; 238 __u8 base_lss; 239 __u8 reserved[7]; 240 struct DE_eckd_data define_extent; 241 struct LRE_eckd_data locate_record; 242} __attribute__ ((packed)); 243 244struct dasd_eckd_characteristics { 245 __u16 cu_type; 246 struct { 247 unsigned char support:2; 248 unsigned char async:1; 249 unsigned char reserved:1; 250 unsigned char cache_info:1; 251 unsigned char model:3; 252 } __attribute__ ((packed)) cu_model; 253 __u16 dev_type; 254 __u8 dev_model; 255 struct { 256 unsigned char mult_burst:1; 257 unsigned char RT_in_LR:1; 258 unsigned char reserved1:1; 259 unsigned char RD_IN_LR:1; 260 unsigned char reserved2:4; 261 unsigned char reserved3:8; 262 unsigned char defect_wr:1; 263 unsigned char XRC_supported:1; 264 unsigned char reserved4:1; 265 unsigned char striping:1; 266 unsigned char reserved5:4; 267 unsigned char cfw:1; 268 unsigned char reserved6:2; 269 unsigned char cache:1; 270 unsigned char dual_copy:1; 271 unsigned char dfw:1; 272 unsigned char reset_alleg:1; 273 unsigned char sense_down:1; 274 } __attribute__ ((packed)) facilities; 275 __u8 dev_class; 276 __u8 unit_type; 277 __u16 no_cyl; 278 __u16 trk_per_cyl; 279 __u8 sec_per_trk; 280 __u8 byte_per_track[3]; 281 __u16 home_bytes; 282 __u8 formula; 283 union { 284 struct { 285 __u8 f1; 286 __u16 f2; 287 __u16 f3; 288 } __attribute__ ((packed)) f_0x01; 289 struct { 290 __u8 f1; 291 __u8 f2; 292 __u8 f3; 293 __u8 f4; 294 __u8 f5; 295 } __attribute__ ((packed)) f_0x02; 296 } __attribute__ ((packed)) factors; 297 __u16 first_alt_trk; 298 __u16 no_alt_trk; 299 __u16 first_dia_trk; 300 __u16 no_dia_trk; 301 __u16 first_sup_trk; 302 __u16 no_sup_trk; 303 __u8 MDR_ID; 304 __u8 OBR_ID; 305 __u8 director; 306 __u8 rd_trk_set; 307 __u16 max_rec_zero; 308 __u8 reserved1; 309 __u8 RWANY_in_LR; 310 __u8 factor6; 311 __u8 factor7; 312 __u8 factor8; 313 __u8 reserved2[3]; 314 __u8 reserved3[6]; 315 __u32 long_no_cyl; 316} __attribute__ ((packed)); 317 318/* elements of the configuration data */ 319struct dasd_ned { 320 struct { 321 __u8 identifier:2; 322 __u8 token_id:1; 323 __u8 sno_valid:1; 324 __u8 subst_sno:1; 325 __u8 recNED:1; 326 __u8 emuNED:1; 327 __u8 reserved:1; 328 } __attribute__ ((packed)) flags; 329 __u8 descriptor; 330 __u8 dev_class; 331 __u8 reserved; 332 __u8 dev_type[6]; 333 __u8 dev_model[3]; 334 __u8 HDA_manufacturer[3]; 335 struct { 336 __u8 HDA_location[2]; 337 __u8 HDA_seqno[12]; 338 } serial; 339 __u8 ID; 340 __u8 unit_addr; 341} __attribute__ ((packed)); 342 343struct dasd_sneq { 344 struct { 345 __u8 identifier:2; 346 __u8 reserved:6; 347 } __attribute__ ((packed)) flags; 348 __u8 res1; 349 __u16 format; 350 __u8 res2[4]; /* byte 4- 7 */ 351 __u8 sua_flags; /* byte 8 */ 352 __u8 base_unit_addr; /* byte 9 */ 353 __u8 res3[22]; /* byte 10-31 */ 354} __attribute__ ((packed)); 355 356struct vd_sneq { 357 struct { 358 __u8 identifier:2; 359 __u8 reserved:6; 360 } __attribute__ ((packed)) flags; 361 __u8 res1; 362 __u16 format; 363 __u8 res2[4]; /* byte 4- 7 */ 364 __u8 uit[16]; /* byte 8-23 */ 365 __u8 res3[8]; /* byte 24-31 */ 366} __attribute__ ((packed)); 367 368struct dasd_gneq { 369 struct { 370 __u8 identifier:2; 371 __u8 reserved:6; 372 } __attribute__ ((packed)) flags; 373 __u8 record_selector; 374 __u8 reserved[4]; 375 struct { 376 __u8 value:2; 377 __u8 number:6; 378 } __attribute__ ((packed)) timeout; 379 __u8 reserved3; 380 __u16 subsystemID; 381 __u8 reserved2[22]; 382} __attribute__ ((packed)); 383 384struct dasd_rssd_features { 385 char feature[256]; 386} __attribute__((packed)); 387 388struct dasd_rssd_messages { 389 __u16 length; 390 __u8 format; 391 __u8 code; 392 __u32 message_id; 393 __u8 flags; 394 char messages[4087]; 395} __packed; 396 397/* 398 * Read Subsystem Data - Volume Storage Query 399 */ 400struct dasd_rssd_vsq { 401 struct { 402 __u8 tse:1; 403 __u8 space_not_available:1; 404 __u8 ese:1; 405 __u8 unused:5; 406 } __packed vol_info; 407 __u8 unused1; 408 __u16 extent_pool_id; 409 __u8 warn_cap_limit; 410 __u8 warn_cap_guaranteed; 411 __u16 unused2; 412 __u32 limit_capacity; 413 __u32 guaranteed_capacity; 414 __u32 space_allocated; 415 __u32 space_configured; 416 __u32 logical_capacity; 417} __packed; 418 419/* 420 * Extent Pool Summary 421 */ 422struct dasd_ext_pool_sum { 423 __u16 pool_id; 424 __u8 repo_warn_thrshld; 425 __u8 warn_thrshld; 426 struct { 427 __u8 type:1; /* 0 - CKD / 1 - FB */ 428 __u8 track_space_efficient:1; 429 __u8 extent_space_efficient:1; 430 __u8 standard_volume:1; 431 __u8 extent_size_valid:1; 432 __u8 capacity_at_warnlevel:1; 433 __u8 pool_oos:1; 434 __u8 unused0:1; 435 __u8 unused1; 436 } __packed flags; 437 struct { 438 __u8 reserved0:1; 439 __u8 size_1G:1; 440 __u8 reserved1:5; 441 __u8 size_16M:1; 442 } __packed extent_size; 443 __u8 unused; 444} __packed; 445 446/* 447 * Read Subsystem Data-Response - Logical Configuration Query - Header 448 */ 449struct dasd_rssd_lcq { 450 __u16 data_length; /* Length of data returned */ 451 __u16 pool_count; /* Count of extent pools returned - Max: 448 */ 452 struct { 453 __u8 pool_info_valid:1; /* Detailed Information valid */ 454 __u8 pool_id_volume:1; 455 __u8 pool_id_cec:1; 456 __u8 unused0:5; 457 __u8 unused1; 458 } __packed header_flags; 459 char sfi_type[6]; /* Storage Facility Image Type (EBCDIC) */ 460 char sfi_model[3]; /* Storage Facility Image Model (EBCDIC) */ 461 __u8 sfi_seq_num[10]; /* Storage Facility Image Sequence Number */ 462 __u8 reserved[7]; 463 struct dasd_ext_pool_sum ext_pool_sum[448]; 464} __packed; 465 466struct dasd_oos_message { 467 __u16 length; 468 __u8 format; 469 __u8 code; 470 __u8 percentage_empty; 471 __u8 reserved; 472 __u16 ext_pool_id; 473 __u16 token; 474 __u8 unused[6]; 475} __packed; 476 477struct dasd_cuir_message { 478 __u16 length; 479 __u8 format; 480 __u8 code; 481 __u32 message_id; 482 __u8 flags; 483 __u8 neq_map[3]; 484 __u8 ned_map; 485 __u8 record_selector; 486} __packed; 487 488struct dasd_psf_cuir_response { 489 __u8 order; 490 __u8 flags; 491 __u8 cc; 492 __u8 chpid; 493 __u16 device_nr; 494 __u16 reserved; 495 __u32 message_id; 496 __u64 system_id; 497 __u8 cssid; 498 __u8 ssid; 499} __packed; 500 501struct dasd_ckd_path_group_entry { 502 __u8 status_flags; 503 __u8 pgid[11]; 504 __u8 sysplex_name[8]; 505 __u32 timestamp; 506 __u32 cylinder; 507 __u8 reserved[4]; 508} __packed; 509 510struct dasd_ckd_host_information { 511 __u8 access_flags; 512 __u8 entry_size; 513 __u16 entry_count; 514 __u8 entry[16390]; 515} __packed; 516 517struct dasd_psf_query_host_access { 518 __u8 access_flag; 519 __u8 version; 520 __u16 CKD_length; 521 __u16 SCSI_length; 522 __u8 unused[10]; 523 __u8 host_access_information[16394]; 524} __packed; 525 526/* 527 * Perform Subsystem Function - Prepare for Read Subsystem Data 528 */ 529struct dasd_psf_prssd_data { 530 unsigned char order; 531 unsigned char flags; 532 unsigned char reserved1; 533 unsigned char reserved2; 534 unsigned char lss; 535 unsigned char volume; 536 unsigned char suborder; 537 unsigned char varies[5]; 538} __attribute__ ((packed)); 539 540/* 541 * Perform Subsystem Function - Set Subsystem Characteristics 542 */ 543struct dasd_psf_ssc_data { 544 unsigned char order; 545 unsigned char flags; 546 unsigned char cu_type[4]; 547 unsigned char suborder; 548 unsigned char reserved[59]; 549} __attribute__((packed)); 550 551/* Maximum number of extents for a single Release Allocated Space command */ 552#define DASD_ECKD_RAS_EXTS_MAX 110U 553 554struct dasd_dso_ras_ext_range { 555 struct ch_t beg_ext; 556 struct ch_t end_ext; 557} __packed; 558 559/* 560 * Define Subsystem Operation - Release Allocated Space 561 */ 562struct dasd_dso_ras_data { 563 __u8 order; 564 struct { 565 __u8 message:1; /* Must be zero */ 566 __u8 reserved1:2; 567 __u8 vol_type:1; /* 0 - CKD/FBA, 1 - FB */ 568 __u8 reserved2:4; 569 } __packed flags; 570 /* Operation Flags to specify scope */ 571 struct { 572 __u8 reserved1:2; 573 /* Release Space by Extent */ 574 __u8 by_extent:1; /* 0 - entire volume, 1 - specified extents */ 575 __u8 guarantee_init:1; 576 __u8 force_release:1; /* Internal - will be ignored */ 577 __u16 reserved2:11; 578 } __packed op_flags; 579 __u8 lss; 580 __u8 dev_addr; 581 __u32 reserved1; 582 __u8 reserved2[10]; 583 __u16 nr_exts; /* Defines number of ext_scope - max 110 */ 584 __u16 reserved3; 585} __packed; 586 587 588/* 589 * some structures and definitions for alias handling 590 */ 591struct dasd_unit_address_configuration { 592 struct { 593 char ua_type; 594 char base_ua; 595 } unit[256]; 596} __attribute__((packed)); 597 598 599#define MAX_DEVICES_PER_LCU 256 600 601/* flags on the LCU */ 602#define NEED_UAC_UPDATE 0x01 603#define UPDATE_PENDING 0x02 604 605enum pavtype {NO_PAV, BASE_PAV, HYPER_PAV}; 606 607 608struct alias_root { 609 struct list_head serverlist; 610 spinlock_t lock; 611}; 612 613struct alias_server { 614 struct list_head server; 615 struct dasd_uid uid; 616 struct list_head lculist; 617}; 618 619struct summary_unit_check_work_data { 620 char reason; 621 struct dasd_device *device; 622 struct work_struct worker; 623}; 624 625struct read_uac_work_data { 626 struct dasd_device *device; 627 struct delayed_work dwork; 628}; 629 630struct alias_lcu { 631 struct list_head lcu; 632 struct dasd_uid uid; 633 enum pavtype pav; 634 char flags; 635 spinlock_t lock; 636 struct list_head grouplist; 637 struct list_head active_devices; 638 struct list_head inactive_devices; 639 struct dasd_unit_address_configuration *uac; 640 struct summary_unit_check_work_data suc_data; 641 struct read_uac_work_data ruac_data; 642 struct dasd_ccw_req *rsu_cqr; 643 struct completion lcu_setup; 644}; 645 646struct alias_pav_group { 647 struct list_head group; 648 struct dasd_uid uid; 649 struct alias_lcu *lcu; 650 struct list_head baselist; 651 struct list_head aliaslist; 652 struct dasd_device *next; 653}; 654 655struct dasd_conf_data { 656 struct dasd_ned neds[5]; 657 u8 reserved[64]; 658 struct dasd_gneq gneq; 659} __packed; 660 661struct dasd_conf { 662 u8 *data; 663 int len; 664 /* pointers to specific parts in the conf_data */ 665 struct dasd_ned *ned; 666 struct dasd_sneq *sneq; 667 struct vd_sneq *vdsneq; 668 struct dasd_gneq *gneq; 669}; 670 671struct dasd_eckd_private { 672 struct dasd_eckd_characteristics rdc_data; 673 struct dasd_conf conf; 674 675 struct eckd_count count_area[5]; 676 int init_cqr_status; 677 int uses_cdl; 678 struct attrib_data_t attrib; /* e.g. cache operations */ 679 struct dasd_rssd_features features; 680 struct dasd_rssd_vsq vsq; 681 struct dasd_ext_pool_sum eps; 682 u32 real_cyl; 683 684 /* alias management */ 685 struct dasd_uid uid; 686 struct alias_pav_group *pavgroup; 687 struct alias_lcu *lcu; 688 int count; 689 690 u32 fcx_max_data; 691 char suc_reason; 692}; 693 694 695 696int dasd_alias_make_device_known_to_lcu(struct dasd_device *); 697void dasd_alias_disconnect_device_from_lcu(struct dasd_device *); 698int dasd_alias_add_device(struct dasd_device *); 699int dasd_alias_remove_device(struct dasd_device *); 700struct dasd_device *dasd_alias_get_start_dev(struct dasd_device *); 701void dasd_alias_handle_summary_unit_check(struct work_struct *); 702void dasd_eckd_reset_ccw_to_base_io(struct dasd_ccw_req *); 703int dasd_alias_update_add_device(struct dasd_device *); 704#endif /* DASD_ECKD_H */