1 // SPDX-License-Identifier: GPL-2.0
3 * Driver for s390 eadm subchannels
5 * Copyright IBM Corp. 2012
6 * Author(s): Sebastian Ott <sebott@linux.vnet.ibm.com>
9 #include <linux/kernel_stat.h>
10 #include <linux/completion.h>
11 #include <linux/workqueue.h>
12 #include <linux/spinlock.h>
13 #include <linux/device.h>
14 #include <linux/module.h>
15 #include <linux/timer.h>
16 #include <linux/slab.h>
17 #include <linux/list.h>
19 #include <asm/css_chars.h>
20 #include <asm/debug.h>
32 MODULE_DESCRIPTION("driver for s390 eadm subchannels");
33 MODULE_LICENSE("GPL");
35 #define EADM_TIMEOUT (7 * HZ)
36 static DEFINE_SPINLOCK(list_lock
);
37 static LIST_HEAD(eadm_list
);
39 static debug_info_t
*eadm_debug
;
41 #define EADM_LOG(imp, txt) do { \
42 debug_text_event(eadm_debug, imp, txt); \
45 static void EADM_LOG_HEX(int level
, void *data
, int length
)
47 debug_event(eadm_debug
, level
, data
, length
);
50 static void orb_init(union orb
*orb
)
52 memset(orb
, 0, sizeof(union orb
));
53 orb
->eadm
.compat1
= 1;
54 orb
->eadm
.compat2
= 1;
59 static int eadm_subchannel_start(struct subchannel
*sch
, struct aob
*aob
)
61 union orb
*orb
= &get_eadm_private(sch
)->orb
;
65 orb
->eadm
.aob
= (u32
)__pa(aob
);
66 orb
->eadm
.intparm
= (u32
)(addr_t
)sch
;
67 orb
->eadm
.key
= PAGE_DEFAULT_KEY
>> 4;
70 EADM_LOG_HEX(6, &sch
->schid
, sizeof(sch
->schid
));
72 cc
= ssch(sch
->schid
, orb
);
75 sch
->schib
.scsw
.eadm
.actl
|= SCSW_ACTL_START_PEND
;
77 case 1: /* status pending */
80 case 3: /* not operational */
86 static int eadm_subchannel_clear(struct subchannel
*sch
)
90 cc
= csch(sch
->schid
);
94 sch
->schib
.scsw
.eadm
.actl
|= SCSW_ACTL_CLEAR_PEND
;
98 static void eadm_subchannel_timeout(struct timer_list
*t
)
100 struct eadm_private
*private = from_timer(private, t
, timer
);
101 struct subchannel
*sch
= private->sch
;
103 spin_lock_irq(sch
->lock
);
104 EADM_LOG(1, "timeout");
105 EADM_LOG_HEX(1, &sch
->schid
, sizeof(sch
->schid
));
106 if (eadm_subchannel_clear(sch
))
107 EADM_LOG(0, "clear failed");
108 spin_unlock_irq(sch
->lock
);
111 static void eadm_subchannel_set_timeout(struct subchannel
*sch
, int expires
)
113 struct eadm_private
*private = get_eadm_private(sch
);
116 del_timer(&private->timer
);
119 if (timer_pending(&private->timer
)) {
120 if (mod_timer(&private->timer
, jiffies
+ expires
))
123 private->timer
.expires
= jiffies
+ expires
;
124 add_timer(&private->timer
);
127 static void eadm_subchannel_irq(struct subchannel
*sch
)
129 struct eadm_private
*private = get_eadm_private(sch
);
130 struct eadm_scsw
*scsw
= &sch
->schib
.scsw
.eadm
;
131 struct irb
*irb
= this_cpu_ptr(&cio_irb
);
132 blk_status_t error
= BLK_STS_OK
;
135 EADM_LOG_HEX(6, irb
, sizeof(*irb
));
137 inc_irq_stat(IRQIO_ADM
);
139 if ((scsw
->stctl
& (SCSW_STCTL_ALERT_STATUS
| SCSW_STCTL_STATUS_PEND
))
140 && scsw
->eswf
== 1 && irb
->esw
.eadm
.erw
.r
)
141 error
= BLK_STS_IOERR
;
143 if (scsw
->fctl
& SCSW_FCTL_CLEAR_FUNC
)
144 error
= BLK_STS_TIMEOUT
;
146 eadm_subchannel_set_timeout(sch
, 0);
148 if (private->state
!= EADM_BUSY
) {
149 EADM_LOG(1, "irq unsol");
150 EADM_LOG_HEX(1, irb
, sizeof(*irb
));
151 private->state
= EADM_NOT_OPER
;
152 css_sched_sch_todo(sch
, SCH_TODO_EVAL
);
155 scm_irq_handler((struct aob
*)(unsigned long)scsw
->aob
, error
);
156 private->state
= EADM_IDLE
;
158 if (private->completion
)
159 complete(private->completion
);
162 static struct subchannel
*eadm_get_idle_sch(void)
164 struct eadm_private
*private;
165 struct subchannel
*sch
;
168 spin_lock_irqsave(&list_lock
, flags
);
169 list_for_each_entry(private, &eadm_list
, head
) {
171 spin_lock(sch
->lock
);
172 if (private->state
== EADM_IDLE
) {
173 private->state
= EADM_BUSY
;
174 list_move_tail(&private->head
, &eadm_list
);
175 spin_unlock(sch
->lock
);
176 spin_unlock_irqrestore(&list_lock
, flags
);
180 spin_unlock(sch
->lock
);
182 spin_unlock_irqrestore(&list_lock
, flags
);
187 int eadm_start_aob(struct aob
*aob
)
189 struct eadm_private
*private;
190 struct subchannel
*sch
;
194 sch
= eadm_get_idle_sch();
198 spin_lock_irqsave(sch
->lock
, flags
);
199 eadm_subchannel_set_timeout(sch
, EADM_TIMEOUT
);
200 ret
= eadm_subchannel_start(sch
, aob
);
204 /* Handle start subchannel failure. */
205 eadm_subchannel_set_timeout(sch
, 0);
206 private = get_eadm_private(sch
);
207 private->state
= EADM_NOT_OPER
;
208 css_sched_sch_todo(sch
, SCH_TODO_EVAL
);
211 spin_unlock_irqrestore(sch
->lock
, flags
);
215 EXPORT_SYMBOL_GPL(eadm_start_aob
);
217 static int eadm_subchannel_probe(struct subchannel
*sch
)
219 struct eadm_private
*private;
222 private = kzalloc(sizeof(*private), GFP_KERNEL
| GFP_DMA
);
226 INIT_LIST_HEAD(&private->head
);
227 timer_setup(&private->timer
, eadm_subchannel_timeout
, 0);
229 spin_lock_irq(sch
->lock
);
230 set_eadm_private(sch
, private);
231 private->state
= EADM_IDLE
;
233 sch
->isc
= EADM_SCH_ISC
;
234 ret
= cio_enable_subchannel(sch
, (u32
)(unsigned long)sch
);
236 set_eadm_private(sch
, NULL
);
237 spin_unlock_irq(sch
->lock
);
241 spin_unlock_irq(sch
->lock
);
243 spin_lock_irq(&list_lock
);
244 list_add(&private->head
, &eadm_list
);
245 spin_unlock_irq(&list_lock
);
247 if (dev_get_uevent_suppress(&sch
->dev
)) {
248 dev_set_uevent_suppress(&sch
->dev
, 0);
249 kobject_uevent(&sch
->dev
.kobj
, KOBJ_ADD
);
255 static void eadm_quiesce(struct subchannel
*sch
)
257 struct eadm_private
*private = get_eadm_private(sch
);
258 DECLARE_COMPLETION_ONSTACK(completion
);
261 spin_lock_irq(sch
->lock
);
262 if (private->state
!= EADM_BUSY
)
265 if (eadm_subchannel_clear(sch
))
268 private->completion
= &completion
;
269 spin_unlock_irq(sch
->lock
);
271 wait_for_completion_io(&completion
);
273 spin_lock_irq(sch
->lock
);
274 private->completion
= NULL
;
277 eadm_subchannel_set_timeout(sch
, 0);
279 ret
= cio_disable_subchannel(sch
);
280 } while (ret
== -EBUSY
);
282 spin_unlock_irq(sch
->lock
);
285 static int eadm_subchannel_remove(struct subchannel
*sch
)
287 struct eadm_private
*private = get_eadm_private(sch
);
289 spin_lock_irq(&list_lock
);
290 list_del(&private->head
);
291 spin_unlock_irq(&list_lock
);
295 spin_lock_irq(sch
->lock
);
296 set_eadm_private(sch
, NULL
);
297 spin_unlock_irq(sch
->lock
);
304 static void eadm_subchannel_shutdown(struct subchannel
*sch
)
309 static int eadm_subchannel_freeze(struct subchannel
*sch
)
311 return cio_disable_subchannel(sch
);
314 static int eadm_subchannel_restore(struct subchannel
*sch
)
316 return cio_enable_subchannel(sch
, (u32
)(unsigned long)sch
);
320 * eadm_subchannel_sch_event - process subchannel event
322 * @process: non-zero if function is called in process context
324 * An unspecified event occurred for this subchannel. Adjust data according
325 * to the current operational state of the subchannel. Return zero when the
326 * event has been handled sufficiently or -EAGAIN when this function should
327 * be called again in process context.
329 static int eadm_subchannel_sch_event(struct subchannel
*sch
, int process
)
331 struct eadm_private
*private;
334 spin_lock_irqsave(sch
->lock
, flags
);
335 if (!device_is_registered(&sch
->dev
))
338 if (work_pending(&sch
->todo_work
))
341 if (cio_update_schib(sch
)) {
342 css_sched_sch_todo(sch
, SCH_TODO_UNREG
);
345 private = get_eadm_private(sch
);
346 if (private->state
== EADM_NOT_OPER
)
347 private->state
= EADM_IDLE
;
350 spin_unlock_irqrestore(sch
->lock
, flags
);
355 static struct css_device_id eadm_subchannel_ids
[] = {
356 { .match_flags
= 0x1, .type
= SUBCHANNEL_TYPE_ADM
, },
357 { /* end of list */ },
359 MODULE_DEVICE_TABLE(css
, eadm_subchannel_ids
);
361 static struct css_driver eadm_subchannel_driver
= {
363 .name
= "eadm_subchannel",
364 .owner
= THIS_MODULE
,
366 .subchannel_type
= eadm_subchannel_ids
,
367 .irq
= eadm_subchannel_irq
,
368 .probe
= eadm_subchannel_probe
,
369 .remove
= eadm_subchannel_remove
,
370 .shutdown
= eadm_subchannel_shutdown
,
371 .sch_event
= eadm_subchannel_sch_event
,
372 .freeze
= eadm_subchannel_freeze
,
373 .thaw
= eadm_subchannel_restore
,
374 .restore
= eadm_subchannel_restore
,
377 static int __init
eadm_sch_init(void)
381 if (!css_general_characteristics
.eadm
)
384 eadm_debug
= debug_register("eadm_log", 16, 1, 16);
388 debug_register_view(eadm_debug
, &debug_hex_ascii_view
);
389 debug_set_level(eadm_debug
, 2);
391 isc_register(EADM_SCH_ISC
);
392 ret
= css_driver_register(&eadm_subchannel_driver
);
399 isc_unregister(EADM_SCH_ISC
);
400 debug_unregister(eadm_debug
);
404 static void __exit
eadm_sch_exit(void)
406 css_driver_unregister(&eadm_subchannel_driver
);
407 isc_unregister(EADM_SCH_ISC
);
408 debug_unregister(eadm_debug
);
410 module_init(eadm_sch_init
);
411 module_exit(eadm_sch_exit
);