2 * drivers/s390/cio/chsc.c
3 * S/390 common I/O routines -- channel subsystem call
6 * Copyright (C) 1999-2002 IBM Deutschland Entwicklung GmbH,
8 * Author(s): Ingo Adlung (adlung@de.ibm.com)
9 * Cornelia Huck (cohuck@de.ibm.com)
10 * Arnd Bergmann (arndb@de.ibm.com)
13 #include <linux/module.h>
14 #include <linux/config.h>
15 #include <linux/slab.h>
16 #include <linux/init.h>
17 #include <linux/device.h>
23 #include "cio_debug.h"
27 static struct channel_path *chps[NR_CHPIDS];
29 static void *sei_page;
31 static int new_channel_path(int chpid);
34 set_chp_logically_online(int chp, int onoff)
36 chps[chp]->state = onoff;
40 get_chp_status(int chp)
42 return (chps[chp] ? chps[chp]->state : -ENODEV);
46 chsc_validate_chpids(struct subchannel *sch)
50 for (chp = 0; chp <= 7; chp++) {
52 if (!get_chp_status(sch->schib.pmcw.chpid[chp]))
53 /* disable using this path */
59 chpid_is_actually_online(int chp)
63 state = get_chp_status(chp);
66 queue_work(slow_path_wq, &slow_path_work);
71 /* FIXME: this is _always_ called for every subchannel. shouldn't we
72 * process more than one at a time? */
74 chsc_get_sch_desc_irq(struct subchannel *sch, void *page)
79 struct chsc_header request;
81 u16 f_sch; /* first subchannel */
83 u16 l_sch; /* last subchannel */
85 struct chsc_header response;
89 u8 st : 3; /* subchannel type */
91 u8 unit_addr; /* unit address */
92 u16 devno; /* device number */
95 u16 sch; /* subchannel */
96 u8 chpid[8]; /* chpids 0-7 */
97 u16 fla[8]; /* full link addresses 0-7 */
102 ssd_area->request = (struct chsc_header) {
107 ssd_area->f_sch = sch->irq;
108 ssd_area->l_sch = sch->irq;
110 ccode = chsc(ssd_area);
112 pr_debug("chsc returned with ccode = %d\n", ccode);
113 return (ccode == 3) ? -ENODEV : -EBUSY;
116 switch (ssd_area->response.code) {
117 case 0x0001: /* everything ok */
120 CIO_CRW_EVENT(2, "Invalid command!\n");
123 CIO_CRW_EVENT(2, "Error in chsc request block!\n");
126 CIO_CRW_EVENT(2, "Model does not provide ssd\n");
129 CIO_CRW_EVENT(2, "Unknown CHSC response %d\n",
130 ssd_area->response.code);
135 * ssd_area->st stores the type of the detected
136 * subchannel, with the following definitions:
138 * 0: I/O subchannel: All fields have meaning
139 * 1: CHSC subchannel: Only sch_val, st and sch
141 * 2: Message subchannel: All fields except unit_addr
143 * 3: ADM subchannel: Only sch_val, st and sch
146 * Other types are currently undefined.
148 if (ssd_area->st > 3) { /* uhm, that looks strange... */
149 CIO_CRW_EVENT(0, "Strange subchannel type %d"
150 " for sch %04x\n", ssd_area->st, sch->irq);
152 * There may have been a new subchannel type defined in the
153 * time since this code was written; since we don't know which
154 * fields have meaning and what to do with it we just jump out
158 const char *type[4] = {"I/O", "chsc", "message", "ADM"};
159 CIO_CRW_EVENT(6, "ssd: sch %04x is %s subchannel\n",
160 sch->irq, type[ssd_area->st]);
162 sch->ssd_info.valid = 1;
163 sch->ssd_info.type = ssd_area->st;
166 if (ssd_area->st == 0 || ssd_area->st == 2) {
167 for (j = 0; j < 8; j++) {
168 if (!((0x80 >> j) & ssd_area->path_mask &
169 ssd_area->fla_valid_mask))
171 sch->ssd_info.chpid[j] = ssd_area->chpid[j];
172 sch->ssd_info.fla[j] = ssd_area->fla[j];
179 css_get_ssd_info(struct subchannel *sch)
184 page = (void *)get_zeroed_page(GFP_KERNEL | GFP_DMA);
187 spin_lock_irq(&sch->lock);
188 ret = chsc_get_sch_desc_irq(sch, page);
190 static int cio_chsc_err_msg;
192 if (!cio_chsc_err_msg) {
194 "chsc_get_sch_descriptions:"
195 " Error %d while doing chsc; "
196 "processing some machine checks may "
198 cio_chsc_err_msg = 1;
201 spin_unlock_irq(&sch->lock);
202 free_page((unsigned long)page);
205 /* Allocate channel path structures, if needed. */
206 for (j = 0; j < 8; j++) {
207 chpid = sch->ssd_info.chpid[j];
208 if (chpid && (get_chp_status(chpid) < 0))
209 new_channel_path(chpid);
216 s390_subchannel_remove_chpid(struct device *dev, void *data)
220 struct subchannel *sch;
224 sch = to_subchannel(dev);
226 for (j = 0; j < 8; j++)
227 if (sch->schib.pmcw.chpid[j] == *chpid)
233 spin_lock(&sch->lock);
235 stsch(sch->irq, &schib);
238 memcpy(&sch->schib, &schib, sizeof(struct schib));
239 /* Check for single path devices. */
240 if (sch->schib.pmcw.pim == 0x80)
242 if (sch->vpm == mask)
245 if ((sch->schib.scsw.actl & (SCSW_ACTL_CLEAR_PEND |
246 SCSW_ACTL_HALT_PEND |
247 SCSW_ACTL_START_PEND |
248 SCSW_ACTL_RESUME_PEND)) &&
249 (sch->schib.pmcw.lpum == mask)) {
250 int cc = cio_cancel(sch);
260 if (sch->driver && sch->driver->termination)
261 sch->driver->termination(&sch->dev);
264 } else if ((sch->schib.scsw.actl & SCSW_ACTL_DEVACT) &&
265 (sch->schib.scsw.actl & SCSW_ACTL_SCHACT) &&
266 (sch->schib.pmcw.lpum == mask)) {
273 if (sch->driver && sch->driver->termination)
274 sch->driver->termination(&sch->dev);
278 /* trigger path verification. */
279 if (sch->driver && sch->driver->verify)
280 sch->driver->verify(&sch->dev);
282 spin_unlock(&sch->lock);
285 spin_unlock(&sch->lock);
287 if (css_enqueue_subchannel_slow(sch->irq)) {
288 css_clear_subchannel_slow_list();
295 s390_set_chpid_offline( __u8 chpid)
299 sprintf(dbf_txt, "chpr%x", chpid);
300 CIO_TRACE_EVENT(2, dbf_txt);
302 if (get_chp_status(chpid) <= 0)
305 bus_for_each_dev(&css_bus_type, NULL, &chpid,
306 s390_subchannel_remove_chpid);
308 if (need_rescan || css_slow_subchannels_exist())
309 queue_work(slow_path_wq, &slow_path_work);
313 s390_process_res_acc_sch(u8 chpid, __u16 fla, u32 fla_mask,
314 struct subchannel *sch)
321 for (chp = 0; chp <= 7; chp++)
323 * check if chpid is in information updated by ssd
325 if (sch->ssd_info.valid &&
326 sch->ssd_info.chpid[chp] == chpid &&
327 (sch->ssd_info.fla[chp] & fla_mask) == fla) {
336 * Do a stsch to update our subchannel structure with the
337 * new path information and eventually check for logically
340 ccode = stsch(sch->irq, &sch->schib);
348 s390_process_res_acc (u8 chpid, __u16 fla, u32 fla_mask)
350 struct subchannel *sch;
354 sprintf(dbf_txt, "accpr%x", chpid);
355 CIO_TRACE_EVENT( 2, dbf_txt);
357 sprintf(dbf_txt, "fla%x", fla);
358 CIO_TRACE_EVENT( 2, dbf_txt);
362 * I/O resources may have become accessible.
363 * Scan through all subchannels that may be concerned and
364 * do a validation on those.
365 * The more information we have (info), the less scanning
366 * will we have to do.
369 if (!get_chp_status(chpid))
370 return 0; /* no need to do the rest */
373 for (irq = 0; irq < __MAX_SUBCHANNELS; irq++) {
374 int chp_mask, old_lpm;
376 sch = get_subchannel_by_schid(irq);
381 * We don't know the device yet, but since a path
382 * may be available now to the device we'll have
383 * to do recognition again.
384 * Since we don't have any idea about which chpid
385 * that beast may be on we'll have to do a stsch
386 * on all devices, grr...
388 if (stsch(irq, &schib)) {
398 /* Put it on the slow path. */
399 ret = css_enqueue_subchannel_slow(irq);
401 css_clear_subchannel_slow_list();
408 spin_lock_irq(&sch->lock);
410 chp_mask = s390_process_res_acc_sch(chpid, fla, fla_mask, sch);
414 spin_unlock_irq(&sch->lock);
418 sch->lpm = ((sch->schib.pmcw.pim &
419 sch->schib.pmcw.pam &
421 | chp_mask) & sch->opm;
422 if (!old_lpm && sch->lpm)
423 device_trigger_reprobe(sch);
424 else if (sch->driver && sch->driver->verify)
425 sch->driver->verify(&sch->dev);
427 spin_unlock_irq(&sch->lock);
428 put_device(&sch->dev);
429 if (fla_mask == 0xffff)
436 __get_chpid_from_lir(void *data)
442 /* incident-node descriptor */
444 /* attached-node descriptor */
446 /* incident-specific information */
450 lir = (struct lir*) data;
452 /* NULL link incident record */
454 if (!(lir->indesc[0]&0xc0000000))
455 /* node descriptor not valid */
457 if (!(lir->indesc[0]&0x10000000))
458 /* don't handle device-type nodes - FIXME */
460 /* Byte 3 contains the chpid. Could also be CTCA, but we don't care */
462 return (u16) (lir->indesc[0]&0x000000ff);
466 chsc_process_crw(void)
470 struct chsc_header request;
474 struct chsc_header response;
477 u8 vf; /* validity flags */
478 u8 rs; /* reporting source */
479 u8 cc; /* content code */
480 u16 fla; /* full link address */
481 u16 rsid; /* reporting source id */
484 u32 ccdf[96]; /* content-code dependent field */
485 /* ccdf has to be big enough for a link-incident record */
491 * build the chsc request block for store event information
493 * This function is only called by the machine check handler thread,
494 * so we don't need locking for the sei_page.
498 CIO_TRACE_EVENT( 2, "prcss");
502 memset(sei_area, 0, sizeof(*sei_area));
504 sei_area->request = (struct chsc_header) {
509 ccode = chsc(sei_area);
513 switch (sei_area->response.code) {
514 /* for debug purposes, check for problems */
516 CIO_CRW_EVENT(4, "chsc_process_crw: event information "
517 "successfully stored\n");
518 break; /* everything ok */
521 "chsc_process_crw: invalid command!\n");
524 CIO_CRW_EVENT(2, "chsc_process_crw: error in chsc "
528 CIO_CRW_EVENT(2, "chsc_process_crw: no event "
529 "information stored\n");
532 CIO_CRW_EVENT(2, "chsc_process_crw: chsc response %d\n",
533 sei_area->response.code);
537 /* Check if we might have lost some information. */
538 if (sei_area->flags & 0x40)
539 CIO_CRW_EVENT(2, "chsc_process_crw: Event information "
540 "has been lost due to overflow!\n");
542 if (sei_area->rs != 4) {
543 CIO_CRW_EVENT(2, "chsc_process_crw: reporting source "
544 "(%04X) isn't a chpid!\n",
549 /* which kind of information was stored? */
550 switch (sei_area->cc) {
551 case 1: /* link incident*/
552 CIO_CRW_EVENT(4, "chsc_process_crw: "
553 "channel subsystem reports link incident,"
554 " reporting source is chpid %x\n",
556 chpid = __get_chpid_from_lir(sei_area->ccdf);
558 CIO_CRW_EVENT(4, "%s: Invalid LIR, skipping\n",
561 s390_set_chpid_offline(chpid);
564 case 2: /* i/o resource accessibiliy */
565 CIO_CRW_EVENT(4, "chsc_process_crw: "
566 "channel subsystem reports some I/O "
567 "devices may have become accessible\n");
568 pr_debug("Data received after sei: \n");
569 pr_debug("Validity flags: %x\n", sei_area->vf);
571 /* allocate a new channel path structure, if needed */
572 status = get_chp_status(sei_area->rsid);
574 new_channel_path(sei_area->rsid);
577 if ((sei_area->vf & 0x80) == 0) {
578 pr_debug("chpid: %x\n", sei_area->rsid);
579 ret = s390_process_res_acc(sei_area->rsid,
581 } else if ((sei_area->vf & 0xc0) == 0x80) {
582 pr_debug("chpid: %x link addr: %x\n",
583 sei_area->rsid, sei_area->fla);
584 ret = s390_process_res_acc(sei_area->rsid,
587 } else if ((sei_area->vf & 0xc0) == 0xc0) {
588 pr_debug("chpid: %x full link addr: %x\n",
589 sei_area->rsid, sei_area->fla);
590 ret = s390_process_res_acc(sei_area->rsid,
598 default: /* other stuff */
599 CIO_CRW_EVENT(4, "chsc_process_crw: event %d\n",
603 } while (sei_area->flags & 0x80);
610 struct subchannel *sch;
614 if (!get_chp_status(chpid))
615 return 0; /* no need to do the rest */
617 sprintf(dbf_txt, "cadd%x", chpid);
618 CIO_TRACE_EVENT(2, dbf_txt);
621 for (irq = 0; irq < __MAX_SUBCHANNELS; irq++) {
624 sch = get_subchannel_by_schid(irq);
628 if (stsch(irq, &schib)) {
638 /* Put it on the slow path. */
639 ret = css_enqueue_subchannel_slow(irq);
641 css_clear_subchannel_slow_list();
648 spin_lock(&sch->lock);
650 if (sch->schib.pmcw.chpid[i] == chpid) {
651 if (stsch(sch->irq, &sch->schib) != 0) {
653 spin_unlock(&sch->lock);
659 spin_unlock(&sch->lock);
662 sch->lpm = ((sch->schib.pmcw.pim &
663 sch->schib.pmcw.pam &
665 | 0x80 >> i) & sch->opm;
667 if (sch->driver && sch->driver->verify)
668 sch->driver->verify(&sch->dev);
670 spin_unlock(&sch->lock);
671 put_device(&sch->dev);
677 * Handling of crw machine checks with channel path source.
680 chp_process_crw(int chpid, int on)
683 /* Path has gone. We use the link incident routine.*/
684 s390_set_chpid_offline(chpid);
685 return 0; /* De-register is async anyway. */
688 * Path has come. Allocate a new channel path structure,
691 if (get_chp_status(chpid) < 0)
692 new_channel_path(chpid);
693 /* Avoid the extra overhead in process_rec_acc. */
694 return chp_add(chpid);
698 __check_for_io_and_kill(struct subchannel *sch, int index)
702 if (!device_is_online(sch))
703 /* cio could be doing I/O. */
705 cc = stsch(sch->irq, &sch->schib);
708 if (sch->schib.scsw.actl && sch->schib.pmcw.lpum == (0x80 >> index)) {
709 device_set_waiting(sch);
716 __s390_subchannel_vary_chpid(struct subchannel *sch, __u8 chpid, int on)
721 if (!sch->ssd_info.valid)
724 spin_lock_irqsave(&sch->lock, flags);
726 for (chp = 0; chp < 8; chp++) {
727 if (sch->ssd_info.chpid[chp] != chpid)
731 sch->opm |= (0x80 >> chp);
732 sch->lpm |= (0x80 >> chp);
734 device_trigger_reprobe(sch);
735 else if (sch->driver && sch->driver->verify)
736 sch->driver->verify(&sch->dev);
738 sch->opm &= ~(0x80 >> chp);
739 sch->lpm &= ~(0x80 >> chp);
741 * Give running I/O a grace period in which it
742 * can successfully terminate, even using the
743 * just varied off path. Then kill it.
745 if (!__check_for_io_and_kill(sch, chp) && !sch->lpm) {
746 if (css_enqueue_subchannel_slow(sch->irq)) {
747 css_clear_subchannel_slow_list();
750 } else if (sch->driver && sch->driver->verify)
751 sch->driver->verify(&sch->dev);
755 spin_unlock_irqrestore(&sch->lock, flags);
759 s390_subchannel_vary_chpid_off(struct device *dev, void *data)
761 struct subchannel *sch;
764 sch = to_subchannel(dev);
767 __s390_subchannel_vary_chpid(sch, *chpid, 0);
772 s390_subchannel_vary_chpid_on(struct device *dev, void *data)
774 struct subchannel *sch;
777 sch = to_subchannel(dev);
780 __s390_subchannel_vary_chpid(sch, *chpid, 1);
785 * Function: s390_vary_chpid
786 * Varies the specified chpid online or offline
789 s390_vary_chpid( __u8 chpid, int on)
792 int status, irq, ret;
793 struct subchannel *sch;
795 sprintf(dbf_text, on?"varyon%x":"varyoff%x", chpid);
796 CIO_TRACE_EVENT( 2, dbf_text);
798 status = get_chp_status(chpid);
800 printk(KERN_ERR "Can't vary unknown chpid %02X\n", chpid);
804 if (!on && !status) {
805 printk(KERN_ERR "chpid %x is already offline\n", chpid);
809 set_chp_logically_online(chpid, on);
812 * Redo PathVerification on the devices the chpid connects to
815 bus_for_each_dev(&css_bus_type, NULL, &chpid, on ?
816 s390_subchannel_vary_chpid_on :
817 s390_subchannel_vary_chpid_off);
820 /* Scan for new devices on varied on path. */
821 for (irq = 0; irq < __MAX_SUBCHANNELS; irq++) {
826 sch = get_subchannel_by_schid(irq);
828 put_device(&sch->dev);
831 if (stsch(irq, &schib))
834 /* Put it on the slow path. */
835 ret = css_enqueue_subchannel_slow(irq);
837 css_clear_subchannel_slow_list();
842 if (need_rescan || css_slow_subchannels_exist())
843 queue_work(slow_path_wq, &slow_path_work);
848 * Files for the channel path entries.
851 chp_status_show(struct device *dev, struct device_attribute *attr, char *buf)
853 struct channel_path *chp = container_of(dev, struct channel_path, dev);
857 return (get_chp_status(chp->id) ? sprintf(buf, "online\n") :
858 sprintf(buf, "offline\n"));
862 chp_status_write(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
864 struct channel_path *cp = container_of(dev, struct channel_path, dev);
869 num_args = sscanf(buf, "%5s", cmd);
873 if (!strnicmp(cmd, "on", 2))
874 error = s390_vary_chpid(cp->id, 1);
875 else if (!strnicmp(cmd, "off", 3))
876 error = s390_vary_chpid(cp->id, 0);
880 return error < 0 ? error : count;
884 static DEVICE_ATTR(status, 0644, chp_status_show, chp_status_write);
887 chp_type_show(struct device *dev, struct device_attribute *attr, char *buf)
889 struct channel_path *chp = container_of(dev, struct channel_path, dev);
893 return sprintf(buf, "%x\n", chp->desc.desc);
896 static DEVICE_ATTR(type, 0444, chp_type_show, NULL);
898 static struct attribute * chp_attrs[] = {
899 &dev_attr_status.attr,
904 static struct attribute_group chp_attr_group = {
909 chp_release(struct device *dev)
911 struct channel_path *cp;
913 cp = container_of(dev, struct channel_path, dev);
918 chsc_determine_channel_path_description(int chpid,
919 struct channel_path_desc *desc)
924 struct chsc_header request;
930 struct chsc_header response;
932 struct channel_path_desc desc;
935 scpd_area = (void *)get_zeroed_page(GFP_KERNEL | GFP_DMA);
939 scpd_area->request = (struct chsc_header) {
944 scpd_area->first_chpid = chpid;
945 scpd_area->last_chpid = chpid;
947 ccode = chsc(scpd_area);
949 ret = (ccode == 3) ? -ENODEV : -EBUSY;
953 switch (scpd_area->response.code) {
954 case 0x0001: /* Success. */
955 memcpy(desc, &scpd_area->desc,
956 sizeof(struct channel_path_desc));
959 case 0x0003: /* Invalid block. */
960 case 0x0007: /* Invalid format. */
961 case 0x0008: /* Other invalid block. */
962 CIO_CRW_EVENT(2, "Error in chsc request block!\n");
965 case 0x0004: /* Command not provided in model. */
966 CIO_CRW_EVENT(2, "Model does not provide scpd\n");
970 CIO_CRW_EVENT(2, "Unknown CHSC response %d\n",
971 scpd_area->response.code);
975 free_page((unsigned long)scpd_area);
980 * Entries for chpids on the system bus.
981 * This replaces /proc/chpids.
984 new_channel_path(int chpid)
986 struct channel_path *chp;
989 chp = kmalloc(sizeof(struct channel_path), GFP_KERNEL);
992 memset(chp, 0, sizeof(struct channel_path));
994 /* fill in status, etc. */
997 chp->dev = (struct device) {
998 .parent = &css_bus_device,
999 .release = chp_release,
1001 snprintf(chp->dev.bus_id, BUS_ID_SIZE, "chp0.%x", chpid);
1003 /* Obtain channel path description and fill it in. */
1004 ret = chsc_determine_channel_path_description(chpid, &chp->desc);
1008 /* make it known to the system */
1009 ret = device_register(&chp->dev);
1011 printk(KERN_WARNING "%s: could not register %02x\n",
1015 ret = sysfs_create_group(&chp->dev.kobj, &chp_attr_group);
1017 device_unregister(&chp->dev);
1028 chsc_get_chp_desc(struct subchannel *sch, int chp_no)
1030 struct channel_path *chp;
1031 struct channel_path_desc *desc;
1033 chp = chps[sch->schib.pmcw.chpid[chp_no]];
1036 desc = kmalloc(sizeof(struct channel_path_desc), GFP_KERNEL);
1039 memcpy(desc, &chp->desc, sizeof(struct channel_path_desc));
1045 chsc_alloc_sei_area(void)
1047 sei_page = (void *)get_zeroed_page(GFP_KERNEL | GFP_DMA);
1049 printk(KERN_WARNING"Can't allocate page for processing of " \
1050 "chsc machine checks!\n");
1051 return (sei_page ? 0 : -ENOMEM);
1054 subsys_initcall(chsc_alloc_sei_area);
1056 struct css_general_char css_general_characteristics;
1057 struct css_chsc_char css_chsc_characteristics;
1060 chsc_determine_css_characteristics(void)
1064 struct chsc_header request;
1068 struct chsc_header response;
1070 u32 general_char[510];
1074 scsc_area = (void *)get_zeroed_page(GFP_KERNEL | GFP_DMA);
1076 printk(KERN_WARNING"cio: Was not able to determine available" \
1077 "CHSCs due to no memory.\n");
1081 scsc_area->request = (struct chsc_header) {
1086 result = chsc(scsc_area);
1088 printk(KERN_WARNING"cio: Was not able to determine " \
1089 "available CHSCs, cc=%i.\n", result);
1094 if (scsc_area->response.code != 1) {
1095 printk(KERN_WARNING"cio: Was not able to determine " \
1096 "available CHSCs.\n");
1100 memcpy(&css_general_characteristics, scsc_area->general_char,
1101 sizeof(css_general_characteristics));
1102 memcpy(&css_chsc_characteristics, scsc_area->chsc_char,
1103 sizeof(css_chsc_characteristics));
1105 free_page ((unsigned long) scsc_area);
1109 EXPORT_SYMBOL_GPL(css_general_characteristics);
1110 EXPORT_SYMBOL_GPL(css_chsc_characteristics);