patch-2.4.0-test7 linux/include/linux/mca.h

Next file: linux/include/linux/mm.h
Previous file: linux/include/linux/major.h
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.0-test6/linux/include/linux/mca.h linux/include/linux/mca.h
@@ -1,46 +1,50 @@
 /*
- * Header for Microchannel Architecture Bus 
+ * Header for Microchannel Architecture Bus
  * Written by Martin Kolinek, February 1996
-*/
+ */
 
 #ifndef _LINUX_MCA_H
 #define _LINUX_MCA_H
 
 /* The detection of MCA bus is done in the real mode (using BIOS).
- * The information is exported to the protected code, where this 
+ * The information is exported to the protected code, where this
  * variable is set to one in case MCA bus was detected.
-*/
+ */
 #ifndef MCA_bus__is_a_macro
 extern int  MCA_bus;
 #endif
 
-/* maximal number of MCA slots - actually, some machines have less, but
-they all have sufficient number of POS registers to cover 8. */
+/* Maximal number of MCA slots - actually, some machines have less, but
+ * they all have sufficient number of POS registers to cover 8.
+ */
 #define MCA_MAX_SLOT_NR  8
 
 /* MCA_NOTFOUND is an error condition.  The other two indicate
-	motherboard POS registers contain the adapter.  They might be
-	returned by the mca_find_adapter() function, and can be used as
-	arguments to mca_read_stored_pos().  I'm not going to allow direct
-	access to the motherboard registers until we run across an adapter
-	that requires it.  We don't know enough about them to know if it's
-	safe.
-
-	See Documentation/mca.txt or one of the existing drivers for
-	more information.
-*/
+ * motherboard POS registers contain the adapter.  They might be
+ * returned by the mca_find_adapter() function, and can be used as
+ * arguments to mca_read_stored_pos().  I'm not going to allow direct
+ * access to the motherboard registers until we run across an adapter
+ * that requires it.  We don't know enough about them to know if it's
+ * safe.
+ *
+ * See Documentation/mca.txt or one of the existing drivers for
+ * more information.
+ */
 #define MCA_NOTFOUND	(-1)
 #define MCA_INTEGSCSI	(MCA_MAX_SLOT_NR)
 #define MCA_INTEGVIDEO	(MCA_MAX_SLOT_NR+1)
+#define MCA_MOTHERBOARD (MCA_MAX_SLOT_NR+2)
 
-/* max number of adapters, including both slots and various integrated
-things. */
-#define MCA_NUMADAPTERS (MCA_MAX_SLOT_NR+2)
-
-/* returns the slot of the first enabled adapter matching id.  User can
-specify a starting slot beyond zero, to deal with detecting multiple
-devices.  Returns MCA_NOTFOUND if id not found.  Also checks the
-integrated adapters. */
+/* Max number of adapters, including both slots and various integrated
+ * things.
+ */
+#define MCA_NUMADAPTERS (MCA_MAX_SLOT_NR+3)
+
+/* Returns the slot of the first enabled adapter matching id.  User can
+ * specify a starting slot beyond zero, to deal with detecting multiple
+ * devices.  Returns MCA_NOTFOUND if id not found.  Also checks the
+ * integrated adapters.
+ */
 extern int mca_find_adapter(int id, int start);
 extern int mca_find_unused_adapter(int id, int start);
 
@@ -55,39 +59,37 @@
 /* gets a byte out of POS register (stored in memory) */
 extern unsigned char mca_read_stored_pos(int slot, int reg);
 
-/*
-	This can be expanded later.  Right now, it gives us a way of
-	getting meaningful information into the MCA_info structure,
-	so we can have a more interesting /proc/mca.
-*/
+/* This can be expanded later.  Right now, it gives us a way of
+ * getting meaningful information into the MCA_info structure,
+ * so we can have a more interesting /proc/mca.
+ */
 extern void mca_set_adapter_name(int slot, char* name);
 extern char* mca_get_adapter_name(int slot);
 
-/*
-	This sets up an information callback for /proc/mca/slot?.  The
-	function is called with the buffer, slot, and device pointer (or
-	some equally informative context information, or nothing, if you
-	prefer), and is expected to put useful information into the
-	buffer.  The adapter name, id, and POS registers get printed
-	before this is called though, so don't do it again.
-
-	This should be called with a NULL procfn when a module
-	unregisters, thus preventing kernel crashes and other such
-	nastiness.
-*/
+/* This sets up an information callback for /proc/mca/slot?.  The
+ * function is called with the buffer, slot, and device pointer (or
+ * some equally informative context information, or nothing, if you
+ * prefer), and is expected to put useful information into the
+ * buffer.  The adapter name, id, and POS registers get printed
+ * before this is called though, so don't do it again.
+ *
+ * This should be called with a NULL procfn when a module
+ * unregisters, thus preventing kernel crashes and other such
+ * nastiness.
+ */
 typedef int (*MCA_ProcFn)(char* buf, int slot, void* dev);
 extern void mca_set_adapter_procfn(int slot, MCA_ProcFn, void* dev);
 
 /* These routines actually mess with the hardware POS registers.  They
-temporarily disable the device (and interrupts), so make sure you know
-what you're doing if you use them.  Furthermore, writing to a POS may
-result in two devices trying to share a resource, which in turn can
-result in multiple devices sharing memory spaces, IRQs, or even trashing
-hardware.  YOU HAVE BEEN WARNED.
-
-You can only access slots with this.  Motherboard registers are off
-limits.
-*/
+ * temporarily disable the device (and interrupts), so make sure you know
+ * what you're doing if you use them.  Furthermore, writing to a POS may
+ * result in two devices trying to share a resource, which in turn can
+ * result in multiple devices sharing memory spaces, IRQs, or even trashing
+ * hardware.  YOU HAVE BEEN WARNED.
+ *
+ * You can only access slots with this.  Motherboard registers are off
+ * limits.
+ */
 
 /* read a byte from the specified POS register. */
 extern unsigned char mca_read_pos(int slot, int reg);
@@ -96,7 +98,8 @@
 extern void mca_write_pos(int slot, int reg, unsigned char byte);
 
 /* Should only be called by the NMI interrupt handler, this will do some
-fancy stuff to figure out what might have generated a NMI. */
+ * fancy stuff to figure out what might have generated a NMI.
+ */
 extern void mca_handle_nmi(void);
 
 #endif /* _LINUX_MCA_H */

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)