1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef S390_DEVICE_H
3 #define S390_DEVICE_H
4
5 #include <asm/ccwdev.h>
6 #include <linux/atomic.h>
7 #include <linux/timer.h>
8 #include <linux/wait.h>
9 #include <linux/notifier.h>
10 #include <linux/kernel_stat.h>
11 #include "io_sch.h"
12
13 /*
14 * states of the device statemachine
15 */
16 enum dev_state {
17 DEV_STATE_NOT_OPER,
18 DEV_STATE_SENSE_ID,
19 DEV_STATE_OFFLINE,
20 DEV_STATE_VERIFY,
21 DEV_STATE_ONLINE,
22 DEV_STATE_W4SENSE,
23 DEV_STATE_DISBAND_PGID,
24 DEV_STATE_BOXED,
25 /* states to wait for i/o completion before doing something */
26 DEV_STATE_TIMEOUT_KILL,
27 DEV_STATE_QUIESCE,
28 /* special states for devices gone not operational */
29 DEV_STATE_DISCONNECTED,
30 DEV_STATE_DISCONNECTED_SENSE_ID,
31 DEV_STATE_CMFCHANGE,
32 DEV_STATE_CMFUPDATE,
33 DEV_STATE_STEAL_LOCK,
34 /* last element! */
35 NR_DEV_STATES
36 };
37
38 /*
39 * asynchronous events of the device statemachine
40 */
41 enum dev_event {
42 DEV_EVENT_NOTOPER,
43 DEV_EVENT_INTERRUPT,
44 DEV_EVENT_TIMEOUT,
45 DEV_EVENT_VERIFY,
46 /* last element! */
47 NR_DEV_EVENTS
48 };
49
50 struct ccw_device;
51
52 /*
53 * action called through jumptable
54 */
55 typedef void (fsm_func_t)(struct ccw_device *, enum dev_event);
56 extern fsm_func_t *dev_jumptable[NR_DEV_STATES][NR_DEV_EVENTS];
57
58 static inline void
dev_fsm_event(struct ccw_device * cdev,enum dev_event dev_event)59 dev_fsm_event(struct ccw_device *cdev, enum dev_event dev_event)
60 {
61 int state = cdev->private->state;
62
63 if (dev_event == DEV_EVENT_INTERRUPT) {
64 if (state == DEV_STATE_ONLINE)
65 inc_irq_stat(cdev->private->int_class);
66 else if (state != DEV_STATE_CMFCHANGE &&
67 state != DEV_STATE_CMFUPDATE)
68 inc_irq_stat(IRQIO_CIO);
69 }
70 dev_jumptable[state][dev_event](cdev, dev_event);
71 }
72
73 /*
74 * Delivers 1 if the device state is final.
75 */
76 static inline int
dev_fsm_final_state(struct ccw_device * cdev)77 dev_fsm_final_state(struct ccw_device *cdev)
78 {
79 return (cdev->private->state == DEV_STATE_NOT_OPER ||
80 cdev->private->state == DEV_STATE_OFFLINE ||
81 cdev->private->state == DEV_STATE_ONLINE ||
82 cdev->private->state == DEV_STATE_BOXED);
83 }
84
85 int __init io_subchannel_init(void);
86
87 void io_subchannel_recog_done(struct ccw_device *cdev);
88 void io_subchannel_init_config(struct subchannel *sch);
89
90 int ccw_device_cancel_halt_clear(struct ccw_device *);
91
92 int ccw_device_is_orphan(struct ccw_device *);
93
94 void ccw_device_recognition(struct ccw_device *);
95 int ccw_device_online(struct ccw_device *);
96 int ccw_device_offline(struct ccw_device *);
97 void ccw_device_update_sense_data(struct ccw_device *);
98 int ccw_device_test_sense_data(struct ccw_device *);
99 void ccw_device_schedule_sch_unregister(struct ccw_device *);
100 int ccw_purge_blacklisted(void);
101 void ccw_device_sched_todo(struct ccw_device *cdev, enum cdev_todo todo);
102 struct ccw_device *get_ccwdev_by_dev_id(struct ccw_dev_id *dev_id);
103
104 /* Function prototypes for device status and basic sense stuff. */
105 void ccw_device_accumulate_irb(struct ccw_device *, struct irb *);
106 void ccw_device_accumulate_basic_sense(struct ccw_device *, struct irb *);
107 int ccw_device_accumulate_and_sense(struct ccw_device *, struct irb *);
108 int ccw_device_do_sense(struct ccw_device *, struct irb *);
109
110 /* Function prototype for internal request handling. */
111 int lpm_adjust(int lpm, int mask);
112 void ccw_request_start(struct ccw_device *);
113 int ccw_request_cancel(struct ccw_device *cdev);
114 void ccw_request_handler(struct ccw_device *cdev);
115 void ccw_request_timeout(struct ccw_device *cdev);
116 void ccw_request_notoper(struct ccw_device *cdev);
117
118 /* Function prototypes for sense id stuff. */
119 void ccw_device_sense_id_start(struct ccw_device *);
120 void ccw_device_sense_id_done(struct ccw_device *, int);
121
122 /* Function prototypes for path grouping stuff. */
123 void ccw_device_verify_start(struct ccw_device *);
124 void ccw_device_verify_done(struct ccw_device *, int);
125
126 void ccw_device_disband_start(struct ccw_device *);
127 void ccw_device_disband_done(struct ccw_device *, int);
128
129 int ccw_device_stlck(struct ccw_device *);
130
131 /* Helper function for machine check handling. */
132 void ccw_device_trigger_reprobe(struct ccw_device *);
133 void ccw_device_kill_io(struct ccw_device *);
134 int ccw_device_notify(struct ccw_device *, int);
135 void ccw_device_set_disconnected(struct ccw_device *cdev);
136 void ccw_device_set_notoper(struct ccw_device *cdev);
137
138 void ccw_device_timeout(struct timer_list *t);
139 void ccw_device_set_timeout(struct ccw_device *, int);
140 void ccw_device_schedule_recovery(void);
141
142 /* Channel measurement facility related */
143 void retry_set_schib(struct ccw_device *cdev);
144 void cmf_retry_copy_block(struct ccw_device *);
145 int cmf_reenable(struct ccw_device *);
146 void cmf_reactivate(void);
147 int ccw_set_cmf(struct ccw_device *cdev, int enable);
148 extern struct device_attribute dev_attr_cmb_enable;
149 #endif
150