1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  *  Helper functions for scsw access.
4  *
5  *    Copyright IBM Corp. 2008, 2012
6  *    Author(s): Peter Oberparleiter <peter.oberparleiter@de.ibm.com>
7  */
8 
9 #ifndef _ASM_S390_SCSW_H_
10 #define _ASM_S390_SCSW_H_
11 
12 #include <linux/types.h>
13 #include <asm/css_chars.h>
14 #include <asm/cio.h>
15 
16 /**
17  * struct cmd_scsw - command-mode subchannel status word
18  * @key: subchannel key
19  * @sctl: suspend control
20  * @eswf: esw format
21  * @cc: deferred condition code
22  * @fmt: format
23  * @pfch: prefetch
24  * @isic: initial-status interruption control
25  * @alcc: address-limit checking control
26  * @ssi: suppress-suspended interruption
27  * @zcc: zero condition code
28  * @ectl: extended control
29  * @pno: path not operational
30  * @res: reserved
31  * @fctl: function control
32  * @actl: activity control
33  * @stctl: status control
34  * @cpa: channel program address
35  * @dstat: device status
36  * @cstat: subchannel status
37  * @count: residual count
38  */
39 struct cmd_scsw {
40 	__u32 key  : 4;
41 	__u32 sctl : 1;
42 	__u32 eswf : 1;
43 	__u32 cc   : 2;
44 	__u32 fmt  : 1;
45 	__u32 pfch : 1;
46 	__u32 isic : 1;
47 	__u32 alcc : 1;
48 	__u32 ssi  : 1;
49 	__u32 zcc  : 1;
50 	__u32 ectl : 1;
51 	__u32 pno  : 1;
52 	__u32 res  : 1;
53 	__u32 fctl : 3;
54 	__u32 actl : 7;
55 	__u32 stctl : 5;
56 	__u32 cpa;
57 	__u32 dstat : 8;
58 	__u32 cstat : 8;
59 	__u32 count : 16;
60 } __attribute__ ((packed));
61 
62 /**
63  * struct tm_scsw - transport-mode subchannel status word
64  * @key: subchannel key
65  * @eswf: esw format
66  * @cc: deferred condition code
67  * @fmt: format
68  * @x: IRB-format control
69  * @q: interrogate-complete
70  * @ectl: extended control
71  * @pno: path not operational
72  * @fctl: function control
73  * @actl: activity control
74  * @stctl: status control
75  * @tcw: TCW address
76  * @dstat: device status
77  * @cstat: subchannel status
78  * @fcxs: FCX status
79  * @schxs: subchannel-extended status
80  */
81 struct tm_scsw {
82 	u32 key:4;
83 	u32 :1;
84 	u32 eswf:1;
85 	u32 cc:2;
86 	u32 fmt:3;
87 	u32 x:1;
88 	u32 q:1;
89 	u32 :1;
90 	u32 ectl:1;
91 	u32 pno:1;
92 	u32 :1;
93 	u32 fctl:3;
94 	u32 actl:7;
95 	u32 stctl:5;
96 	u32 tcw;
97 	u32 dstat:8;
98 	u32 cstat:8;
99 	u32 fcxs:8;
100 	u32 ifob:1;
101 	u32 sesq:7;
102 } __attribute__ ((packed));
103 
104 /**
105  * struct eadm_scsw - subchannel status word for eadm subchannels
106  * @key: subchannel key
107  * @eswf: esw format
108  * @cc: deferred condition code
109  * @ectl: extended control
110  * @fctl: function control
111  * @actl: activity control
112  * @stctl: status control
113  * @aob: AOB address
114  * @dstat: device status
115  * @cstat: subchannel status
116  */
117 struct eadm_scsw {
118 	u32 key:4;
119 	u32:1;
120 	u32 eswf:1;
121 	u32 cc:2;
122 	u32:6;
123 	u32 ectl:1;
124 	u32:2;
125 	u32 fctl:3;
126 	u32 actl:7;
127 	u32 stctl:5;
128 	u32 aob;
129 	u32 dstat:8;
130 	u32 cstat:8;
131 	u32:16;
132 } __packed;
133 
134 /**
135  * union scsw - subchannel status word
136  * @cmd: command-mode SCSW
137  * @tm: transport-mode SCSW
138  * @eadm: eadm SCSW
139  */
140 union scsw {
141 	struct cmd_scsw cmd;
142 	struct tm_scsw tm;
143 	struct eadm_scsw eadm;
144 } __packed;
145 
146 #define SCSW_FCTL_CLEAR_FUNC	 0x1
147 #define SCSW_FCTL_HALT_FUNC	 0x2
148 #define SCSW_FCTL_START_FUNC	 0x4
149 
150 #define SCSW_ACTL_SUSPENDED	 0x1
151 #define SCSW_ACTL_DEVACT	 0x2
152 #define SCSW_ACTL_SCHACT	 0x4
153 #define SCSW_ACTL_CLEAR_PEND	 0x8
154 #define SCSW_ACTL_HALT_PEND	 0x10
155 #define SCSW_ACTL_START_PEND	 0x20
156 #define SCSW_ACTL_RESUME_PEND	 0x40
157 
158 #define SCSW_STCTL_STATUS_PEND	 0x1
159 #define SCSW_STCTL_SEC_STATUS	 0x2
160 #define SCSW_STCTL_PRIM_STATUS	 0x4
161 #define SCSW_STCTL_INTER_STATUS	 0x8
162 #define SCSW_STCTL_ALERT_STATUS	 0x10
163 
164 #define DEV_STAT_ATTENTION	 0x80
165 #define DEV_STAT_STAT_MOD	 0x40
166 #define DEV_STAT_CU_END		 0x20
167 #define DEV_STAT_BUSY		 0x10
168 #define DEV_STAT_CHN_END	 0x08
169 #define DEV_STAT_DEV_END	 0x04
170 #define DEV_STAT_UNIT_CHECK	 0x02
171 #define DEV_STAT_UNIT_EXCEP	 0x01
172 
173 #define SCHN_STAT_PCI		 0x80
174 #define SCHN_STAT_INCORR_LEN	 0x40
175 #define SCHN_STAT_PROG_CHECK	 0x20
176 #define SCHN_STAT_PROT_CHECK	 0x10
177 #define SCHN_STAT_CHN_DATA_CHK	 0x08
178 #define SCHN_STAT_CHN_CTRL_CHK	 0x04
179 #define SCHN_STAT_INTF_CTRL_CHK	 0x02
180 #define SCHN_STAT_CHAIN_CHECK	 0x01
181 
182 #define SCSW_SESQ_DEV_NOFCX	 3
183 #define SCSW_SESQ_PATH_NOFCX	 4
184 
185 /*
186  * architectured values for first sense byte
187  */
188 #define SNS0_CMD_REJECT		0x80
189 #define SNS_CMD_REJECT		SNS0_CMD_REJEC
190 #define SNS0_INTERVENTION_REQ	0x40
191 #define SNS0_BUS_OUT_CHECK	0x20
192 #define SNS0_EQUIPMENT_CHECK	0x10
193 #define SNS0_DATA_CHECK		0x08
194 #define SNS0_OVERRUN		0x04
195 #define SNS0_INCOMPL_DOMAIN	0x01
196 
197 /*
198  * architectured values for second sense byte
199  */
200 #define SNS1_PERM_ERR		0x80
201 #define SNS1_INV_TRACK_FORMAT	0x40
202 #define SNS1_EOC		0x20
203 #define SNS1_MESSAGE_TO_OPER	0x10
204 #define SNS1_NO_REC_FOUND	0x08
205 #define SNS1_FILE_PROTECTED	0x04
206 #define SNS1_WRITE_INHIBITED	0x02
207 #define SNS1_INPRECISE_END	0x01
208 
209 /*
210  * architectured values for third sense byte
211  */
212 #define SNS2_REQ_INH_WRITE	0x80
213 #define SNS2_CORRECTABLE	0x40
214 #define SNS2_FIRST_LOG_ERR	0x20
215 #define SNS2_ENV_DATA_PRESENT	0x10
216 #define SNS2_INPRECISE_END	0x04
217 
218 /**
219  * scsw_is_tm - check for transport mode scsw
220  * @scsw: pointer to scsw
221  *
222  * Return non-zero if the specified scsw is a transport mode scsw, zero
223  * otherwise.
224  */
scsw_is_tm(union scsw * scsw)225 static inline int scsw_is_tm(union scsw *scsw)
226 {
227 	return css_general_characteristics.fcx && (scsw->tm.x == 1);
228 }
229 
230 /**
231  * scsw_key - return scsw key field
232  * @scsw: pointer to scsw
233  *
234  * Return the value of the key field of the specified scsw, regardless of
235  * whether it is a transport mode or command mode scsw.
236  */
scsw_key(union scsw * scsw)237 static inline u32 scsw_key(union scsw *scsw)
238 {
239 	if (scsw_is_tm(scsw))
240 		return scsw->tm.key;
241 	else
242 		return scsw->cmd.key;
243 }
244 
245 /**
246  * scsw_eswf - return scsw eswf field
247  * @scsw: pointer to scsw
248  *
249  * Return the value of the eswf field of the specified scsw, regardless of
250  * whether it is a transport mode or command mode scsw.
251  */
scsw_eswf(union scsw * scsw)252 static inline u32 scsw_eswf(union scsw *scsw)
253 {
254 	if (scsw_is_tm(scsw))
255 		return scsw->tm.eswf;
256 	else
257 		return scsw->cmd.eswf;
258 }
259 
260 /**
261  * scsw_cc - return scsw cc field
262  * @scsw: pointer to scsw
263  *
264  * Return the value of the cc field of the specified scsw, regardless of
265  * whether it is a transport mode or command mode scsw.
266  */
scsw_cc(union scsw * scsw)267 static inline u32 scsw_cc(union scsw *scsw)
268 {
269 	if (scsw_is_tm(scsw))
270 		return scsw->tm.cc;
271 	else
272 		return scsw->cmd.cc;
273 }
274 
275 /**
276  * scsw_ectl - return scsw ectl field
277  * @scsw: pointer to scsw
278  *
279  * Return the value of the ectl field of the specified scsw, regardless of
280  * whether it is a transport mode or command mode scsw.
281  */
scsw_ectl(union scsw * scsw)282 static inline u32 scsw_ectl(union scsw *scsw)
283 {
284 	if (scsw_is_tm(scsw))
285 		return scsw->tm.ectl;
286 	else
287 		return scsw->cmd.ectl;
288 }
289 
290 /**
291  * scsw_pno - return scsw pno field
292  * @scsw: pointer to scsw
293  *
294  * Return the value of the pno field of the specified scsw, regardless of
295  * whether it is a transport mode or command mode scsw.
296  */
scsw_pno(union scsw * scsw)297 static inline u32 scsw_pno(union scsw *scsw)
298 {
299 	if (scsw_is_tm(scsw))
300 		return scsw->tm.pno;
301 	else
302 		return scsw->cmd.pno;
303 }
304 
305 /**
306  * scsw_fctl - return scsw fctl field
307  * @scsw: pointer to scsw
308  *
309  * Return the value of the fctl field of the specified scsw, regardless of
310  * whether it is a transport mode or command mode scsw.
311  */
scsw_fctl(union scsw * scsw)312 static inline u32 scsw_fctl(union scsw *scsw)
313 {
314 	if (scsw_is_tm(scsw))
315 		return scsw->tm.fctl;
316 	else
317 		return scsw->cmd.fctl;
318 }
319 
320 /**
321  * scsw_actl - return scsw actl field
322  * @scsw: pointer to scsw
323  *
324  * Return the value of the actl field of the specified scsw, regardless of
325  * whether it is a transport mode or command mode scsw.
326  */
scsw_actl(union scsw * scsw)327 static inline u32 scsw_actl(union scsw *scsw)
328 {
329 	if (scsw_is_tm(scsw))
330 		return scsw->tm.actl;
331 	else
332 		return scsw->cmd.actl;
333 }
334 
335 /**
336  * scsw_stctl - return scsw stctl field
337  * @scsw: pointer to scsw
338  *
339  * Return the value of the stctl field of the specified scsw, regardless of
340  * whether it is a transport mode or command mode scsw.
341  */
scsw_stctl(union scsw * scsw)342 static inline u32 scsw_stctl(union scsw *scsw)
343 {
344 	if (scsw_is_tm(scsw))
345 		return scsw->tm.stctl;
346 	else
347 		return scsw->cmd.stctl;
348 }
349 
350 /**
351  * scsw_dstat - return scsw dstat field
352  * @scsw: pointer to scsw
353  *
354  * Return the value of the dstat field of the specified scsw, regardless of
355  * whether it is a transport mode or command mode scsw.
356  */
scsw_dstat(union scsw * scsw)357 static inline u32 scsw_dstat(union scsw *scsw)
358 {
359 	if (scsw_is_tm(scsw))
360 		return scsw->tm.dstat;
361 	else
362 		return scsw->cmd.dstat;
363 }
364 
365 /**
366  * scsw_cstat - return scsw cstat field
367  * @scsw: pointer to scsw
368  *
369  * Return the value of the cstat field of the specified scsw, regardless of
370  * whether it is a transport mode or command mode scsw.
371  */
scsw_cstat(union scsw * scsw)372 static inline u32 scsw_cstat(union scsw *scsw)
373 {
374 	if (scsw_is_tm(scsw))
375 		return scsw->tm.cstat;
376 	else
377 		return scsw->cmd.cstat;
378 }
379 
380 /**
381  * scsw_cmd_is_valid_key - check key field validity
382  * @scsw: pointer to scsw
383  *
384  * Return non-zero if the key field of the specified command mode scsw is
385  * valid, zero otherwise.
386  */
scsw_cmd_is_valid_key(union scsw * scsw)387 static inline int scsw_cmd_is_valid_key(union scsw *scsw)
388 {
389 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
390 }
391 
392 /**
393  * scsw_cmd_is_valid_sctl - check sctl field validity
394  * @scsw: pointer to scsw
395  *
396  * Return non-zero if the sctl field of the specified command mode scsw is
397  * valid, zero otherwise.
398  */
scsw_cmd_is_valid_sctl(union scsw * scsw)399 static inline int scsw_cmd_is_valid_sctl(union scsw *scsw)
400 {
401 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
402 }
403 
404 /**
405  * scsw_cmd_is_valid_eswf - check eswf field validity
406  * @scsw: pointer to scsw
407  *
408  * Return non-zero if the eswf field of the specified command mode scsw is
409  * valid, zero otherwise.
410  */
scsw_cmd_is_valid_eswf(union scsw * scsw)411 static inline int scsw_cmd_is_valid_eswf(union scsw *scsw)
412 {
413 	return (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND);
414 }
415 
416 /**
417  * scsw_cmd_is_valid_cc - check cc field validity
418  * @scsw: pointer to scsw
419  *
420  * Return non-zero if the cc field of the specified command mode scsw is
421  * valid, zero otherwise.
422  */
scsw_cmd_is_valid_cc(union scsw * scsw)423 static inline int scsw_cmd_is_valid_cc(union scsw *scsw)
424 {
425 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC) &&
426 	       (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND);
427 }
428 
429 /**
430  * scsw_cmd_is_valid_fmt - check fmt field validity
431  * @scsw: pointer to scsw
432  *
433  * Return non-zero if the fmt field of the specified command mode scsw is
434  * valid, zero otherwise.
435  */
scsw_cmd_is_valid_fmt(union scsw * scsw)436 static inline int scsw_cmd_is_valid_fmt(union scsw *scsw)
437 {
438 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
439 }
440 
441 /**
442  * scsw_cmd_is_valid_pfch - check pfch field validity
443  * @scsw: pointer to scsw
444  *
445  * Return non-zero if the pfch field of the specified command mode scsw is
446  * valid, zero otherwise.
447  */
scsw_cmd_is_valid_pfch(union scsw * scsw)448 static inline int scsw_cmd_is_valid_pfch(union scsw *scsw)
449 {
450 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
451 }
452 
453 /**
454  * scsw_cmd_is_valid_isic - check isic field validity
455  * @scsw: pointer to scsw
456  *
457  * Return non-zero if the isic field of the specified command mode scsw is
458  * valid, zero otherwise.
459  */
scsw_cmd_is_valid_isic(union scsw * scsw)460 static inline int scsw_cmd_is_valid_isic(union scsw *scsw)
461 {
462 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
463 }
464 
465 /**
466  * scsw_cmd_is_valid_alcc - check alcc field validity
467  * @scsw: pointer to scsw
468  *
469  * Return non-zero if the alcc field of the specified command mode scsw is
470  * valid, zero otherwise.
471  */
scsw_cmd_is_valid_alcc(union scsw * scsw)472 static inline int scsw_cmd_is_valid_alcc(union scsw *scsw)
473 {
474 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
475 }
476 
477 /**
478  * scsw_cmd_is_valid_ssi - check ssi field validity
479  * @scsw: pointer to scsw
480  *
481  * Return non-zero if the ssi field of the specified command mode scsw is
482  * valid, zero otherwise.
483  */
scsw_cmd_is_valid_ssi(union scsw * scsw)484 static inline int scsw_cmd_is_valid_ssi(union scsw *scsw)
485 {
486 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC);
487 }
488 
489 /**
490  * scsw_cmd_is_valid_zcc - check zcc field validity
491  * @scsw: pointer to scsw
492  *
493  * Return non-zero if the zcc field of the specified command mode scsw is
494  * valid, zero otherwise.
495  */
scsw_cmd_is_valid_zcc(union scsw * scsw)496 static inline int scsw_cmd_is_valid_zcc(union scsw *scsw)
497 {
498 	return (scsw->cmd.fctl & SCSW_FCTL_START_FUNC) &&
499 	       (scsw->cmd.stctl & SCSW_STCTL_INTER_STATUS);
500 }
501 
502 /**
503  * scsw_cmd_is_valid_ectl - check ectl field validity
504  * @scsw: pointer to scsw
505  *
506  * Return non-zero if the ectl field of the specified command mode scsw is
507  * valid, zero otherwise.
508  */
scsw_cmd_is_valid_ectl(union scsw * scsw)509 static inline int scsw_cmd_is_valid_ectl(union scsw *scsw)
510 {
511 	return (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND) &&
512 	       !(scsw->cmd.stctl & SCSW_STCTL_INTER_STATUS) &&
513 	       (scsw->cmd.stctl & SCSW_STCTL_ALERT_STATUS);
514 }
515 
516 /**
517  * scsw_cmd_is_valid_pno - check pno field validity
518  * @scsw: pointer to scsw
519  *
520  * Return non-zero if the pno field of the specified command mode scsw is
521  * valid, zero otherwise.
522  */
scsw_cmd_is_valid_pno(union scsw * scsw)523 static inline int scsw_cmd_is_valid_pno(union scsw *scsw)
524 {
525 	return (scsw->cmd.fctl != 0) &&
526 	       (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND) &&
527 	       (!(scsw->cmd.stctl & SCSW_STCTL_INTER_STATUS) ||
528 		 ((scsw->cmd.stctl & SCSW_STCTL_INTER_STATUS) &&
529 		  (scsw->cmd.actl & SCSW_ACTL_SUSPENDED)));
530 }
531 
532 /**
533  * scsw_cmd_is_valid_fctl - check fctl field validity
534  * @scsw: pointer to scsw
535  *
536  * Return non-zero if the fctl field of the specified command mode scsw is
537  * valid, zero otherwise.
538  */
scsw_cmd_is_valid_fctl(union scsw * scsw)539 static inline int scsw_cmd_is_valid_fctl(union scsw *scsw)
540 {
541 	/* Only valid if pmcw.dnv == 1*/
542 	return 1;
543 }
544 
545 /**
546  * scsw_cmd_is_valid_actl - check actl field validity
547  * @scsw: pointer to scsw
548  *
549  * Return non-zero if the actl field of the specified command mode scsw is
550  * valid, zero otherwise.
551  */
scsw_cmd_is_valid_actl(union scsw * scsw)552 static inline int scsw_cmd_is_valid_actl(union scsw *scsw)
553 {
554 	/* Only valid if pmcw.dnv == 1*/
555 	return 1;
556 }
557 
558 /**
559  * scsw_cmd_is_valid_stctl - check stctl field validity
560  * @scsw: pointer to scsw
561  *
562  * Return non-zero if the stctl field of the specified command mode scsw is
563  * valid, zero otherwise.
564  */
scsw_cmd_is_valid_stctl(union scsw * scsw)565 static inline int scsw_cmd_is_valid_stctl(union scsw *scsw)
566 {
567 	/* Only valid if pmcw.dnv == 1*/
568 	return 1;
569 }
570 
571 /**
572  * scsw_cmd_is_valid_dstat - check dstat field validity
573  * @scsw: pointer to scsw
574  *
575  * Return non-zero if the dstat field of the specified command mode scsw is
576  * valid, zero otherwise.
577  */
scsw_cmd_is_valid_dstat(union scsw * scsw)578 static inline int scsw_cmd_is_valid_dstat(union scsw *scsw)
579 {
580 	return (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND) &&
581 	       (scsw->cmd.cc != 3);
582 }
583 
584 /**
585  * scsw_cmd_is_valid_cstat - check cstat field validity
586  * @scsw: pointer to scsw
587  *
588  * Return non-zero if the cstat field of the specified command mode scsw is
589  * valid, zero otherwise.
590  */
scsw_cmd_is_valid_cstat(union scsw * scsw)591 static inline int scsw_cmd_is_valid_cstat(union scsw *scsw)
592 {
593 	return (scsw->cmd.stctl & SCSW_STCTL_STATUS_PEND) &&
594 	       (scsw->cmd.cc != 3);
595 }
596 
597 /**
598  * scsw_tm_is_valid_key - check key field validity
599  * @scsw: pointer to scsw
600  *
601  * Return non-zero if the key field of the specified transport mode scsw is
602  * valid, zero otherwise.
603  */
scsw_tm_is_valid_key(union scsw * scsw)604 static inline int scsw_tm_is_valid_key(union scsw *scsw)
605 {
606 	return (scsw->tm.fctl & SCSW_FCTL_START_FUNC);
607 }
608 
609 /**
610  * scsw_tm_is_valid_eswf - check eswf field validity
611  * @scsw: pointer to scsw
612  *
613  * Return non-zero if the eswf field of the specified transport mode scsw is
614  * valid, zero otherwise.
615  */
scsw_tm_is_valid_eswf(union scsw * scsw)616 static inline int scsw_tm_is_valid_eswf(union scsw *scsw)
617 {
618 	return (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND);
619 }
620 
621 /**
622  * scsw_tm_is_valid_cc - check cc field validity
623  * @scsw: pointer to scsw
624  *
625  * Return non-zero if the cc field of the specified transport mode scsw is
626  * valid, zero otherwise.
627  */
scsw_tm_is_valid_cc(union scsw * scsw)628 static inline int scsw_tm_is_valid_cc(union scsw *scsw)
629 {
630 	return (scsw->tm.fctl & SCSW_FCTL_START_FUNC) &&
631 	       (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND);
632 }
633 
634 /**
635  * scsw_tm_is_valid_fmt - check fmt field validity
636  * @scsw: pointer to scsw
637  *
638  * Return non-zero if the fmt field of the specified transport mode scsw is
639  * valid, zero otherwise.
640  */
scsw_tm_is_valid_fmt(union scsw * scsw)641 static inline int scsw_tm_is_valid_fmt(union scsw *scsw)
642 {
643 	return 1;
644 }
645 
646 /**
647  * scsw_tm_is_valid_x - check x field validity
648  * @scsw: pointer to scsw
649  *
650  * Return non-zero if the x field of the specified transport mode scsw is
651  * valid, zero otherwise.
652  */
scsw_tm_is_valid_x(union scsw * scsw)653 static inline int scsw_tm_is_valid_x(union scsw *scsw)
654 {
655 	return 1;
656 }
657 
658 /**
659  * scsw_tm_is_valid_q - check q field validity
660  * @scsw: pointer to scsw
661  *
662  * Return non-zero if the q field of the specified transport mode scsw is
663  * valid, zero otherwise.
664  */
scsw_tm_is_valid_q(union scsw * scsw)665 static inline int scsw_tm_is_valid_q(union scsw *scsw)
666 {
667 	return 1;
668 }
669 
670 /**
671  * scsw_tm_is_valid_ectl - check ectl field validity
672  * @scsw: pointer to scsw
673  *
674  * Return non-zero if the ectl field of the specified transport mode scsw is
675  * valid, zero otherwise.
676  */
scsw_tm_is_valid_ectl(union scsw * scsw)677 static inline int scsw_tm_is_valid_ectl(union scsw *scsw)
678 {
679 	return (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND) &&
680 	       !(scsw->tm.stctl & SCSW_STCTL_INTER_STATUS) &&
681 	       (scsw->tm.stctl & SCSW_STCTL_ALERT_STATUS);
682 }
683 
684 /**
685  * scsw_tm_is_valid_pno - check pno field validity
686  * @scsw: pointer to scsw
687  *
688  * Return non-zero if the pno field of the specified transport mode scsw is
689  * valid, zero otherwise.
690  */
scsw_tm_is_valid_pno(union scsw * scsw)691 static inline int scsw_tm_is_valid_pno(union scsw *scsw)
692 {
693 	return (scsw->tm.fctl != 0) &&
694 	       (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND) &&
695 	       (!(scsw->tm.stctl & SCSW_STCTL_INTER_STATUS) ||
696 		 ((scsw->tm.stctl & SCSW_STCTL_INTER_STATUS) &&
697 		  (scsw->tm.actl & SCSW_ACTL_SUSPENDED)));
698 }
699 
700 /**
701  * scsw_tm_is_valid_fctl - check fctl field validity
702  * @scsw: pointer to scsw
703  *
704  * Return non-zero if the fctl field of the specified transport mode scsw is
705  * valid, zero otherwise.
706  */
scsw_tm_is_valid_fctl(union scsw * scsw)707 static inline int scsw_tm_is_valid_fctl(union scsw *scsw)
708 {
709 	/* Only valid if pmcw.dnv == 1*/
710 	return 1;
711 }
712 
713 /**
714  * scsw_tm_is_valid_actl - check actl field validity
715  * @scsw: pointer to scsw
716  *
717  * Return non-zero if the actl field of the specified transport mode scsw is
718  * valid, zero otherwise.
719  */
scsw_tm_is_valid_actl(union scsw * scsw)720 static inline int scsw_tm_is_valid_actl(union scsw *scsw)
721 {
722 	/* Only valid if pmcw.dnv == 1*/
723 	return 1;
724 }
725 
726 /**
727  * scsw_tm_is_valid_stctl - check stctl field validity
728  * @scsw: pointer to scsw
729  *
730  * Return non-zero if the stctl field of the specified transport mode scsw is
731  * valid, zero otherwise.
732  */
scsw_tm_is_valid_stctl(union scsw * scsw)733 static inline int scsw_tm_is_valid_stctl(union scsw *scsw)
734 {
735 	/* Only valid if pmcw.dnv == 1*/
736 	return 1;
737 }
738 
739 /**
740  * scsw_tm_is_valid_dstat - check dstat field validity
741  * @scsw: pointer to scsw
742  *
743  * Return non-zero if the dstat field of the specified transport mode scsw is
744  * valid, zero otherwise.
745  */
scsw_tm_is_valid_dstat(union scsw * scsw)746 static inline int scsw_tm_is_valid_dstat(union scsw *scsw)
747 {
748 	return (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND) &&
749 	       (scsw->tm.cc != 3);
750 }
751 
752 /**
753  * scsw_tm_is_valid_cstat - check cstat field validity
754  * @scsw: pointer to scsw
755  *
756  * Return non-zero if the cstat field of the specified transport mode scsw is
757  * valid, zero otherwise.
758  */
scsw_tm_is_valid_cstat(union scsw * scsw)759 static inline int scsw_tm_is_valid_cstat(union scsw *scsw)
760 {
761 	return (scsw->tm.stctl & SCSW_STCTL_STATUS_PEND) &&
762 	       (scsw->tm.cc != 3);
763 }
764 
765 /**
766  * scsw_tm_is_valid_fcxs - check fcxs field validity
767  * @scsw: pointer to scsw
768  *
769  * Return non-zero if the fcxs field of the specified transport mode scsw is
770  * valid, zero otherwise.
771  */
scsw_tm_is_valid_fcxs(union scsw * scsw)772 static inline int scsw_tm_is_valid_fcxs(union scsw *scsw)
773 {
774 	return 1;
775 }
776 
777 /**
778  * scsw_tm_is_valid_schxs - check schxs field validity
779  * @scsw: pointer to scsw
780  *
781  * Return non-zero if the schxs field of the specified transport mode scsw is
782  * valid, zero otherwise.
783  */
scsw_tm_is_valid_schxs(union scsw * scsw)784 static inline int scsw_tm_is_valid_schxs(union scsw *scsw)
785 {
786 	return (scsw->tm.cstat & (SCHN_STAT_PROG_CHECK |
787 				  SCHN_STAT_INTF_CTRL_CHK |
788 				  SCHN_STAT_PROT_CHECK |
789 				  SCHN_STAT_CHN_DATA_CHK));
790 }
791 
792 /**
793  * scsw_is_valid_actl - check actl field validity
794  * @scsw: pointer to scsw
795  *
796  * Return non-zero if the actl field of the specified scsw is valid,
797  * regardless of whether it is a transport mode or command mode scsw.
798  * Return zero if the field does not contain a valid value.
799  */
scsw_is_valid_actl(union scsw * scsw)800 static inline int scsw_is_valid_actl(union scsw *scsw)
801 {
802 	if (scsw_is_tm(scsw))
803 		return scsw_tm_is_valid_actl(scsw);
804 	else
805 		return scsw_cmd_is_valid_actl(scsw);
806 }
807 
808 /**
809  * scsw_is_valid_cc - check cc field validity
810  * @scsw: pointer to scsw
811  *
812  * Return non-zero if the cc field of the specified scsw is valid,
813  * regardless of whether it is a transport mode or command mode scsw.
814  * Return zero if the field does not contain a valid value.
815  */
scsw_is_valid_cc(union scsw * scsw)816 static inline int scsw_is_valid_cc(union scsw *scsw)
817 {
818 	if (scsw_is_tm(scsw))
819 		return scsw_tm_is_valid_cc(scsw);
820 	else
821 		return scsw_cmd_is_valid_cc(scsw);
822 }
823 
824 /**
825  * scsw_is_valid_cstat - check cstat field validity
826  * @scsw: pointer to scsw
827  *
828  * Return non-zero if the cstat field of the specified scsw is valid,
829  * regardless of whether it is a transport mode or command mode scsw.
830  * Return zero if the field does not contain a valid value.
831  */
scsw_is_valid_cstat(union scsw * scsw)832 static inline int scsw_is_valid_cstat(union scsw *scsw)
833 {
834 	if (scsw_is_tm(scsw))
835 		return scsw_tm_is_valid_cstat(scsw);
836 	else
837 		return scsw_cmd_is_valid_cstat(scsw);
838 }
839 
840 /**
841  * scsw_is_valid_dstat - check dstat field validity
842  * @scsw: pointer to scsw
843  *
844  * Return non-zero if the dstat field of the specified scsw is valid,
845  * regardless of whether it is a transport mode or command mode scsw.
846  * Return zero if the field does not contain a valid value.
847  */
scsw_is_valid_dstat(union scsw * scsw)848 static inline int scsw_is_valid_dstat(union scsw *scsw)
849 {
850 	if (scsw_is_tm(scsw))
851 		return scsw_tm_is_valid_dstat(scsw);
852 	else
853 		return scsw_cmd_is_valid_dstat(scsw);
854 }
855 
856 /**
857  * scsw_is_valid_ectl - check ectl field validity
858  * @scsw: pointer to scsw
859  *
860  * Return non-zero if the ectl field of the specified scsw is valid,
861  * regardless of whether it is a transport mode or command mode scsw.
862  * Return zero if the field does not contain a valid value.
863  */
scsw_is_valid_ectl(union scsw * scsw)864 static inline int scsw_is_valid_ectl(union scsw *scsw)
865 {
866 	if (scsw_is_tm(scsw))
867 		return scsw_tm_is_valid_ectl(scsw);
868 	else
869 		return scsw_cmd_is_valid_ectl(scsw);
870 }
871 
872 /**
873  * scsw_is_valid_eswf - check eswf field validity
874  * @scsw: pointer to scsw
875  *
876  * Return non-zero if the eswf field of the specified scsw is valid,
877  * regardless of whether it is a transport mode or command mode scsw.
878  * Return zero if the field does not contain a valid value.
879  */
scsw_is_valid_eswf(union scsw * scsw)880 static inline int scsw_is_valid_eswf(union scsw *scsw)
881 {
882 	if (scsw_is_tm(scsw))
883 		return scsw_tm_is_valid_eswf(scsw);
884 	else
885 		return scsw_cmd_is_valid_eswf(scsw);
886 }
887 
888 /**
889  * scsw_is_valid_fctl - check fctl field validity
890  * @scsw: pointer to scsw
891  *
892  * Return non-zero if the fctl field of the specified scsw is valid,
893  * regardless of whether it is a transport mode or command mode scsw.
894  * Return zero if the field does not contain a valid value.
895  */
scsw_is_valid_fctl(union scsw * scsw)896 static inline int scsw_is_valid_fctl(union scsw *scsw)
897 {
898 	if (scsw_is_tm(scsw))
899 		return scsw_tm_is_valid_fctl(scsw);
900 	else
901 		return scsw_cmd_is_valid_fctl(scsw);
902 }
903 
904 /**
905  * scsw_is_valid_key - check key field validity
906  * @scsw: pointer to scsw
907  *
908  * Return non-zero if the key field of the specified scsw is valid,
909  * regardless of whether it is a transport mode or command mode scsw.
910  * Return zero if the field does not contain a valid value.
911  */
scsw_is_valid_key(union scsw * scsw)912 static inline int scsw_is_valid_key(union scsw *scsw)
913 {
914 	if (scsw_is_tm(scsw))
915 		return scsw_tm_is_valid_key(scsw);
916 	else
917 		return scsw_cmd_is_valid_key(scsw);
918 }
919 
920 /**
921  * scsw_is_valid_pno - check pno field validity
922  * @scsw: pointer to scsw
923  *
924  * Return non-zero if the pno field of the specified scsw is valid,
925  * regardless of whether it is a transport mode or command mode scsw.
926  * Return zero if the field does not contain a valid value.
927  */
scsw_is_valid_pno(union scsw * scsw)928 static inline int scsw_is_valid_pno(union scsw *scsw)
929 {
930 	if (scsw_is_tm(scsw))
931 		return scsw_tm_is_valid_pno(scsw);
932 	else
933 		return scsw_cmd_is_valid_pno(scsw);
934 }
935 
936 /**
937  * scsw_is_valid_stctl - check stctl field validity
938  * @scsw: pointer to scsw
939  *
940  * Return non-zero if the stctl field of the specified scsw is valid,
941  * regardless of whether it is a transport mode or command mode scsw.
942  * Return zero if the field does not contain a valid value.
943  */
scsw_is_valid_stctl(union scsw * scsw)944 static inline int scsw_is_valid_stctl(union scsw *scsw)
945 {
946 	if (scsw_is_tm(scsw))
947 		return scsw_tm_is_valid_stctl(scsw);
948 	else
949 		return scsw_cmd_is_valid_stctl(scsw);
950 }
951 
952 /**
953  * scsw_cmd_is_solicited - check for solicited scsw
954  * @scsw: pointer to scsw
955  *
956  * Return non-zero if the command mode scsw indicates that the associated
957  * status condition is solicited, zero if it is unsolicited.
958  */
scsw_cmd_is_solicited(union scsw * scsw)959 static inline int scsw_cmd_is_solicited(union scsw *scsw)
960 {
961 	return (scsw->cmd.cc != 0) || (scsw->cmd.stctl !=
962 		(SCSW_STCTL_STATUS_PEND | SCSW_STCTL_ALERT_STATUS));
963 }
964 
965 /**
966  * scsw_tm_is_solicited - check for solicited scsw
967  * @scsw: pointer to scsw
968  *
969  * Return non-zero if the transport mode scsw indicates that the associated
970  * status condition is solicited, zero if it is unsolicited.
971  */
scsw_tm_is_solicited(union scsw * scsw)972 static inline int scsw_tm_is_solicited(union scsw *scsw)
973 {
974 	return (scsw->tm.cc != 0) || (scsw->tm.stctl !=
975 		(SCSW_STCTL_STATUS_PEND | SCSW_STCTL_ALERT_STATUS));
976 }
977 
978 /**
979  * scsw_is_solicited - check for solicited scsw
980  * @scsw: pointer to scsw
981  *
982  * Return non-zero if the transport or command mode scsw indicates that the
983  * associated status condition is solicited, zero if it is unsolicited.
984  */
scsw_is_solicited(union scsw * scsw)985 static inline int scsw_is_solicited(union scsw *scsw)
986 {
987 	if (scsw_is_tm(scsw))
988 		return scsw_tm_is_solicited(scsw);
989 	else
990 		return scsw_cmd_is_solicited(scsw);
991 }
992 
993 #endif /* _ASM_S390_SCSW_H_ */
994