cio.h (9083B)
1/* SPDX-License-Identifier: GPL-2.0 */ 2/* 3 * Common interface for I/O on S/390 4 */ 5#ifndef _ASM_S390_CIO_H_ 6#define _ASM_S390_CIO_H_ 7 8#include <linux/bitops.h> 9#include <linux/genalloc.h> 10#include <asm/types.h> 11#include <asm/tpi.h> 12 13#define LPM_ANYPATH 0xff 14#define __MAX_CSSID 0 15#define __MAX_SUBCHANNEL 65535 16#define __MAX_SSID 3 17 18#include <asm/scsw.h> 19 20/** 21 * struct ccw1 - channel command word 22 * @cmd_code: command code 23 * @flags: flags, like IDA addressing, etc. 24 * @count: byte count 25 * @cda: data address 26 * 27 * The ccw is the basic structure to build channel programs that perform 28 * operations with the device or the control unit. Only Format-1 channel 29 * command words are supported. 30 */ 31struct ccw1 { 32 __u8 cmd_code; 33 __u8 flags; 34 __u16 count; 35 __u32 cda; 36} __attribute__ ((packed,aligned(8))); 37 38/** 39 * struct ccw0 - channel command word 40 * @cmd_code: command code 41 * @cda: data address 42 * @flags: flags, like IDA addressing, etc. 43 * @reserved: will be ignored 44 * @count: byte count 45 * 46 * The format-0 ccw structure. 47 */ 48struct ccw0 { 49 __u8 cmd_code; 50 __u32 cda : 24; 51 __u8 flags; 52 __u8 reserved; 53 __u16 count; 54} __packed __aligned(8); 55 56#define CCW_FLAG_DC 0x80 57#define CCW_FLAG_CC 0x40 58#define CCW_FLAG_SLI 0x20 59#define CCW_FLAG_SKIP 0x10 60#define CCW_FLAG_PCI 0x08 61#define CCW_FLAG_IDA 0x04 62#define CCW_FLAG_SUSPEND 0x02 63 64#define CCW_CMD_READ_IPL 0x02 65#define CCW_CMD_NOOP 0x03 66#define CCW_CMD_BASIC_SENSE 0x04 67#define CCW_CMD_TIC 0x08 68#define CCW_CMD_STLCK 0x14 69#define CCW_CMD_SENSE_PGID 0x34 70#define CCW_CMD_SUSPEND_RECONN 0x5B 71#define CCW_CMD_RDC 0x64 72#define CCW_CMD_RELEASE 0x94 73#define CCW_CMD_SET_PGID 0xAF 74#define CCW_CMD_SENSE_ID 0xE4 75#define CCW_CMD_DCTL 0xF3 76 77#define SENSE_MAX_COUNT 0x20 78 79/** 80 * struct erw - extended report word 81 * @res0: reserved 82 * @auth: authorization check 83 * @pvrf: path-verification-required flag 84 * @cpt: channel-path timeout 85 * @fsavf: failing storage address validity flag 86 * @cons: concurrent sense 87 * @scavf: secondary ccw address validity flag 88 * @fsaf: failing storage address format 89 * @scnt: sense count, if @cons == %1 90 * @res16: reserved 91 */ 92struct erw { 93 __u32 res0 : 3; 94 __u32 auth : 1; 95 __u32 pvrf : 1; 96 __u32 cpt : 1; 97 __u32 fsavf : 1; 98 __u32 cons : 1; 99 __u32 scavf : 1; 100 __u32 fsaf : 1; 101 __u32 scnt : 6; 102 __u32 res16 : 16; 103} __attribute__ ((packed)); 104 105/** 106 * struct erw_eadm - EADM Subchannel extended report word 107 * @b: aob error 108 * @r: arsb error 109 */ 110struct erw_eadm { 111 __u32 : 16; 112 __u32 b : 1; 113 __u32 r : 1; 114 __u32 : 14; 115} __packed; 116 117/** 118 * struct sublog - subchannel logout area 119 * @res0: reserved 120 * @esf: extended status flags 121 * @lpum: last path used mask 122 * @arep: ancillary report 123 * @fvf: field-validity flags 124 * @sacc: storage access code 125 * @termc: termination code 126 * @devsc: device-status check 127 * @serr: secondary error 128 * @ioerr: i/o-error alert 129 * @seqc: sequence code 130 */ 131struct sublog { 132 __u32 res0 : 1; 133 __u32 esf : 7; 134 __u32 lpum : 8; 135 __u32 arep : 1; 136 __u32 fvf : 5; 137 __u32 sacc : 2; 138 __u32 termc : 2; 139 __u32 devsc : 1; 140 __u32 serr : 1; 141 __u32 ioerr : 1; 142 __u32 seqc : 3; 143} __attribute__ ((packed)); 144 145/** 146 * struct esw0 - Format 0 Extended Status Word (ESW) 147 * @sublog: subchannel logout 148 * @erw: extended report word 149 * @faddr: failing storage address 150 * @saddr: secondary ccw address 151 */ 152struct esw0 { 153 struct sublog sublog; 154 struct erw erw; 155 __u32 faddr[2]; 156 __u32 saddr; 157} __attribute__ ((packed)); 158 159/** 160 * struct esw1 - Format 1 Extended Status Word (ESW) 161 * @zero0: reserved zeros 162 * @lpum: last path used mask 163 * @zero16: reserved zeros 164 * @erw: extended report word 165 * @zeros: three fullwords of zeros 166 */ 167struct esw1 { 168 __u8 zero0; 169 __u8 lpum; 170 __u16 zero16; 171 struct erw erw; 172 __u32 zeros[3]; 173} __attribute__ ((packed)); 174 175/** 176 * struct esw2 - Format 2 Extended Status Word (ESW) 177 * @zero0: reserved zeros 178 * @lpum: last path used mask 179 * @dcti: device-connect-time interval 180 * @erw: extended report word 181 * @zeros: three fullwords of zeros 182 */ 183struct esw2 { 184 __u8 zero0; 185 __u8 lpum; 186 __u16 dcti; 187 struct erw erw; 188 __u32 zeros[3]; 189} __attribute__ ((packed)); 190 191/** 192 * struct esw3 - Format 3 Extended Status Word (ESW) 193 * @zero0: reserved zeros 194 * @lpum: last path used mask 195 * @res: reserved 196 * @erw: extended report word 197 * @zeros: three fullwords of zeros 198 */ 199struct esw3 { 200 __u8 zero0; 201 __u8 lpum; 202 __u16 res; 203 struct erw erw; 204 __u32 zeros[3]; 205} __attribute__ ((packed)); 206 207/** 208 * struct esw_eadm - EADM Subchannel Extended Status Word (ESW) 209 * @sublog: subchannel logout 210 * @erw: extended report word 211 */ 212struct esw_eadm { 213 __u32 sublog; 214 struct erw_eadm erw; 215 __u32 : 32; 216 __u32 : 32; 217 __u32 : 32; 218} __packed; 219 220/** 221 * struct irb - interruption response block 222 * @scsw: subchannel status word 223 * @esw: extended status word 224 * @ecw: extended control word 225 * 226 * The irb that is handed to the device driver when an interrupt occurs. For 227 * solicited interrupts, the common I/O layer already performs checks whether 228 * a field is valid; a field not being valid is always passed as %0. 229 * If a unit check occurred, @ecw may contain sense data; this is retrieved 230 * by the common I/O layer itself if the device doesn't support concurrent 231 * sense (so that the device driver never needs to perform basic sense itself). 232 * For unsolicited interrupts, the irb is passed as-is (expect for sense data, 233 * if applicable). 234 */ 235struct irb { 236 union scsw scsw; 237 union { 238 struct esw0 esw0; 239 struct esw1 esw1; 240 struct esw2 esw2; 241 struct esw3 esw3; 242 struct esw_eadm eadm; 243 } esw; 244 __u8 ecw[32]; 245} __attribute__ ((packed,aligned(4))); 246 247/** 248 * struct ciw - command information word (CIW) layout 249 * @et: entry type 250 * @reserved: reserved bits 251 * @ct: command type 252 * @cmd: command code 253 * @count: command count 254 */ 255struct ciw { 256 __u32 et : 2; 257 __u32 reserved : 2; 258 __u32 ct : 4; 259 __u32 cmd : 8; 260 __u32 count : 16; 261} __attribute__ ((packed)); 262 263#define CIW_TYPE_RCD 0x0 /* read configuration data */ 264#define CIW_TYPE_SII 0x1 /* set interface identifier */ 265#define CIW_TYPE_RNI 0x2 /* read node identifier */ 266 267/* 268 * Node Descriptor as defined in SA22-7204, "Common I/O-Device Commands" 269 */ 270 271#define ND_VALIDITY_VALID 0 272#define ND_VALIDITY_OUTDATED 1 273#define ND_VALIDITY_INVALID 2 274 275struct node_descriptor { 276 /* Flags. */ 277 union { 278 struct { 279 u32 validity:3; 280 u32 reserved:5; 281 } __packed; 282 u8 byte0; 283 } __packed; 284 285 /* Node parameters. */ 286 u32 params:24; 287 288 /* Node ID. */ 289 char type[6]; 290 char model[3]; 291 char manufacturer[3]; 292 char plant[2]; 293 char seq[12]; 294 u16 tag; 295} __packed; 296 297/* 298 * Flags used as input parameters for do_IO() 299 */ 300#define DOIO_ALLOW_SUSPEND 0x0001 /* allow for channel prog. suspend */ 301#define DOIO_DENY_PREFETCH 0x0002 /* don't allow for CCW prefetch */ 302#define DOIO_SUPPRESS_INTER 0x0004 /* suppress intermediate inter. */ 303 /* ... for suspended CCWs */ 304/* Device or subchannel gone. */ 305#define CIO_GONE 0x0001 306/* No path to device. */ 307#define CIO_NO_PATH 0x0002 308/* Device has appeared. */ 309#define CIO_OPER 0x0004 310/* Sick revalidation of device. */ 311#define CIO_REVALIDATE 0x0008 312/* Device did not respond in time. */ 313#define CIO_BOXED 0x0010 314 315/** 316 * struct ccw_dev_id - unique identifier for ccw devices 317 * @ssid: subchannel set id 318 * @devno: device number 319 * 320 * This structure is not directly based on any hardware structure. The 321 * hardware identifies a device by its device number and its subchannel, 322 * which is in turn identified by its id. In order to get a unique identifier 323 * for ccw devices across subchannel sets, @struct ccw_dev_id has been 324 * introduced. 325 */ 326struct ccw_dev_id { 327 u8 ssid; 328 u16 devno; 329}; 330 331/** 332 * ccw_dev_id_is_equal() - compare two ccw_dev_ids 333 * @dev_id1: a ccw_dev_id 334 * @dev_id2: another ccw_dev_id 335 * Returns: 336 * %1 if the two structures are equal field-by-field, 337 * %0 if not. 338 * Context: 339 * any 340 */ 341static inline int ccw_dev_id_is_equal(struct ccw_dev_id *dev_id1, 342 struct ccw_dev_id *dev_id2) 343{ 344 if ((dev_id1->ssid == dev_id2->ssid) && 345 (dev_id1->devno == dev_id2->devno)) 346 return 1; 347 return 0; 348} 349 350/** 351 * pathmask_to_pos() - find the position of the left-most bit in a pathmask 352 * @mask: pathmask with at least one bit set 353 */ 354static inline u8 pathmask_to_pos(u8 mask) 355{ 356 return 8 - ffs(mask); 357} 358 359extern void css_schedule_reprobe(void); 360 361extern void *cio_dma_zalloc(size_t size); 362extern void cio_dma_free(void *cpu_addr, size_t size); 363extern struct device *cio_get_dma_css_dev(void); 364 365void *cio_gp_dma_zalloc(struct gen_pool *gp_dma, struct device *dma_dev, 366 size_t size); 367void cio_gp_dma_free(struct gen_pool *gp_dma, void *cpu_addr, size_t size); 368void cio_gp_dma_destroy(struct gen_pool *gp_dma, struct device *dma_dev); 369struct gen_pool *cio_gp_dma_create(struct device *dma_dev, int nr_pages); 370 371/* Function from drivers/s390/cio/chsc.c */ 372int chsc_sstpc(void *page, unsigned int op, u16 ctrl, long *clock_delta); 373int chsc_sstpi(void *page, void *result, size_t size); 374int chsc_stzi(void *page, void *result, size_t size); 375int chsc_sgib(u32 origin); 376int chsc_scud(u16 cu, u64 *esm, u8 *esm_valid); 377 378#endif