Home | History | Annotate | Line # | Download | only in pic
intr.c revision 1.32
      1  1.32       rin /*	$NetBSD: intr.c,v 1.32 2021/03/22 01:36:10 rin Exp $ */
      2   1.2   garbled 
      3   1.2   garbled /*-
      4   1.2   garbled  * Copyright (c) 2007 Michael Lorenz
      5   1.2   garbled  * All rights reserved.
      6   1.2   garbled  *
      7   1.2   garbled  * Redistribution and use in source and binary forms, with or without
      8   1.2   garbled  * modification, are permitted provided that the following conditions
      9   1.2   garbled  * are met:
     10   1.2   garbled  * 1. Redistributions of source code must retain the above copyright
     11   1.2   garbled  *    notice, this list of conditions and the following disclaimer.
     12   1.2   garbled  * 2. Redistributions in binary form must reproduce the above copyright
     13   1.2   garbled  *    notice, this list of conditions and the following disclaimer in the
     14   1.2   garbled  *    documentation and/or other materials provided with the distribution.
     15   1.2   garbled  *
     16   1.2   garbled  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     17   1.2   garbled  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     18   1.2   garbled  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     19   1.2   garbled  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     20   1.2   garbled  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     21   1.2   garbled  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     22   1.2   garbled  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     23   1.2   garbled  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     24   1.2   garbled  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     25   1.2   garbled  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     26   1.2   garbled  * POSSIBILITY OF SUCH DAMAGE.
     27   1.2   garbled  */
     28   1.2   garbled 
     29  1.28       rin #define __INTR_PRIVATE
     30  1.28       rin 
     31   1.2   garbled #include <sys/cdefs.h>
     32  1.32       rin __KERNEL_RCSID(0, "$NetBSD: intr.c,v 1.32 2021/03/22 01:36:10 rin Exp $");
     33   1.2   garbled 
     34  1.28       rin #ifdef _KERNEL_OPT
     35  1.16      matt #include "opt_interrupt.h"
     36   1.2   garbled #include "opt_multiprocessor.h"
     37  1.16      matt #include "opt_pic.h"
     38  1.29       rin #include "opt_ppcarch.h"
     39  1.28       rin #endif
     40  1.12  macallan 
     41   1.2   garbled #include <sys/param.h>
     42  1.16      matt #include <sys/cpu.h>
     43  1.16      matt #include <sys/kernel.h>
     44  1.20      matt #include <sys/kmem.h>
     45  1.25    nonaka #include <sys/interrupt.h>
     46   1.2   garbled 
     47  1.16      matt #include <powerpc/psl.h>
     48  1.16      matt #include <powerpc/pic/picvar.h>
     49  1.16      matt 
     50   1.2   garbled #if defined(PIC_I8259) || defined (PIC_PREPIVR)
     51   1.2   garbled #include <machine/isa_machdep.h>
     52   1.2   garbled #endif
     53   1.2   garbled 
     54   1.2   garbled #ifdef MULTIPROCESSOR
     55  1.16      matt #include <powerpc/pic/ipivar.h>
     56   1.2   garbled #endif
     57   1.2   garbled 
     58  1.12  macallan #ifdef __HAVE_FAST_SOFTINTS
     59  1.12  macallan #include <powerpc/softint.h>
     60  1.12  macallan #endif
     61  1.12  macallan 
     62   1.2   garbled #define MAX_PICS	8	/* 8 PICs ought to be enough for everyone */
     63   1.2   garbled 
     64  1.15      matt #define	PIC_VIRQ_LEGAL_P(x)	((u_int)(x) < NVIRQ)
     65   1.2   garbled 
     66  1.27       rin #if defined(PPC_IBM4XX) && !defined(PPC_IBM440)
     67  1.27       rin /* eieio is implemented as sync */
     68  1.27       rin #define REORDER_PROTECT() __asm volatile("sync")
     69  1.27       rin #else
     70  1.27       rin #define REORDER_PROTECT() __asm volatile("sync; eieio")
     71  1.27       rin #endif
     72  1.27       rin 
     73   1.2   garbled struct pic_ops *pics[MAX_PICS];
     74   1.2   garbled int num_pics = 0;
     75   1.2   garbled int max_base = 0;
     76  1.15      matt uint8_t	virq_map[NIRQ];
     77  1.15      matt imask_t virq_mask = HWIRQ_MASK;
     78  1.30       rin static imask_t imask[NIPL];
     79   1.2   garbled int	primary_pic = 0;
     80   1.2   garbled 
     81   1.2   garbled static int	fakeintr(void *);
     82  1.15      matt static int	mapirq(int);
     83   1.2   garbled static void	intr_calculatemasks(void);
     84  1.15      matt static struct pic_ops *find_pic_by_hwirq(int);
     85   1.2   garbled 
     86   1.2   garbled static struct intr_source intrsources[NVIRQ];
     87   1.2   garbled 
     88   1.2   garbled void
     89   1.2   garbled pic_init(void)
     90   1.2   garbled {
     91  1.15      matt 	/* everything is in bss, no reason to zero it. */
     92   1.2   garbled }
     93   1.2   garbled 
     94   1.2   garbled int
     95   1.2   garbled pic_add(struct pic_ops *pic)
     96   1.2   garbled {
     97   1.2   garbled 
     98   1.2   garbled 	if (num_pics >= MAX_PICS)
     99   1.2   garbled 		return -1;
    100   1.2   garbled 
    101   1.2   garbled 	pics[num_pics] = pic;
    102   1.2   garbled 	pic->pic_intrbase = max_base;
    103   1.2   garbled 	max_base += pic->pic_numintrs;
    104   1.2   garbled 	num_pics++;
    105   1.7  kiyohara 
    106   1.2   garbled 	return pic->pic_intrbase;
    107   1.2   garbled }
    108   1.2   garbled 
    109   1.2   garbled void
    110   1.2   garbled pic_finish_setup(void)
    111   1.2   garbled {
    112  1.15      matt 	for (size_t i = 0; i < num_pics; i++) {
    113  1.15      matt 		struct pic_ops * const pic = pics[i];
    114   1.2   garbled 		if (pic->pic_finish_setup != NULL)
    115   1.2   garbled 			pic->pic_finish_setup(pic);
    116   1.2   garbled 	}
    117   1.2   garbled }
    118   1.2   garbled 
    119   1.2   garbled static struct pic_ops *
    120  1.15      matt find_pic_by_hwirq(int hwirq)
    121   1.2   garbled {
    122  1.14      matt 	for (u_int base = 0; base < num_pics; base++) {
    123  1.14      matt 		struct pic_ops * const pic = pics[base];
    124  1.15      matt 		if (pic->pic_intrbase <= hwirq
    125  1.15      matt 		    && hwirq < pic->pic_intrbase + pic->pic_numintrs) {
    126  1.14      matt 			return pic;
    127   1.2   garbled 		}
    128   1.2   garbled 	}
    129   1.2   garbled 	return NULL;
    130   1.2   garbled }
    131   1.2   garbled 
    132   1.2   garbled static int
    133   1.2   garbled fakeintr(void *arg)
    134   1.2   garbled {
    135   1.2   garbled 
    136   1.2   garbled 	return 0;
    137   1.2   garbled }
    138   1.2   garbled 
    139   1.2   garbled /*
    140   1.2   garbled  * Register an interrupt handler.
    141   1.2   garbled  */
    142   1.2   garbled void *
    143  1.14      matt intr_establish(int hwirq, int type, int ipl, int (*ih_fun)(void *),
    144   1.2   garbled     void *ih_arg)
    145   1.2   garbled {
    146  1.25    nonaka 	return intr_establish_xname(hwirq, type, ipl, ih_fun, ih_arg, NULL);
    147  1.25    nonaka }
    148  1.25    nonaka 
    149  1.25    nonaka void *
    150  1.25    nonaka intr_establish_xname(int hwirq, int type, int ipl, int (*ih_fun)(void *),
    151  1.25    nonaka     void *ih_arg, const char *xname)
    152  1.25    nonaka {
    153   1.2   garbled 	struct intrhand **p, *q, *ih;
    154   1.2   garbled 	struct pic_ops *pic;
    155   1.2   garbled 	static struct intrhand fakehand;
    156  1.15      matt 	int maxipl = ipl;
    157   1.2   garbled 
    158  1.14      matt 	if (maxipl == IPL_NONE)
    159  1.14      matt 		maxipl = IPL_HIGH;
    160   1.2   garbled 
    161   1.2   garbled 	if (hwirq >= max_base) {
    162   1.2   garbled 		panic("%s: bogus IRQ %d, max is %d", __func__, hwirq,
    163   1.2   garbled 		    max_base - 1);
    164   1.2   garbled 	}
    165   1.2   garbled 
    166  1.15      matt 	pic = find_pic_by_hwirq(hwirq);
    167   1.2   garbled 	if (pic == NULL) {
    168   1.2   garbled 		panic("%s: cannot find a pic for IRQ %d", __func__, hwirq);
    169   1.2   garbled 	}
    170   1.2   garbled 
    171  1.15      matt 	const int virq = mapirq(hwirq);
    172   1.2   garbled 
    173   1.2   garbled 	/* no point in sleeping unless someone can free memory. */
    174  1.20      matt 	ih = kmem_intr_alloc(sizeof(*ih), cold ? KM_NOSLEEP : KM_SLEEP);
    175   1.2   garbled 	if (ih == NULL)
    176  1.20      matt 		panic("intr_establish: can't allocate handler info");
    177   1.2   garbled 
    178  1.15      matt 	if (!PIC_VIRQ_LEGAL_P(virq) || type == IST_NONE)
    179  1.15      matt 		panic("intr_establish: bogus irq (%d) or type (%d)",
    180  1.15      matt 		    hwirq, type);
    181   1.2   garbled 
    182  1.15      matt 	struct intr_source * const is = &intrsources[virq];
    183   1.2   garbled 
    184   1.2   garbled 	switch (is->is_type) {
    185   1.2   garbled 	case IST_NONE:
    186   1.2   garbled 		is->is_type = type;
    187   1.2   garbled 		break;
    188  1.19       phx 	case IST_EDGE_FALLING:
    189  1.19       phx 	case IST_EDGE_RISING:
    190  1.19       phx 	case IST_LEVEL_LOW:
    191  1.19       phx 	case IST_LEVEL_HIGH:
    192   1.2   garbled 		if (type == is->is_type)
    193   1.2   garbled 			break;
    194  1.15      matt 		/* FALLTHROUGH */
    195   1.2   garbled 	case IST_PULSE:
    196   1.2   garbled 		if (type != IST_NONE)
    197   1.2   garbled 			panic("intr_establish: can't share %s with %s",
    198   1.2   garbled 			    intr_typename(is->is_type),
    199   1.2   garbled 			    intr_typename(type));
    200   1.2   garbled 		break;
    201   1.2   garbled 	}
    202   1.2   garbled 	if (is->is_hand == NULL) {
    203  1.32       rin 		snprintf(is->is_intrid, sizeof(is->is_intrid), "%s irq %d",
    204  1.31       rin 		    pic->pic_name, is->is_hwirq);
    205  1.32       rin 		snprintf(is->is_evname, sizeof(is->is_evname), "irq %d",
    206  1.32       rin 		    is->is_hwirq);
    207   1.2   garbled 		evcnt_attach_dynamic(&is->is_ev, EVCNT_TYPE_INTR, NULL,
    208  1.32       rin 		    pic->pic_name, is->is_evname);
    209   1.2   garbled 	}
    210   1.2   garbled 
    211   1.2   garbled 	/*
    212   1.2   garbled 	 * Figure out where to put the handler.
    213   1.2   garbled 	 * This is O(N^2), but we want to preserve the order, and N is
    214   1.2   garbled 	 * generally small.
    215   1.2   garbled 	 */
    216   1.2   garbled 	for (p = &is->is_hand; (q = *p) != NULL; p = &q->ih_next) {
    217  1.26  riastrad 		maxipl = uimax(maxipl, q->ih_ipl);
    218   1.2   garbled 	}
    219   1.2   garbled 
    220   1.2   garbled 	/*
    221   1.2   garbled 	 * Actually install a fake handler momentarily, since we might be doing
    222   1.2   garbled 	 * this with interrupts enabled and don't want the real routine called
    223   1.2   garbled 	 * until masking is set up.
    224   1.2   garbled 	 */
    225  1.14      matt 	fakehand.ih_ipl = ipl;
    226   1.2   garbled 	fakehand.ih_fun = fakeintr;
    227   1.2   garbled 	*p = &fakehand;
    228   1.2   garbled 
    229   1.2   garbled 	/*
    230   1.2   garbled 	 * Poke the real handler in now.
    231   1.2   garbled 	 */
    232   1.2   garbled 	ih->ih_fun = ih_fun;
    233   1.2   garbled 	ih->ih_arg = ih_arg;
    234   1.2   garbled 	ih->ih_next = NULL;
    235  1.14      matt 	ih->ih_ipl = ipl;
    236  1.15      matt 	ih->ih_virq = virq;
    237  1.25    nonaka 	strlcpy(ih->ih_xname, xname != NULL ? xname : "unknown",
    238  1.25    nonaka 	    sizeof(ih->ih_xname));
    239   1.2   garbled 	*p = ih;
    240   1.2   garbled 
    241   1.2   garbled 	if (pic->pic_establish_irq != NULL)
    242   1.2   garbled 		pic->pic_establish_irq(pic, hwirq - pic->pic_intrbase,
    243  1.14      matt 		    is->is_type, maxipl);
    244  1.14      matt 
    245  1.14      matt 	/*
    246  1.14      matt 	 * Remember the highest IPL used by this handler.
    247  1.14      matt 	 */
    248  1.14      matt 	is->is_ipl = maxipl;
    249   1.2   garbled 
    250   1.2   garbled 	/*
    251   1.2   garbled 	 * now that the handler is established we're actually ready to
    252   1.2   garbled 	 * calculate the masks
    253   1.2   garbled 	 */
    254   1.2   garbled 	intr_calculatemasks();
    255   1.2   garbled 
    256   1.2   garbled 	return ih;
    257   1.2   garbled }
    258   1.2   garbled 
    259   1.2   garbled void
    260   1.2   garbled dummy_pic_establish_intr(struct pic_ops *pic, int irq, int type, int pri)
    261   1.2   garbled {
    262   1.2   garbled }
    263   1.2   garbled 
    264   1.2   garbled /*
    265   1.2   garbled  * Deregister an interrupt handler.
    266   1.2   garbled  */
    267   1.2   garbled void
    268   1.2   garbled intr_disestablish(void *arg)
    269   1.2   garbled {
    270  1.14      matt 	struct intrhand * const ih = arg;
    271  1.15      matt 	const int virq = ih->ih_virq;
    272  1.15      matt 	struct intr_source * const is = &intrsources[virq];
    273  1.14      matt 	struct intrhand **p, **q;
    274  1.14      matt 	int maxipl = IPL_NONE;
    275   1.2   garbled 
    276  1.15      matt 	if (!PIC_VIRQ_LEGAL_P(virq))
    277  1.15      matt 		panic("intr_disestablish: bogus virq %d", virq);
    278   1.2   garbled 
    279   1.2   garbled 	/*
    280   1.2   garbled 	 * Remove the handler from the chain.
    281   1.2   garbled 	 * This is O(n^2), too.
    282   1.2   garbled 	 */
    283  1.14      matt 	for (p = &is->is_hand, q = NULL; (*p) != NULL; p = &(*p)->ih_next) {
    284  1.14      matt 		struct intrhand * const tmp_ih = *p;
    285  1.14      matt 		if (tmp_ih == ih) {
    286  1.14      matt 			q = p;
    287  1.14      matt 		} else {
    288  1.26  riastrad 			maxipl = uimax(maxipl, tmp_ih->ih_ipl);
    289  1.14      matt 		}
    290  1.14      matt 	}
    291   1.2   garbled 	if (q)
    292  1.14      matt 		*q = ih->ih_next;
    293   1.2   garbled 	else
    294   1.2   garbled 		panic("intr_disestablish: handler not registered");
    295  1.20      matt 	kmem_intr_free((void *)ih, sizeof(*ih));
    296   1.2   garbled 
    297  1.14      matt 	/*
    298  1.14      matt 	 * Reset the IPL for this source now that we've removed a handler.
    299  1.14      matt 	 */
    300  1.14      matt 	is->is_ipl = maxipl;
    301  1.14      matt 
    302   1.2   garbled 	intr_calculatemasks();
    303   1.2   garbled 
    304   1.2   garbled 	if (is->is_hand == NULL) {
    305   1.2   garbled 		is->is_type = IST_NONE;
    306   1.2   garbled 		evcnt_detach(&is->is_ev);
    307  1.15      matt 		/*
    308  1.15      matt 		 * Make the virutal IRQ available again.
    309  1.15      matt 		 */
    310  1.15      matt 		virq_map[virq] = 0;
    311  1.15      matt 		virq_mask |= PIC_VIRQ_TO_MASK(virq);
    312   1.2   garbled 	}
    313   1.2   garbled }
    314   1.2   garbled 
    315   1.2   garbled /*
    316   1.2   garbled  * Map max_base irqs into 32 (bits).
    317   1.2   garbled  */
    318   1.2   garbled static int
    319  1.15      matt mapirq(int hwirq)
    320   1.2   garbled {
    321   1.2   garbled 	struct pic_ops *pic;
    322   1.2   garbled 
    323  1.15      matt 	if (hwirq >= max_base)
    324  1.15      matt 		panic("invalid irq %d", hwirq);
    325   1.2   garbled 
    326  1.15      matt 	if ((pic = find_pic_by_hwirq(hwirq)) == NULL)
    327  1.15      matt 		panic("%s: cannot find PIC for HWIRQ %d", __func__, hwirq);
    328   1.2   garbled 
    329  1.15      matt 	if (virq_map[hwirq])
    330  1.15      matt 		return virq_map[hwirq];
    331   1.2   garbled 
    332  1.15      matt 	if (virq_mask == 0)
    333   1.2   garbled 		panic("virq overflow");
    334   1.2   garbled 
    335  1.15      matt 	const int virq = PIC_VIRQ_MS_PENDING(virq_mask);
    336  1.15      matt 	struct intr_source * const is = intrsources + virq;
    337  1.15      matt 
    338  1.15      matt 	virq_mask &= ~PIC_VIRQ_TO_MASK(virq);
    339  1.15      matt 
    340  1.15      matt 	is->is_hwirq = hwirq;
    341  1.15      matt 	is->is_pic = pic;
    342  1.15      matt 	virq_map[hwirq] = virq;
    343   1.2   garbled #ifdef PIC_DEBUG
    344  1.17       rjs 	printf("mapping hwirq %d to virq %d\n", hwirq, virq);
    345   1.2   garbled #endif
    346  1.15      matt 	return virq;
    347   1.2   garbled }
    348   1.2   garbled 
    349   1.2   garbled static const char * const intr_typenames[] = {
    350   1.2   garbled    [IST_NONE]  = "none",
    351   1.2   garbled    [IST_PULSE] = "pulsed",
    352  1.19       phx    [IST_EDGE_FALLING]  = "falling edge triggered",
    353  1.19       phx    [IST_EDGE_RISING]  = "rising edge triggered",
    354  1.19       phx    [IST_LEVEL_LOW] = "low level triggered",
    355  1.19       phx    [IST_LEVEL_HIGH] = "high level triggered",
    356   1.2   garbled };
    357   1.2   garbled 
    358   1.2   garbled const char *
    359   1.2   garbled intr_typename(int type)
    360   1.2   garbled {
    361   1.2   garbled 	KASSERT((unsigned int) type < __arraycount(intr_typenames));
    362   1.2   garbled 	KASSERT(intr_typenames[type] != NULL);
    363   1.2   garbled 	return intr_typenames[type];
    364   1.2   garbled }
    365   1.2   garbled 
    366   1.2   garbled /*
    367   1.2   garbled  * Recalculate the interrupt masks from scratch.
    368   1.2   garbled  * We could code special registry and deregistry versions of this function that
    369   1.2   garbled  * would be faster, but the code would be nastier, and we don't expect this to
    370   1.2   garbled  * happen very much anyway.
    371   1.2   garbled  */
    372   1.2   garbled static void
    373   1.2   garbled intr_calculatemasks(void)
    374   1.2   garbled {
    375  1.23  macallan 	imask_t newmask[NIPL];
    376   1.2   garbled 	struct intr_source *is;
    377  1.23  macallan 	struct intrhand *ih;
    378  1.14      matt 	int irq;
    379   1.2   garbled 
    380  1.14      matt 	for (u_int ipl = IPL_NONE; ipl < NIPL; ipl++) {
    381  1.14      matt 		newmask[ipl] = 0;
    382   1.2   garbled 	}
    383   1.2   garbled 
    384  1.14      matt 	/* First, figure out which ipl each IRQ uses. */
    385  1.14      matt 	for (irq = 0, is = intrsources; irq < NVIRQ; irq++, is++) {
    386  1.23  macallan 		for (ih = is->is_hand; ih != NULL; ih = ih->ih_next) {
    387  1.23  macallan 			newmask[ih->ih_ipl] |= PIC_VIRQ_TO_MASK(irq);
    388  1.23  macallan 		}
    389   1.2   garbled 	}
    390   1.2   garbled 
    391   1.2   garbled 	/*
    392   1.2   garbled 	 * IPL_NONE is used for hardware interrupts that are never blocked,
    393   1.2   garbled 	 * and do not block anything else.
    394   1.2   garbled 	 */
    395  1.14      matt 	newmask[IPL_NONE] = 0;
    396   1.2   garbled 
    397   1.2   garbled 	/*
    398   1.2   garbled 	 * strict hierarchy - all IPLs block everything blocked by any lower
    399   1.2   garbled 	 * IPL
    400   1.2   garbled 	 */
    401  1.14      matt 	for (u_int ipl = 1; ipl < NIPL; ipl++) {
    402  1.14      matt 		newmask[ipl] |= newmask[ipl - 1];
    403  1.14      matt 	}
    404   1.2   garbled 
    405  1.23  macallan #ifdef PIC_DEBUG
    406  1.14      matt 	for (u_int ipl = 0; ipl < NIPL; ipl++) {
    407  1.14      matt 		printf("%u: %08x -> %08x\n", ipl, imask[ipl], newmask[ipl]);
    408   1.2   garbled 	}
    409   1.2   garbled #endif
    410   1.2   garbled 
    411  1.14      matt 	/*
    412  1.14      matt 	 * Disable all interrupts.
    413  1.14      matt 	 */
    414  1.14      matt 	for (u_int base = 0; base < num_pics; base++) {
    415  1.14      matt 		struct pic_ops * const pic = pics[base];
    416  1.14      matt 		for (u_int i = 0; i < pic->pic_numintrs; i++) {
    417  1.14      matt 			pic->pic_disable_irq(pic, i);
    418  1.14      matt 		}
    419   1.2   garbled 	}
    420   1.2   garbled 
    421  1.14      matt 	/*
    422  1.14      matt 	 * Now that all interrupts are disabled, update the ipl masks.
    423  1.14      matt 	 */
    424  1.14      matt 	for (u_int ipl = 0; ipl < NIPL; ipl++) {
    425  1.14      matt 		imask[ipl] = newmask[ipl];
    426   1.2   garbled 	}
    427   1.7  kiyohara 
    428  1.14      matt 	/*
    429  1.14      matt 	 * Lastly, enable IRQs actually in use.
    430  1.14      matt 	 */
    431   1.2   garbled 	for (irq = 0, is = intrsources; irq < NVIRQ; irq++, is++) {
    432   1.2   garbled 		if (is->is_hand)
    433   1.2   garbled 			pic_enable_irq(is->is_hwirq);
    434   1.2   garbled 	}
    435   1.2   garbled }
    436   1.2   garbled 
    437   1.2   garbled void
    438  1.15      matt pic_enable_irq(int hwirq)
    439   1.2   garbled {
    440  1.15      matt 	struct pic_ops * const pic = find_pic_by_hwirq(hwirq);
    441  1.15      matt 	if (pic == NULL)
    442  1.15      matt 		panic("%s: bogus IRQ %d", __func__, hwirq);
    443  1.15      matt 	const int type = intrsources[virq_map[hwirq]].is_type;
    444  1.15      matt 	(*pic->pic_enable_irq)(pic, hwirq - pic->pic_intrbase, type);
    445   1.2   garbled }
    446   1.2   garbled 
    447   1.2   garbled void
    448  1.15      matt pic_mark_pending(int hwirq)
    449   1.2   garbled {
    450   1.2   garbled 	struct cpu_info * const ci = curcpu();
    451   1.2   garbled 
    452  1.15      matt 	const int virq = virq_map[hwirq];
    453  1.15      matt 	if (virq == 0)
    454  1.15      matt 		printf("IRQ %d maps to 0\n", hwirq);
    455   1.2   garbled 
    456  1.15      matt 	const register_t msr = mfmsr();
    457   1.2   garbled 	mtmsr(msr & ~PSL_EE);
    458  1.15      matt 	ci->ci_ipending |= PIC_VIRQ_TO_MASK(virq);
    459   1.2   garbled 	mtmsr(msr);
    460   1.7  kiyohara }
    461   1.2   garbled 
    462  1.15      matt static void
    463  1.15      matt intr_deliver(struct intr_source *is, int virq)
    464  1.15      matt {
    465  1.15      matt 	bool locked = false;
    466  1.15      matt 	for (struct intrhand *ih = is->is_hand; ih != NULL; ih = ih->ih_next) {
    467  1.15      matt 		KASSERTMSG(ih->ih_fun != NULL,
    468  1.18       jym 		    "%s: irq %d, hwirq %d, is %p ih %p: "
    469  1.15      matt 		     "NULL interrupt handler!\n", __func__,
    470  1.18       jym 		     virq, is->is_hwirq, is, ih);
    471  1.15      matt 		if (ih->ih_ipl == IPL_VM) {
    472  1.15      matt 			if (!locked) {
    473  1.15      matt 				KERNEL_LOCK(1, NULL);
    474  1.15      matt 				locked = true;
    475  1.15      matt 			}
    476  1.15      matt 		} else if (locked) {
    477  1.15      matt 			KERNEL_UNLOCK_ONE(NULL);
    478  1.15      matt 			locked = false;
    479  1.15      matt 		}
    480  1.15      matt 		(*ih->ih_fun)(ih->ih_arg);
    481  1.15      matt 	}
    482  1.15      matt 	if (locked) {
    483  1.15      matt 		KERNEL_UNLOCK_ONE(NULL);
    484  1.15      matt 	}
    485  1.15      matt 	is->is_ev.ev_count++;
    486  1.15      matt }
    487  1.15      matt 
    488   1.2   garbled void
    489   1.2   garbled pic_do_pending_int(void)
    490   1.2   garbled {
    491   1.2   garbled 	struct cpu_info * const ci = curcpu();
    492  1.15      matt 	imask_t vpend;
    493   1.2   garbled 
    494   1.2   garbled 	if (ci->ci_iactive)
    495   1.2   garbled 		return;
    496   1.2   garbled 
    497   1.2   garbled 	ci->ci_iactive = 1;
    498  1.15      matt 
    499  1.15      matt 	const register_t emsr = mfmsr();
    500  1.15      matt 	const register_t dmsr = emsr & ~PSL_EE;
    501  1.15      matt 
    502   1.2   garbled 	KASSERT(emsr & PSL_EE);
    503   1.2   garbled 	mtmsr(dmsr);
    504   1.2   garbled 
    505  1.15      matt 	const int pcpl = ci->ci_cpl;
    506   1.3        ad #ifdef __HAVE_FAST_SOFTINTS
    507   1.2   garbled again:
    508   1.3        ad #endif
    509   1.2   garbled 
    510   1.2   garbled 	/* Do now unmasked pendings */
    511  1.15      matt 	while ((vpend = (ci->ci_ipending & ~imask[pcpl])) != 0) {
    512  1.14      matt 		ci->ci_idepth++;
    513  1.15      matt 		KASSERT((PIC_VIRQ_TO_MASK(0) & ci->ci_ipending) == 0);
    514  1.15      matt 
    515   1.8  kiyohara 		/* Get most significant pending bit */
    516  1.15      matt 		const int virq = PIC_VIRQ_MS_PENDING(vpend);
    517  1.15      matt 		ci->ci_ipending &= ~PIC_VIRQ_TO_MASK(virq);
    518  1.15      matt 
    519  1.15      matt 		struct intr_source * const is = &intrsources[virq];
    520  1.15      matt 		struct pic_ops * const pic = is->is_pic;
    521   1.2   garbled 
    522  1.14      matt 		splraise(is->is_ipl);
    523   1.2   garbled 		mtmsr(emsr);
    524  1.15      matt 		intr_deliver(is, virq);
    525   1.2   garbled 		mtmsr(dmsr);
    526  1.15      matt 		ci->ci_cpl = pcpl; /* Don't use splx... we are here already! */
    527   1.2   garbled 
    528   1.2   garbled 		pic->pic_reenable_irq(pic, is->is_hwirq - pic->pic_intrbase,
    529   1.2   garbled 		    is->is_type);
    530  1.14      matt 		ci->ci_idepth--;
    531   1.2   garbled 	}
    532   1.2   garbled 
    533   1.3        ad #ifdef __HAVE_FAST_SOFTINTS
    534  1.21  macallan 	const u_int softints = ci->ci_data.cpu_softints &
    535  1.21  macallan 				 (IPL_SOFTMASK << pcpl);
    536  1.21  macallan 
    537  1.21  macallan 	/* make sure there are no bits to screw with the line above */
    538  1.21  macallan 	KASSERT((ci->ci_data.cpu_softints & ~IPL_SOFTMASK) == 0);
    539  1.12  macallan 
    540  1.12  macallan 	if (__predict_false(softints != 0)) {
    541  1.15      matt 		ci->ci_cpl = IPL_HIGH;
    542  1.15      matt 		mtmsr(emsr);
    543  1.12  macallan 		powerpc_softint(ci, pcpl,
    544  1.12  macallan 		    (vaddr_t)__builtin_return_address(0));
    545  1.15      matt 		mtmsr(dmsr);
    546  1.12  macallan 		ci->ci_cpl = pcpl;
    547  1.15      matt 		if (__predict_false(ci->ci_ipending & ~imask[pcpl]))
    548  1.15      matt 			goto again;
    549  1.12  macallan 	}
    550  1.12  macallan #endif
    551   1.2   garbled 
    552   1.2   garbled 	ci->ci_iactive = 0;
    553   1.2   garbled 	mtmsr(emsr);
    554   1.2   garbled }
    555   1.2   garbled 
    556   1.2   garbled int
    557   1.2   garbled pic_handle_intr(void *cookie)
    558   1.2   garbled {
    559   1.2   garbled 	struct pic_ops *pic = cookie;
    560   1.2   garbled 	struct cpu_info *ci = curcpu();
    561  1.15      matt 	int picirq;
    562   1.2   garbled 
    563  1.15      matt 	picirq = pic->pic_get_irq(pic, PIC_GET_IRQ);
    564  1.15      matt 	if (picirq == 255)
    565   1.2   garbled 		return 0;
    566   1.2   garbled 
    567  1.15      matt 	const register_t msr = mfmsr();
    568  1.15      matt 	const int pcpl = ci->ci_cpl;
    569   1.2   garbled 
    570  1.15      matt 	do {
    571  1.24  macallan 		const int virq = virq_map[picirq + pic->pic_intrbase];
    572   1.2   garbled 
    573  1.15      matt 		KASSERT(virq != 0);
    574  1.15      matt 		KASSERT(picirq < pic->pic_numintrs);
    575  1.15      matt 		imask_t v_imen = PIC_VIRQ_TO_MASK(virq);
    576  1.15      matt 		struct intr_source * const is = &intrsources[virq];
    577  1.15      matt 
    578  1.15      matt 		if ((imask[pcpl] & v_imen) != 0) {
    579  1.15      matt 			ci->ci_ipending |= v_imen; /* Masked! Mark this as pending */
    580  1.15      matt 			pic->pic_disable_irq(pic, picirq);
    581  1.15      matt 		} else {
    582  1.15      matt 			/* this interrupt is no longer pending */
    583  1.15      matt 			ci->ci_ipending &= ~v_imen;
    584  1.15      matt 			ci->ci_idepth++;
    585  1.15      matt 
    586  1.15      matt 			splraise(is->is_ipl);
    587  1.15      matt 			mtmsr(msr | PSL_EE);
    588  1.15      matt 			intr_deliver(is, virq);
    589  1.15      matt 			mtmsr(msr);
    590  1.15      matt 			ci->ci_cpl = pcpl;
    591   1.7  kiyohara 
    592  1.15      matt 			ci->ci_data.cpu_nintr++;
    593  1.15      matt 			ci->ci_idepth--;
    594   1.2   garbled 		}
    595  1.15      matt 		pic->pic_ack_irq(pic, picirq);
    596  1.15      matt 	} while ((picirq = pic->pic_get_irq(pic, PIC_GET_RECHECK)) != 255);
    597   1.2   garbled 
    598   1.2   garbled 	mtmsr(msr | PSL_EE);
    599   1.2   garbled 	splx(pcpl);	/* Process pendings. */
    600   1.2   garbled 	mtmsr(msr);
    601   1.2   garbled 
    602   1.2   garbled 	return 0;
    603   1.2   garbled }
    604   1.2   garbled 
    605   1.2   garbled void
    606   1.2   garbled pic_ext_intr(void)
    607   1.2   garbled {
    608   1.2   garbled 
    609   1.2   garbled 	KASSERT(pics[primary_pic] != NULL);
    610   1.2   garbled 	pic_handle_intr(pics[primary_pic]);
    611   1.2   garbled 
    612   1.2   garbled 	return;
    613   1.2   garbled 
    614   1.2   garbled }
    615   1.2   garbled 
    616   1.2   garbled int
    617   1.2   garbled splraise(int ncpl)
    618   1.2   garbled {
    619   1.2   garbled 	struct cpu_info *ci = curcpu();
    620   1.2   garbled 	int ocpl;
    621   1.2   garbled 
    622  1.12  macallan 	if (ncpl == ci->ci_cpl) return ncpl;
    623  1.27       rin 	REORDER_PROTECT();
    624   1.2   garbled 	ocpl = ci->ci_cpl;
    625  1.12  macallan 	KASSERT(ncpl < NIPL);
    626  1.26  riastrad 	ci->ci_cpl = uimax(ncpl, ocpl);
    627  1.27       rin 	REORDER_PROTECT();
    628  1.12  macallan 	__insn_barrier();
    629   1.2   garbled 	return ocpl;
    630   1.2   garbled }
    631   1.2   garbled 
    632  1.13      matt static inline bool
    633  1.13      matt have_pending_intr_p(struct cpu_info *ci, int ncpl)
    634  1.13      matt {
    635  1.13      matt 	if (ci->ci_ipending & ~imask[ncpl])
    636  1.13      matt 		return true;
    637  1.13      matt #ifdef __HAVE_FAST_SOFTINTS
    638  1.22  macallan 	if (ci->ci_data.cpu_softints & (IPL_SOFTMASK << ncpl))
    639  1.13      matt 		return true;
    640  1.13      matt #endif
    641  1.13      matt 	return false;
    642  1.13      matt }
    643  1.13      matt 
    644   1.2   garbled void
    645   1.2   garbled splx(int ncpl)
    646   1.2   garbled {
    647   1.2   garbled 	struct cpu_info *ci = curcpu();
    648   1.7  kiyohara 
    649  1.12  macallan 	__insn_barrier();
    650  1.27       rin 	REORDER_PROTECT();
    651   1.2   garbled 	ci->ci_cpl = ncpl;
    652  1.13      matt 	if (have_pending_intr_p(ci, ncpl))
    653   1.2   garbled 		pic_do_pending_int();
    654  1.13      matt 
    655  1.27       rin 	REORDER_PROTECT();
    656   1.2   garbled }
    657   1.2   garbled 
    658   1.2   garbled int
    659   1.2   garbled spllower(int ncpl)
    660   1.2   garbled {
    661   1.2   garbled 	struct cpu_info *ci = curcpu();
    662   1.2   garbled 	int ocpl;
    663   1.2   garbled 
    664  1.12  macallan 	__insn_barrier();
    665  1.27       rin 	REORDER_PROTECT();
    666   1.2   garbled 	ocpl = ci->ci_cpl;
    667   1.2   garbled 	ci->ci_cpl = ncpl;
    668  1.13      matt 	if (have_pending_intr_p(ci, ncpl))
    669   1.2   garbled 		pic_do_pending_int();
    670  1.27       rin 	REORDER_PROTECT();
    671   1.2   garbled 	return ocpl;
    672   1.2   garbled }
    673   1.2   garbled 
    674   1.2   garbled void
    675   1.2   garbled genppc_cpu_configure(void)
    676   1.2   garbled {
    677  1.23  macallan 	aprint_normal("vmmask %x schedmask %x highmask %x\n",
    678  1.23  macallan 	    (u_int)imask[IPL_VM] & 0x7fffffff,
    679  1.23  macallan 	    (u_int)imask[IPL_SCHED] & 0x7fffffff,
    680  1.23  macallan 	    (u_int)imask[IPL_HIGH] & 0x7fffffff);
    681   1.2   garbled 
    682   1.2   garbled 	spl0();
    683   1.2   garbled }
    684   1.2   garbled 
    685   1.2   garbled #if defined(PIC_PREPIVR) || defined(PIC_I8259)
    686   1.2   garbled /*
    687   1.2   garbled  * isa_intr_alloc needs to be done here, because it needs direct access to
    688   1.2   garbled  * the various interrupt handler structures.
    689   1.2   garbled  */
    690   1.2   garbled 
    691   1.2   garbled int
    692   1.2   garbled genppc_isa_intr_alloc(isa_chipset_tag_t ic, struct pic_ops *pic,
    693   1.2   garbled     int mask, int type, int *irq_p)
    694   1.2   garbled {
    695   1.2   garbled 	int irq, vi;
    696   1.2   garbled 	int maybe_irq = -1;
    697   1.2   garbled 	int shared_depth = 0;
    698   1.2   garbled 	struct intr_source *is;
    699   1.2   garbled 
    700   1.2   garbled 	if (pic == NULL)
    701   1.2   garbled 		return 1;
    702   1.2   garbled 
    703   1.2   garbled 	for (irq = 0; (mask != 0 && irq < pic->pic_numintrs);
    704   1.2   garbled 	     mask >>= 1, irq++) {
    705   1.2   garbled 		if ((mask & 1) == 0)
    706   1.2   garbled 			continue;
    707  1.15      matt 		vi = virq_map[irq + pic->pic_intrbase];
    708   1.2   garbled 		if (!vi) {
    709   1.2   garbled 			*irq_p = irq;
    710   1.2   garbled 			return 0;
    711   1.2   garbled 		}
    712   1.2   garbled 		is = &intrsources[vi];
    713   1.2   garbled 		if (is->is_type == IST_NONE) {
    714   1.2   garbled 			*irq_p = irq;
    715   1.2   garbled 			return 0;
    716   1.2   garbled 		}
    717   1.2   garbled 		/* Level interrupts can be shared */
    718   1.2   garbled 		if (type == IST_LEVEL && is->is_type == IST_LEVEL) {
    719   1.2   garbled 			struct intrhand *ih = is->is_hand;
    720   1.2   garbled 			int depth;
    721   1.2   garbled 
    722   1.2   garbled 			if (maybe_irq == -1) {
    723   1.2   garbled 				maybe_irq = irq;
    724   1.2   garbled 				continue;
    725   1.2   garbled 			}
    726   1.2   garbled 			for (depth = 0; ih != NULL; ih = ih->ih_next)
    727   1.2   garbled 				depth++;
    728   1.2   garbled 			if (depth < shared_depth) {
    729   1.2   garbled 				maybe_irq = irq;
    730   1.2   garbled 				shared_depth = depth;
    731   1.2   garbled 			}
    732   1.2   garbled 		}
    733   1.2   garbled 	}
    734   1.2   garbled 	if (maybe_irq != -1) {
    735   1.2   garbled 		*irq_p = maybe_irq;
    736   1.2   garbled 		return 0;
    737   1.2   garbled 	}
    738   1.2   garbled 	return 1;
    739   1.2   garbled }
    740   1.2   garbled #endif
    741  1.25    nonaka 
    742  1.25    nonaka static struct intr_source *
    743  1.25    nonaka intr_get_source(const char *intrid)
    744  1.25    nonaka {
    745  1.25    nonaka 	struct intr_source *is;
    746  1.25    nonaka 	int irq;
    747  1.25    nonaka 
    748  1.25    nonaka 	for (irq = 0, is = intrsources; irq < NVIRQ; irq++, is++) {
    749  1.32       rin 		if (strcmp(intrid, is->is_intrid) == 0)
    750  1.25    nonaka 			return is;
    751  1.25    nonaka 	}
    752  1.25    nonaka 	return NULL;
    753  1.25    nonaka }
    754  1.25    nonaka 
    755  1.25    nonaka static struct intrhand *
    756  1.25    nonaka intr_get_handler(const char *intrid)
    757  1.25    nonaka {
    758  1.25    nonaka 	struct intr_source *is;
    759  1.25    nonaka 
    760  1.25    nonaka 	is = intr_get_source(intrid);
    761  1.25    nonaka 	if (is != NULL)
    762  1.25    nonaka 		return is->is_hand;
    763  1.25    nonaka 	return NULL;
    764  1.25    nonaka }
    765  1.25    nonaka 
    766  1.25    nonaka uint64_t
    767  1.25    nonaka interrupt_get_count(const char *intrid, u_int cpu_idx)
    768  1.25    nonaka {
    769  1.25    nonaka 	struct intr_source *is;
    770  1.25    nonaka 
    771  1.25    nonaka 	/* XXX interrupt is always generated by CPU 0 */
    772  1.25    nonaka 	if (cpu_idx != 0)
    773  1.25    nonaka 		return 0;
    774  1.25    nonaka 
    775  1.25    nonaka 	is = intr_get_source(intrid);
    776  1.25    nonaka 	if (is != NULL)
    777  1.25    nonaka 		return is->is_ev.ev_count;
    778  1.25    nonaka 	return 0;
    779  1.25    nonaka }
    780  1.25    nonaka 
    781  1.25    nonaka void
    782  1.25    nonaka interrupt_get_assigned(const char *intrid, kcpuset_t *cpuset)
    783  1.25    nonaka {
    784  1.25    nonaka 	struct intr_source *is;
    785  1.25    nonaka 
    786  1.25    nonaka 	kcpuset_zero(cpuset);
    787  1.25    nonaka 
    788  1.25    nonaka 	is = intr_get_source(intrid);
    789  1.25    nonaka 	if (is != NULL)
    790  1.25    nonaka 		kcpuset_set(cpuset, 0);	/* XXX */
    791  1.25    nonaka }
    792  1.25    nonaka 
    793  1.25    nonaka void
    794  1.25    nonaka interrupt_get_available(kcpuset_t *cpuset)
    795  1.25    nonaka {
    796  1.25    nonaka 	CPU_INFO_ITERATOR cii;
    797  1.25    nonaka 	struct cpu_info *ci;
    798  1.25    nonaka 
    799  1.25    nonaka 	kcpuset_zero(cpuset);
    800  1.25    nonaka 
    801  1.25    nonaka 	mutex_enter(&cpu_lock);
    802  1.25    nonaka 	for (CPU_INFO_FOREACH(cii, ci)) {
    803  1.25    nonaka 		if ((ci->ci_schedstate.spc_flags & SPCF_NOINTR) == 0)
    804  1.25    nonaka 			kcpuset_set(cpuset, cpu_index(ci));
    805  1.25    nonaka 	}
    806  1.25    nonaka 	mutex_exit(&cpu_lock);
    807  1.25    nonaka }
    808  1.25    nonaka 
    809  1.25    nonaka void
    810  1.25    nonaka interrupt_get_devname(const char *intrid, char *buf, size_t len)
    811  1.25    nonaka {
    812  1.25    nonaka 	struct intrhand *ih;
    813  1.25    nonaka 
    814  1.25    nonaka 	if (len == 0)
    815  1.25    nonaka 		return;
    816  1.25    nonaka 
    817  1.25    nonaka 	buf[0] = '\0';
    818  1.25    nonaka 
    819  1.25    nonaka 	for (ih = intr_get_handler(intrid); ih != NULL; ih = ih->ih_next) {
    820  1.25    nonaka 		if (buf[0] != '\0')
    821  1.25    nonaka 			strlcat(buf, ", ", len);
    822  1.25    nonaka 		strlcat(buf, ih->ih_xname, len);
    823  1.25    nonaka 	}
    824  1.25    nonaka }
    825  1.25    nonaka 
    826  1.25    nonaka struct intrids_handler *
    827  1.25    nonaka interrupt_construct_intrids(const kcpuset_t *cpuset)
    828  1.25    nonaka {
    829  1.25    nonaka 	struct intr_source *is;
    830  1.25    nonaka 	struct intrids_handler *ii_handler;
    831  1.25    nonaka 	intrid_t *ids;
    832  1.25    nonaka 	int i, irq, count;
    833  1.25    nonaka 
    834  1.25    nonaka 	if (kcpuset_iszero(cpuset))
    835  1.25    nonaka 		return NULL;
    836  1.25    nonaka 	if (!kcpuset_isset(cpuset, 0))	/* XXX */
    837  1.25    nonaka 		return NULL;
    838  1.25    nonaka 
    839  1.25    nonaka 	count = 0;
    840  1.25    nonaka 	for (irq = 0, is = intrsources; irq < NVIRQ; irq++, is++) {
    841  1.25    nonaka 		if (is->is_hand != NULL)
    842  1.25    nonaka 			count++;
    843  1.25    nonaka 	}
    844  1.25    nonaka 
    845  1.25    nonaka 	ii_handler = kmem_zalloc(sizeof(int) + sizeof(intrid_t) * count,
    846  1.25    nonaka 	    KM_SLEEP);
    847  1.25    nonaka 	if (ii_handler == NULL)
    848  1.25    nonaka 		return NULL;
    849  1.25    nonaka 	ii_handler->iih_nids = count;
    850  1.25    nonaka 	if (count == 0)
    851  1.25    nonaka 		return ii_handler;
    852  1.25    nonaka 
    853  1.25    nonaka 	ids = ii_handler->iih_intrids;
    854  1.25    nonaka 	i = 0;
    855  1.25    nonaka 	for (irq = 0, is = intrsources; irq < NVIRQ; irq++, is++) {
    856  1.25    nonaka 		/* Ignore devices attached after counting "count". */
    857  1.25    nonaka 		if (i >= count)
    858  1.25    nonaka 			break;
    859  1.25    nonaka 
    860  1.25    nonaka 		if (is->is_hand == NULL)
    861  1.25    nonaka 			continue;
    862  1.25    nonaka 
    863  1.32       rin 		strncpy(ids[i], is->is_intrid, sizeof(intrid_t));
    864  1.25    nonaka 		i++;
    865  1.25    nonaka 	}
    866  1.25    nonaka 
    867  1.25    nonaka 	return ii_handler;
    868  1.25    nonaka }
    869  1.25    nonaka 
    870  1.25    nonaka void
    871  1.25    nonaka interrupt_destruct_intrids(struct intrids_handler *ii_handler)
    872  1.25    nonaka {
    873  1.25    nonaka 	size_t iih_size;
    874  1.25    nonaka 
    875  1.25    nonaka 	if (ii_handler == NULL)
    876  1.25    nonaka 		return;
    877  1.25    nonaka 
    878  1.25    nonaka 	iih_size = sizeof(int) + sizeof(intrid_t) * ii_handler->iih_nids;
    879  1.25    nonaka 	kmem_free(ii_handler, iih_size);
    880  1.25    nonaka }
    881  1.25    nonaka 
    882  1.25    nonaka int
    883  1.25    nonaka interrupt_distribute(void *ich, const kcpuset_t *newset, kcpuset_t *oldset)
    884  1.25    nonaka {
    885  1.25    nonaka 	return EOPNOTSUPP;
    886  1.25    nonaka }
    887  1.25    nonaka 
    888  1.25    nonaka int
    889  1.25    nonaka interrupt_distribute_handler(const char *intrid, const kcpuset_t *newset,
    890  1.25    nonaka     kcpuset_t *oldset)
    891  1.25    nonaka {
    892  1.25    nonaka 	return EOPNOTSUPP;
    893  1.25    nonaka }
    894  1.27       rin 
    895  1.27       rin #undef REORDER_PROTECT
    896