/************************************************************************
|	Plik irq.c dla i386. 						|
|	Skomentował Piotr Hoffman					|
|	Plik zawiera niskopoziomową obsługę przerwań sprzętowych (IRQ)	|
|	Opis obsługi tych przerwań można znaleźć tutaj.			|
************************************************************************/	

/*
 *	linux/arch/i386/kernel/irq.c
 *
 *	Copyright (C) 1992 Linus Torvalds
 *
 * This file contains the code used by various IRQ handling routines:
 * asking for different IRQ's should be done through these routines
 * instead of just grabbing them. Thus setups with different IRQ numbers
 * shouldn't result in any weird surprises, and installing new handlers
 * should be easier.
 */

/*
 * IRQ's are in fact implemented a bit like signal handlers for the kernel.
 * Naturally it's not a 1:1 relation, but there are similarities.
 */

#include < linux/ptrace.h>
#include < linux/errno.h>
#include < linux/kernel_stat.h>
#include < linux/signal.h>
#include < linux/sched.h>
#include < linux/ioport.h>
#include < linux/interrupt.h>
#include < linux/timex.h>
#include < linux/malloc.h>
#include < linux/random.h>

#include < asm/system.h>
#include < asm/io.h>
#include < asm/irq.h>
#include < asm/bitops.h>
#include < asm/smp.h>

#define CR0_NE 32


/* Przechowują informację, które IRQ są włączone (bit ustawiony -> wyłączone).
	Są to kopie zawartości rejestrów obu sterowników przerwań.
	Początkowo wszystkie IRQ są wyłączone */
static unsigned char cache_21 = 0xff;
static unsigned char cache_A1 = 0xff;

#ifdef __SMP_PROF__
static unsigned int int_count[NR_CPUS][NR_IRQS] = {{0},};
#endif

/************************************************************************
|	zamaskowuje IRQ o numerze irq_nr (tzn. od tego momentu		|
|	sterownik przerwań nie wysyła przerwań o tym numerze).		|
|	Jednocześnie aktualizuje wartość zmiennych cache_21 i cache_A1,	|
|	by była ona taka sama, jak wartość rejestru zamaskowanych 	|
|	przerwań na odpowiednim sterowniku.				|
************************************************************************/

static inline void mask_irq(unsigned int irq_nr)
{
	unsigned char mask;

	mask = 1 << (irq_nr & 7);	/* 3 pierwsze bity dają numer na 
						sterowniku (0-7)  */
	if (irq_nr < 8) {		/* czwarty bit daje numer
						sterownika	  */
		cache_21 |= mask;	/* aktualizujemy cache */
		outb(cache_21,0x21);	/* 0x21 - rejestr pierwszego sterownika */
	} else {
		cache_A1 |= mask;	/* aktualizujemy cache */
		outb(cache_A1,0xA1);	/* 0xA1 - rejestr drugiego sterownika   */
	}
}


/************************************************************************
|	Procedura identyczna jak poprzednio, ale tym razem włączamy	|
|	IRQ o numerze irq_nr.						|
************************************************************************/

static inline void unmask_irq(unsigned int irq_nr)
{
	unsigned char mask;

	mask = ~(1 << (irq_nr & 7));
	if (irq_nr < 8) {
		cache_21 &= mask;
		outb(cache_21,0x21);
	} else {
		cache_A1 &= mask;
		outb(cache_A1,0xA1);
	}
}

/************************************************************************
|	Wyłączanie i włączanie przerwań, ale pod ochroną cli. Dzięki	|
|	temu zawartość cache_21/A1 pozostaje zawsze właściwa.		|
************************************************************************/


void disable_irq(unsigned int irq_nr)
{
	unsigned long flags;

	save_flags(flags);
	cli();
	mask_irq(irq_nr);
	restore_flags(flags);
}

void enable_irq(unsigned int irq_nr)
{
	unsigned long flags;
	save_flags(flags);
	cli();
	unmask_irq(irq_nr);
	restore_flags(flags);
}

/*
 * This builds up the IRQ handler stubs using some ugly macros in irq.h
 *
 * These macros create the low-level assembly IRQ routines that do all
 * the operations that are needed to keep the AT interrupt-controller
 * happy. They are also written to be fast - and to disable interrupts
 * as little as humanly possible.
 *
 * NOTE! These macros expand to three different handlers for each line: one
 * complete handler that does all the fancy stuff (including signal handling),
 * and one fast handler that is meant for simple IRQ's that want to be
 * atomic. The specific handler is chosen depending on the SA_INTERRUPT
 * flag when installing a handler. Finally, one "bad interrupt" handler, that
 * is used when no handler is present.
 *
 * The timer interrupt is handled specially to insure that the jiffies
 * variable is updated at all times.  Specifically, the timer interrupt is
 * just like the complete handlers except that it is invoked with interrupts
 * disabled and should never re-enable them.  If other interrupts were
 * allowed to be processed while the timer interrupt is active, then the
 * other interrupts would have to avoid using the jiffies variable for delay
 * and interval timing operations to avoid hanging the system.
 */

/************************************************************************
|	Poniższe makra rozwijają się w kod funkcji obsługi przerwań - dla|
|	każdego numeru przerwania są trzy procedury: IRQx_interrupt do	|
|	obsługi zwykłych przerwań, fast_IRQx_interrupt dla przerwań,	|
|	które muszą działać wyjątkowo szybko oraz bad_IRQx_interrupt na	|
|	wypadek, gdyby zdarzyło się przerwanie, dla którego nie ma 	|
|	procedury obsługi.						|
|	Zegar ma prawie takie same makra, z malutką różnicą opisaną przy|
|	definicji makra BUILD_TIMER_IRQ.				|
************************************************************************/

BUILD_TIMER_IRQ(FIRST,0,0x01)
BUILD_IRQ(FIRST,1,0x02)
BUILD_IRQ(FIRST,2,0x04)
BUILD_IRQ(FIRST,3,0x08)
BUILD_IRQ(FIRST,4,0x10)
BUILD_IRQ(FIRST,5,0x20)
BUILD_IRQ(FIRST,6,0x40)
BUILD_IRQ(FIRST,7,0x80)
BUILD_IRQ(SECOND,8,0x01)
BUILD_IRQ(SECOND,9,0x02)
BUILD_IRQ(SECOND,10,0x04)
BUILD_IRQ(SECOND,11,0x08)
BUILD_IRQ(SECOND,12,0x10)
#ifdef __SMP__
BUILD_MSGIRQ(SECOND,13,0x20)
#else
BUILD_IRQ(SECOND,13,0x20)
#endif
BUILD_IRQ(SECOND,14,0x40)
BUILD_IRQ(SECOND,15,0x80)
#ifdef __SMP__
BUILD_RESCHEDIRQ(16)
#endif

/*
 * Pointers to the low-level handlers: first the general ones, then the
 * fast ones, then the bad ones.
 */

/************************************************************************
|	Poniżej znajdują się trzy tablice wskaźników do procedur	|
|	obsługi przerwań. Tablice te nigdy się nie zmieniają, a ich	|
|	elementy są wołane przez tzw. bramy przerwań 			|
|	(ang. interrupt gates) w momencie wywołania przerwania przez	|
|	procesor wskutek otrzymania sygnału od sterownika przerwań.	|
************************************************************************/


static void (*interrupt[17])(void) = {
	IRQ0_interrupt, IRQ1_interrupt, IRQ2_interrupt, IRQ3_interrupt,
	IRQ4_interrupt, IRQ5_interrupt, IRQ6_interrupt, IRQ7_interrupt,
	IRQ8_interrupt, IRQ9_interrupt, IRQ10_interrupt, IRQ11_interrupt,
	IRQ12_interrupt, IRQ13_interrupt, IRQ14_interrupt, IRQ15_interrupt	
#ifdef __SMP__	
	,IRQ16_interrupt
#endif
};

static void (*fast_interrupt[16])(void) = {
	fast_IRQ0_interrupt, fast_IRQ1_interrupt,
	fast_IRQ2_interrupt, fast_IRQ3_interrupt,
	fast_IRQ4_interrupt, fast_IRQ5_interrupt,
	fast_IRQ6_interrupt, fast_IRQ7_interrupt,
	fast_IRQ8_interrupt, fast_IRQ9_interrupt,
	fast_IRQ10_interrupt, fast_IRQ11_interrupt,
	fast_IRQ12_interrupt, fast_IRQ13_interrupt,
	fast_IRQ14_interrupt, fast_IRQ15_interrupt
};

static void (*bad_interrupt[16])(void) = {
	bad_IRQ0_interrupt, bad_IRQ1_interrupt,
	bad_IRQ2_interrupt, bad_IRQ3_interrupt,
	bad_IRQ4_interrupt, bad_IRQ5_interrupt,
	bad_IRQ6_interrupt, bad_IRQ7_interrupt,
	bad_IRQ8_interrupt, bad_IRQ9_interrupt,
	bad_IRQ10_interrupt, bad_IRQ11_interrupt,
	bad_IRQ12_interrupt, bad_IRQ13_interrupt,
	bad_IRQ14_interrupt, bad_IRQ15_interrupt
};

/*
 * Initial irq handlers.
 */

/* dla IRQ, które nie są błędne, ale które chcemy ignorować */
static void no_action(int cpl, void *dev_id, struct pt_regs *regs) { }

#ifdef __SMP__

/*
 * On SMP boards, irq13 is used for interprocessor interrupts (IPI's).
 */
static struct irqaction irq13 = { smp_message_irq, SA_INTERRUPT, 0, "IPI", NULL, NULL };

#else

/*
 * Note that on a 486, we don't want to do a SIGFPE on a irq13
 * as the irq is unreliable, and exception 16 works correctly
 * (ie as explained in the intel literature). On a 386, you
 * can't use exception 16 due to bad IBM design, so we have to
 * rely on the less exact irq13.
 *
 * Careful.. Not only is IRQ13 unreliable, but it is also
 * leads to races. IBM designers who came up with it should
 * be shot.
 */
 

static void math_error_irq(int cpl, void *dev_id, struct pt_regs *regs)
{
	outb(0,0xF0);
	if (ignore_irq13 || !hard_math)
		return;
	math_error();
}

static struct irqaction irq13 = { math_error_irq, 0, 0, "math error", NULL, NULL };

#endif

/*
 * IRQ2 is cascade interrupt to second interrupt controller
 */
/************************************************************************
|	IRQ2 pochodzi od drugiego sterownika przerwań (tzn. przerwanie	|
|	ze sterownika drugiego poprzedzone jest przez IRQ2).Zatem musimy|
|	je po prostu ignorować						|
************************************************************************/

static struct irqaction irq2  = { no_action, 0, 0, "cascade", NULL, NULL};


/************************************************************************
|	Tablica struktur, które zawierają m.in. adresy procedur		|
|	obsługi IRQ.							|
************************************************************************/

static struct irqaction *irq_action[16] = {
	NULL, NULL, NULL, NULL,
	NULL, NULL, NULL, NULL,
	NULL, NULL, NULL, NULL,
	NULL, NULL, NULL, NULL
};


/************************************************************************
|	Na zmienną buf zwraca informację o zainstalowanych procedurach	|
|	obsługi przerwań, ich typach i liczbie wywołań			|
************************************************************************/
int get_irq_list(char *buf)
{
	int i, len = 0;
	struct irqaction * action;

	for (i = 0 ; i < 16 ; i++) {
		action = irq_action[i];
		if (!action) 		/* tylko zainstalowane IRQ */
			continue;

/* format: "nr_irq: liczba_wywołań, czy_szybka, nazwa" 		*/
/* flaga SA_INTERRUPT jest ustawiona, gdy IRQ jest obsługiwane 	*/
/* przez fast_IRQx_interrupt, a nie IRQx_interrupt		*/
		len += sprintf(buf+len, "%2d: %10u %c %s",
			i, kstat.interrupts[i],
			(action->flags & SA_INTERRUPT) ? '+' : ' ',
			action->name);
/* na każdym IRQ znajduje się lista procedur obsługi.		*/
/* Każda ma własną nazwę. Wszystkie mają tak naprawdę tę samą	*/
/* wartość flags & SA_INTERRUPT (por. setup_x86_irq)		*/
		for (action=action->next; action; action = action->next) {
			len += sprintf(buf+len, ",%s %s",
				(action->flags & SA_INTERRUPT) ? " +" : "",
				action->name);
		}
		len += sprintf(buf+len, "\n");
	}
/*
 *	Linus - should you add NMI counts here ?????
 */
#ifdef __SMP_PROF__
	len+=sprintf(buf+len, "IPI: %8lu received\n",
		ipi_count);
#endif		
	return len;
}

#ifdef __SMP_PROF__ 
/************************************************************************
|	Pomijam SMP							|
************************************************************************/

int get_smp_prof_list(char *buf) {
	int i,j, len = 0;
	struct irqaction * action;
	unsigned long sum_spins = 0;
	unsigned long sum_spins_syscall = 0;
	unsigned long sum_spins_sys_idle = 0;
	unsigned long sum_smp_idle_count = 0;

	for (i=0;ihandler)
			continue;
		len += sprintf(buf+len, "%3d: %10d ",
			i, kstat.interrupts[i]);
		for (j=0;j< smp_num_cpus;j++)
			len+=sprintf(buf+len, "%10d ",
				int_count[cpu_logical_map[j]][i]);
		len += sprintf(buf+len, "%c %s",
			(action->flags & SA_INTERRUPT) ? '+' : ' ',
			action->name);
		for (action=action->next; action; action = action->next) {
			len += sprintf(buf+len, ",%s %s",
				(action->flags & SA_INTERRUPT) ? " +" : "",
				action->name);
		}
		len += sprintf(buf+len, "\n");
	}
	len+=sprintf(buf+len, "LCK: %10lu",
		sum_spins);

	for (i=0; i < smp_num_cpus;i++)
		len+=sprintf(buf+len," %10lu",smp_spins[cpu_logical_map[i]]);

	len +=sprintf(buf+len,"   spins from int\n");

	len+=sprintf(buf+len, "LCK: %10lu",
		sum_spins_syscall);

	for (i=0; i < smp_num_cpus;i++)
		len+=sprintf(buf+len," %10lu",smp_spins_syscall[cpu_logical_map[i]]);

	len +=sprintf(buf+len,"   spins from syscall\n");

	len+=sprintf(buf+len, "LCK: %10lu",
		sum_spins_sys_idle);

	for (i=0;i < smp_num_cpus;i++)
		len+=sprintf(buf+len," %10lu",smp_spins_sys_idle[cpu_logical_map[i]]);

	len +=sprintf(buf+len,"   spins from sysidle\n");
	len+=sprintf(buf+len,"IDLE %10lu",sum_smp_idle_count);

	for (i=0;i < smp_num_cpus;i++)
		len+=sprintf(buf+len," %10lu",smp_idle_count[cpu_logical_map[i]]);

	len +=sprintf(buf+len,"   idle ticks\n");

	len+=sprintf(buf+len, "IPI: %10lu   received\n",
		ipi_count);

	return len;
}

#endif 
/************************************************************************
|	Dalszy komentarz...						|
************************************************************************/



/*
 * do_IRQ handles IRQ's that have been installed without the
 * SA_INTERRUPT flag: it uses the full signal-handling return
 * and runs with other interrupts enabled. All relatively slow
 * IRQ's should use this format: notably the keyboard/timer
 * routines.
 */

/************************************************************************
|	Funkcja, która woła zainstalowane procedury obsługi przerwania.	|
|	Dotyczy tylko "zwykłych" przerwań - z wyzerowaną SA_INTERRUPT.	|
|	Przerwania są tu włączone, a po zakończeniu obsługi następuje	|
|	ret_from_sys_call. 						|
|	irq - numer obsługiwanego przerwania 				|
|	regs - wskaźnik do rejestrów odłożonych na stos w momencie	|
|		przyjścia przerwania					|
|	Funkcja ta jest wołana z IRQx_interrupt - warto zobaczyć	|
************************************************************************/
asmlinkage void do_IRQ(int irq, struct pt_regs * regs)
{
	struct irqaction * action = *(irq + irq_action);
	int do_random = 0;

#ifdef __SMP__
	if(smp_threads_ready && active_kernel_processor!=smp_processor_id())
		panic("IRQ %d: active processor set wrongly(%d not %d).\n", irq, active_kernel_processor, smp_processor_id());
#endif
/* gromadzimy informację o liczbie wywołań */
	kstat.interrupts[irq]++;
#ifdef __SMP_PROF__
	int_count[smp_processor_id()][irq]++;
#endif 
/* wykonujemy wszystkie procedury obsługi przerwań z listy dołączonej 	*/
/* do naszego IRQ. Procedurom przekazujemy też informację od jakiego	*/
/* urządzenia dostają to przerwanie.					*/
/* Jeżeli choć jedno z urządzeń na liście ma ustawione SA_SAMPLE_RANDOM,*/
/* to informację o zajściu przerwania przekazujemy do generatora liczb	*/
/* losowych.								*/
	while (action) {
		do_random |= action->flags;
		action->handler(irq, action->dev_id, regs);
		action = action->next;
	}
	if (do_random & SA_SAMPLE_RANDOM)
		add_interrupt_randomness(irq);
}

/*
 * do_fast_IRQ handles IRQ's that don't need the fancy interrupt return
 * stuff - the handler is also running with interrupts disabled unless
 * it explicitly enables them later.
 */

/************************************************************************
|	Funkcja pełniąca identyczną rolę jak do_IRQ oraz niemal z nią	|
|	identyczna. Jest używana do przerwań "szybkich", mających 	|
|	ustawioną flagę SA_INTERRUPT. Jest wołana z fast_IRQx_interrupt.|
|	Różni się od swej "wolnej" siostry jedynie brakiem drugiego	|
|	argumentu - tutaj do procedury obsługi nie są przekazywane	|
|	rejestry. Wynika to m.in. stąd, że "szybkie" przerwania zapisują|
|	jedynie część rejestrów w momencie wywołania.			|
|	Funkcja ta jest wołana (inaczej niż ta "wolna") z wyłączonymi	|
|	przerwaniami.							|
************************************************************************/
asmlinkage void do_fast_IRQ(int irq)
{
	struct irqaction * action = *(irq + irq_action);
	int do_random = 0;
	
#ifdef __SMP__
	/* IRQ 13 is allowed - that's a flush tlb */
	if(smp_threads_ready && active_kernel_processor!=smp_processor_id() && irq!=13)
		panic("fast_IRQ %d: active processor set wrongly(%d not %d).\n", irq, active_kernel_processor, smp_processor_id());
#endif

	kstat.interrupts[irq]++;
#ifdef __SMP_PROF__
	int_count[smp_processor_id()][irq]++;
#endif
	while (action) {
		do_random |= action->flags;
		action->handler(irq, action->dev_id, NULL);
		action = action->next;
	}
	if (do_random & SA_SAMPLE_RANDOM)
		add_interrupt_randomness(irq);
}

/************************************************************************
|	Instaluje nową procedurę obsługi IRQ numer irq. 		|
|	Argument new zawiera pełną informację o tej procedurze.		|
|	Zwraca 0 lub kod błędu.						|
|	UWAGA: new->next musi być równe NULL				|
|	Funkcja ta jest wołana m.in. przez request_irq			|
************************************************************************/	
int setup_x86_irq(int irq, struct irqaction * new)
{
	int shared = 0;
	struct irqaction *old, **p;
	unsigned long flags;

	p = irq_action + irq;
	if ((old = *p) != NULL) {
		/* Can't share interrupts unless both agree to */
		/* SA_SHIRQ pozwala dzielić się jedną linią IRQ		*/
		/* Konieczne jest, by obie strony się na to zgodziły	*/
		/* Obie znaczy: stara i nowa procedura			*/
		if (!(old->flags & new->flags & SA_SHIRQ))
			return -EBUSY;

		/* Can't share interrupts unless both are same type */
		/* Jeżeli mamy się dzielić jedną linią IRQ, to musimy	*/
		/* się zgodzić, czy chcemy "szybką", czy "wolną"	*/
		/* procedurę obsługi.					*/
		if ((old->flags ^ new->flags) & SA_INTERRUPT)
			return -EBUSY;

		/* add new interrupt at end of irq queue */
		/* nową procedurę dodajemy na koniec listy */
		do {
			p = &old->next;
			old = *p;
		} while (old);
		shared = 1;
	}
/* W tym momencie *p jest wskaźnikiem na pole next ostatniego elementu 	*/
/* listy struktur irqaction. W przypadku szczególnym, gdy tej listy nie	*/
/* było (tzn. *(irq + irq_action) == NULL ), to *p wskazuje na miejsce,	*/
/* gdzie ta lista ma się znaleźć (tzn. na irq + irq_action)		*/
/* Tak czy owak chcemy nasze new umieścić w *p				*/

/* Jeżeli new ma być źródłem entropii, to musimy to zaincjalizować.	*/
/* To się wywoła nawet jeżeli inicjalizacja dla tego IRQ została	*/
/* już raz wykonana.							*/
	if (new->flags & SA_SAMPLE_RANDOM)
		rand_initialize_irq(irq);

	save_flags(flags);
	cli();
	*p = new;

/* shared==TRUE, jeśli dołączamy do listy. Wtedy już nic nie robimy	*/
	if (!shared) {
/* SA_INTERRUPT decyduje, czy to ma być "szybka" procedura obsługi	*/
/* Bramy przerwań dla IRQ znajdują się w IDT (tablica deskryptorów	*/
/* przerwań) pod numerami 0x20-0x3F					*/

		if (new->flags & SA_INTERRUPT)
			set_intr_gate(0x20+irq,fast_interrupt[irq]);
		else
			set_intr_gate(0x20+irq,interrupt[irq]);
		unmask_irq(irq);
	}
	restore_flags(flags);
	return 0;
}


/************************************************************************
|	Ta funkcja jest wołana wtedy, gdy ktoś chce zainstalować jakąś	|
|	procedurę obsługi przerwania. Argumenty:			|
|	irq - numer linii IRQ, pod który instalujemy			|
|	handler - adres procedury obsługi				|
|	irqflags - flagi dotyczące tej procedury:			|
|		SA_INTERRUPT - "szybka" procedura (por. do_fast_IRQ)	|
|		SA_SHIRQ - czy zgadzamy się dzielić jedną linię IRQ	|
|				z kimś innym				|
|		SA_SAMPLE_RANDOM - czy jesteśmy źródłem losowych bitów	|
|	devname - nazwa procedury obsługi				|
|	dev_id - dane przekazywane zawsze do procedury obsługi		|
|	Wartość zwracana: 0 lub błąd					|
|	Funkcja dynamicznie alokuje strukturę irqaction, więc może	|
|	wystąpić błąd -ENOMEM.						|
************************************************************************/
int request_irq(unsigned int irq, 
		void (*handler)(int, void *, struct pt_regs *),
		unsigned long irqflags, 
		const char * devname,
		void *dev_id)
{
	int retval;
	struct irqaction * action;

	if (irq > 15)
		return -EINVAL;
	if (!handler)
		return -EINVAL;

	action = (struct irqaction *)kmalloc(sizeof(struct irqaction), GFP_KERNEL);
	if (!action)
		return -ENOMEM;

	action->handler = handler;
	action->flags = irqflags;
	action->mask = 0;
	action->name = devname;
	action->next = NULL;
	action->dev_id = dev_id;

	retval = setup_x86_irq(irq, action);

	if (retval)
		kfree(action);
	return retval;
}

/************************************************************************
|	Usuwa procedurę obsługi identyfikowaną daną dev_id i znajdującą	|
|	się na linii o numerz irq.					|
|	Próba usunięcia nieistniejącej procedury jest błędem.		|
************************************************************************/		
void free_irq(unsigned int irq, void *dev_id)
{
	struct irqaction * action, **p;
	unsigned long flags;

	if (irq > 15) {
		printk("Trying to free IRQ%d\n",irq);
		return;
	}
/* przeszukujemy procedury zainstalowane na linii IRQ, aż znajdziemy	*/
/* taką, która identyfikowana jest przez to samo dev_id			*/
	for (p = irq + irq_action; (action = *p) != NULL; p = &action->next) {
		if (action->dev_id != dev_id)
			continue;

		/* Found it - now free it */
		save_flags(flags);
		cli();		/* ta instrukcja jest bardzo potrzebna */
		*p = action->next;
		/* czy tu nie powinno być !irq_action[irq]??? */
		if (!irq[irq_action]) {
			mask_irq(irq);
			set_intr_gate(0x20+irq,bad_interrupt[irq]);
		}
		restore_flags(flags);
		kfree(action);
		return;
	}
	printk("Trying to free free IRQ%d\n",irq);
}


/************************************************************************
|	Ta funkcja zwraca maskę tych linii IRQ, które są aktywne oraz 	|
|	nie posiadają procedury obsługi (czeka na ich aktywność		|
|	przez 100ms).							|
|	Nie jest prawdziwa informacja z Projektu Linux, że zwracana	|
|	jest maska nieaktywnych przerwań. Do tego celu wystarczyłoby 	|
|	popatrzeć na zmienne cache.		                    	|
************************************************************************/

unsigned long probe_irq_on (void)
{
	unsigned int i, irqs = 0, irqmask;
	unsigned long delay;

	/* first, enable any unassigned irqs */
/* włączamy obsługę dotychczas nieobsługiwanych linii IRQ		*/
/* zmienna irqs ma bit n ustawiony, jeśli dotychczas nie obsługiwano	*/
/* linii numer n.							*/
	for (i = 15; i > 0; i--) {
		if (!irq_action[i]) {
			enable_irq(i);
			irqs |= (1 << i);
		}
	}

	/* wait for spurious interrupts to mask themselves out again */
/* Czekamy około 100ms. Jeżeli któraś z dotychczas nieobsługiwanych linii */
/* okaże się aktywna (tzn. nastąpi na tej linii przerwanie), to wywołane  */
/* zostanie bad_IRQx_interrupt, co spowoduje ustawienie bitu 		  */
/* odpowiadającego tej linii w zmiennych cache.				  */
/* Jeżeli bowiem IRQ x było nieobsługiwane, to bit x w masce:		  */
/*	(cache_A1<<8) | cache_21					  */
/* został przez enable_irq wyzerowany.					  */
/* Jeśli po odblokowaniu wszystkich przerwań przyjdzie przerwanie x, to   */
/* makro ACK_  w bad_IRQx_interrupt zablokuje x i zapisze 1 w zmiennej cache.*/
/* Widać zatem, że jeśli bit x był ustawiony w irqs, a jest wyzerowany w  */
/* (cache_A1<<8) | cache_21, to znaczy, że linia x jest aktywna.	  */
/* Zwracając (irq & ~irqmask) zwracamy maskę tych przerwań, które nie są  */
/* aktywne i nie mają procedur obsługi.				  	  */

	for (delay = jiffies + HZ/10; delay > jiffies; )
		/* about 100ms delay */;

	/* now filter out any obviously spurious interrupts */
	irqmask = (((unsigned int)cache_A1)<<8) | (unsigned int)cache_21;
	return irqs & ~irqmask;
}


/************************************************************************
|	Ta funkcja pobiera maskę irqs przerwań, które nie mają procedur	|
|	obsługi i zwraca najmniejszy numer przerwania x taki, że	|
|	x wystąpiło. Jeżeli żadne z przerwań z irqs nie wystąpiło, to	|
|	zwracane jest 0, jeżeli nastąpiło wiele, to zwracane jest -x	|
************************************************************************/

int probe_irq_off (unsigned long irqs)
{
	unsigned int i, irqmask;

	irqmask = (((unsigned int)cache_A1)<<8) | (unsigned int)cache_21;
#ifdef DEBUG
	printk("probe_irq_off: irqs=0x%04lx irqmask=0x%04x\n", irqs, irqmask);
#endif
	irqs &= irqmask;
/* teraz irqs = te w oryginalnym irqs, które się zablokowały, tzn. te,	*/
/* które wystąpiły.							*/
	if (!irqs)
		return 0;
	i = ffz(~irqs);
/* i = najmniejszy numer z żądanych, który wystąpił */
	if (irqs != (irqs & (1 << i))) /* jeżeli jeszcze jakiś wystąpił...*/
		i = -i; /* ...to zwracamy liczbę ujemną */
	return i;
}


/************************************************************************
|	Inicjalizacja obsługi IRQ. W tym momencie sterownik przerwań	|
|	(8259A) już jest zainicjalizowany i ma wszystkie przerwania 	|
|	zablokowane.							|
************************************************************************/

void init_IRQ(void)
{
	int i;
	static unsigned char smptrap=0;
	if(smptrap)
		return;
	smptrap=1;

	/* set the clock to 100 Hz */
/* ustawiamy zegar ba 100Hz			*/
	outb_p(0x34,0x43);		/* binary, mode 2, LSB/MSB, ch 0 */
	outb_p(LATCH & 0xff , 0x40);	/* LSB */
	outb(LATCH >> 8 , 0x40);	/* MSB */
/* jak na razie żadne przerwania nie mają procedury obsługi */
	for (i = 0; i < 16 ; i++)
		set_intr_gate(0x20+i,bad_interrupt[i]);
	/* This bit is a hack because we don't send timer messages to all processors yet */
	/* It has to be here .. it doesn't work if you put it down the bottom - assembler explodes 8) */
#ifdef __SMP__	
	set_intr_gate(0x20+i, interrupt[i]);	/* IRQ '16' - IPI for rescheduling */
#endif	
/* elegancko zajmujemy porty używane przez sterowniki przerwań:		*/
/*	0x20-0x3F 	Programmable Interrupt Controller - Master	*/
/*	0xA0-0xBF	Programmable Interrupt Controller - Slave	*/
	request_region(0x20,0x20,"pic1");
	request_region(0xa0,0x20,"pic2");
/* ustanawiamy obsługę przerwania IRQ2 - pochodzi od PIC2 - nic nie robi */
	setup_x86_irq(2, &irq2);
/* ustanawiamy obsługę przerwania IRQ13					*/
	setup_x86_irq(13, &irq13);
} 


Autor: Piotr Hoffman