[deliverable/linux.git] / drivers / edac / edac_module.c

/*
 * edac_module.c
 *
 * (C) 2007 www.douglaskthompson.com
 * This file is licensed under the terms of the GNU General Public
 * License version 2. This program is licensed "as is" without any
 * warranty of any kind, whether express or implied.
 *
 * Author: Doug Thompson <norsk5@xmission.com>
 *
 */
#include <linux/edac.h>

#include "edac_core.h"
#include "edac_module.h"

#define EDAC_MC_VERSION "Ver: 2.0.4 " __DATE__

#ifdef CONFIG_EDAC_DEBUG
/* Values of 0 to 4 will generate output */
int edac_debug_level = 1;
EXPORT_SYMBOL_GPL(edac_debug_level);
#endif

/* scope is to module level only */
struct workqueue_struct *edac_workqueue;

/*
 * sysfs object: /sys/devices/system/edac
 *	need to export to other files in this modules
 */
static struct sysdev_class edac_class = {
	set_kset_name("edac"),
};
static int edac_class_valid = 0;

/*
 * edac_op_state_toString()
 */
char *edac_op_state_toString(int opstate)
{
	if (opstate == OP_RUNNING_POLL)
		return "POLLED";
	else if (opstate == OP_RUNNING_INTERRUPT)
		return "INTERRUPT";
	else if (opstate == OP_RUNNING_POLL_INTR)
		return "POLL-INTR";
	else if (opstate == OP_ALLOC)
		return "ALLOC";
	else if (opstate == OP_OFFLINE)
		return "OFFLINE";

	return "UNKNOWN";
}

/*
 * edac_get_edac_class()
 *
 *	return pointer to the edac class of 'edac'
 */
struct sysdev_class *edac_get_edac_class(void)
{
	struct sysdev_class *classptr = NULL;

	if (edac_class_valid)
		classptr = &edac_class;

	return classptr;
}

/*
 * edac_register_sysfs_edac_name()
 *
 *	register the 'edac' into /sys/devices/system
 *
 * return:
 *	0  success
 *	!0 error
 */
static int edac_register_sysfs_edac_name(void)
{
	int err;

	/* create the /sys/devices/system/edac directory */
	err = sysdev_class_register(&edac_class);

	if (err) {
		debugf1("%s() error=%d\n", __func__, err);
		return err;
	}

	edac_class_valid = 1;
	return 0;
}

/*
 * sysdev_class_unregister()
 *
 *	unregister the 'edac' from /sys/devices/system
 */
static void edac_unregister_sysfs_edac_name(void)
{
	/* only if currently registered, then unregister it */
	if (edac_class_valid)
		sysdev_class_unregister(&edac_class);

	edac_class_valid = 0;
}

/*
 * edac_workqueue_setup
 *	initialize the edac work queue for polling operations
 */
static int edac_workqueue_setup(void)
{
	edac_workqueue = create_singlethread_workqueue("edac-poller");
	if (edac_workqueue == NULL)
		return -ENODEV;
	else
		return 0;
}

/*
 * edac_workqueue_teardown
 *	teardown the edac workqueue
 */
static void edac_workqueue_teardown(void)
{
	if (edac_workqueue) {
		flush_workqueue(edac_workqueue);
		destroy_workqueue(edac_workqueue);
		edac_workqueue = NULL;
	}
}

/*
 * edac_init
 *      module initialization entry point
 */
static int __init edac_init(void)
{
	int err = 0;

	edac_printk(KERN_INFO, EDAC_MC, EDAC_MC_VERSION "\n");

	/*
	 * Harvest and clear any boot/initialization PCI parity errors
	 *
	 * FIXME: This only clears errors logged by devices present at time of
	 *      module initialization.  We should also do an initial clear
	 *      of each newly hotplugged device.
	 */
	edac_pci_clear_parity_errors();

	/*
	 * perform the registration of the /sys/devices/system/edac object
	 */
	if (edac_register_sysfs_edac_name()) {
		edac_printk(KERN_ERR, EDAC_MC,
			    "Error initializing 'edac' kobject\n");
		err = -ENODEV;
		goto error;
	}

	/* Create the MC sysfs entries, must be first
	 */
	if (edac_sysfs_memctrl_setup()) {
		edac_printk(KERN_ERR, EDAC_MC,
			    "Error initializing sysfs code\n");
		err = -ENODEV;
		goto error_sysfs;
	}

	/* Setup/Initialize the edac_device system */
	err = edac_workqueue_setup();
	if (err) {
		edac_printk(KERN_ERR, EDAC_MC, "init WorkQueue failure\n");
		goto error_mem;
	}

	return 0;

	/* Error teardown stack */
      error_mem:
	edac_sysfs_memctrl_teardown();
      error_sysfs:
	edac_unregister_sysfs_edac_name();
      error:
	return err;
}

/*
 * edac_exit()
 *      module exit/termination function
 */
static void __exit edac_exit(void)
{
	debugf0("%s()\n", __func__);

	/* tear down the various subsystems */
	edac_workqueue_teardown();
	edac_sysfs_memctrl_teardown();
	edac_unregister_sysfs_edac_name();
}

/*
 * Inform the kernel of our entry and exit points
 */
module_init(edac_init);
module_exit(edac_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Doug Thompson www.softwarebitmaker.com, et al");
MODULE_DESCRIPTION("Core library routines for EDAC reporting");

/* refer to *_sysfs.c files for parameters that are exported via sysfs */

#ifdef CONFIG_EDAC_DEBUG
module_param(edac_debug_level, int, 0644);
MODULE_PARM_DESC(edac_debug_level, "Debug level");
#endif
Commit	Line	Data
81d87cb1 DJ	1	/*
	2	* edac_module.c
	3	*
	4	* (C) 2007 www.douglaskthompson.com
	5	* This file is licensed under the terms of the GNU General Public
	6	* License version 2. This program is licensed "as is" without any
	7	* warranty of any kind, whether express or implied.
	8	*
	9	* Author: Doug Thompson <norsk5@xmission.com>
	10	*
	11	*/
c0d12172	12	#include <linux/edac.h>
7c9281d7	13
20bcb7a8	14	#include "edac_core.h"
7c9281d7 DT	15	#include "edac_module.h"
7c9281d7 DT	16
20bcb7a8	17	#define EDAC_MC_VERSION "Ver: 2.0.4 " __DATE__
7c9281d7 DT	18
	19	#ifdef CONFIG_EDAC_DEBUG
	20	/* Values of 0 to 4 will generate output */
	21	int edac_debug_level = 1;
	22	EXPORT_SYMBOL_GPL(edac_debug_level);
	23	#endif
	24
e27e3dac DT	25	/* scope is to module level only */
	26	struct workqueue_struct *edac_workqueue;
	27
e27e3dac DT	28	/*
	29	* sysfs object: /sys/devices/system/edac
	30	* need to export to other files in this modules
	31	*/
	32	static struct sysdev_class edac_class = {
	33	set_kset_name("edac"),
	34	};
	35	static int edac_class_valid = 0;
	36
91b99041 DJ	37	/*
	38	* edac_op_state_toString()
	39	*/
079708b9	40	char *edac_op_state_toString(int opstate)
91b99041 DJ	41	{
	42	if (opstate == OP_RUNNING_POLL)
	43	return "POLLED";
	44	else if (opstate == OP_RUNNING_INTERRUPT)
	45	return "INTERRUPT";
	46	else if (opstate == OP_RUNNING_POLL_INTR)
	47	return "POLL-INTR";
	48	else if (opstate == OP_ALLOC)
	49	return "ALLOC";
	50	else if (opstate == OP_OFFLINE)
	51	return "OFFLINE";
	52
	53	return "UNKNOWN";
	54	}
	55
e27e3dac DT	56	/*
	57	* edac_get_edac_class()
	58	*
	59	* return pointer to the edac class of 'edac'
	60	*/
	61	struct sysdev_class *edac_get_edac_class(void)
	62	{
079708b9	63	struct sysdev_class *classptr = NULL;
e27e3dac DT	64
	65	if (edac_class_valid)
	66	classptr = &edac_class;
	67
	68	return classptr;
	69	}
	70
	71	/*
	72	* edac_register_sysfs_edac_name()
	73	*
	74	* register the 'edac' into /sys/devices/system
	75	*
	76	* return:
	77	* 0 success
	78	* !0 error
	79	*/
	80	static int edac_register_sysfs_edac_name(void)
	81	{
	82	int err;
	83
	84	/* create the /sys/devices/system/edac directory */
	85	err = sysdev_class_register(&edac_class);
	86
	87	if (err) {
	88	debugf1("%s() error=%d\n", __func__, err);
	89	return err;
	90	}
	91
	92	edac_class_valid = 1;
	93	return 0;
	94	}
	95
	96	/*
	97	* sysdev_class_unregister()
	98	*
	99	* unregister the 'edac' from /sys/devices/system
	100	*/
	101	static void edac_unregister_sysfs_edac_name(void)
	102	{
	103	/* only if currently registered, then unregister it */
	104	if (edac_class_valid)
	105	sysdev_class_unregister(&edac_class);
	106
	107	edac_class_valid = 0;
	108	}
	109
e27e3dac DT	110	/*
	111	* edac_workqueue_setup
	112	* initialize the edac work queue for polling operations
	113	*/
	114	static int edac_workqueue_setup(void)
	115	{
	116	edac_workqueue = create_singlethread_workqueue("edac-poller");
	117	if (edac_workqueue == NULL)
	118	return -ENODEV;
	119	else
	120	return 0;
	121	}
	122
	123	/*
	124	* edac_workqueue_teardown
	125	* teardown the edac workqueue
	126	*/
	127	static void edac_workqueue_teardown(void)
	128	{
	129	if (edac_workqueue) {
	130	flush_workqueue(edac_workqueue);
	131	destroy_workqueue(edac_workqueue);
	132	edac_workqueue = NULL;
	133	}
	134	}
	135
7c9281d7 DT	136	/*
	137	* edac_init
	138	* module initialization entry point
	139	*/
	140	static int __init edac_init(void)
	141	{
e27e3dac DT	142	int err = 0;
e27e3dac DT	143
7c9281d7 DT	144	edac_printk(KERN_INFO, EDAC_MC, EDAC_MC_VERSION "\n");
	145
	146	/*
	147	* Harvest and clear any boot/initialization PCI parity errors
	148	*
	149	* FIXME: This only clears errors logged by devices present at time of
079708b9 DT	150	* module initialization. We should also do an initial clear
079708b9 DT	151	* of each newly hotplugged device.
7c9281d7 DT	152	*/
	153	edac_pci_clear_parity_errors();
	154
e27e3dac DT	155	/*
	156	* perform the registration of the /sys/devices/system/edac object
	157	*/
	158	if (edac_register_sysfs_edac_name()) {
	159	edac_printk(KERN_ERR, EDAC_MC,
079708b9	160	"Error initializing 'edac' kobject\n");
e27e3dac DT	161	err = -ENODEV;
	162	goto error;
	163	}
	164
	165	/* Create the MC sysfs entries, must be first
	166	*/
7c9281d7 DT	167	if (edac_sysfs_memctrl_setup()) {
7c9281d7 DT	168	edac_printk(KERN_ERR, EDAC_MC,
079708b9	169	"Error initializing sysfs code\n");
e27e3dac DT	170	err = -ENODEV;
e27e3dac DT	171	goto error_sysfs;
7c9281d7 DT	172	}
7c9281d7 DT	173
e27e3dac DT	174	/* Setup/Initialize the edac_device system */
	175	err = edac_workqueue_setup();
	176	if (err) {
	177	edac_printk(KERN_ERR, EDAC_MC, "init WorkQueue failure\n");
91b99041	178	goto error_mem;
7c9281d7 DT	179	}
7c9281d7 DT	180
7c9281d7	181	return 0;
e27e3dac DT	182
e27e3dac DT	183	/* Error teardown stack */
079708b9	184	error_mem:
e27e3dac	185	edac_sysfs_memctrl_teardown();
079708b9	186	error_sysfs:
e27e3dac	187	edac_unregister_sysfs_edac_name();
079708b9	188	error:
e27e3dac	189	return err;
7c9281d7 DT	190	}
	191
	192	/*
	193	* edac_exit()
	194	* module exit/termination function
	195	*/
	196	static void __exit edac_exit(void)
	197	{
	198	debugf0("%s()\n", __func__);
7c9281d7	199
079708b9	200	/* tear down the various subsystems */
e27e3dac	201	edac_workqueue_teardown();
7c9281d7	202	edac_sysfs_memctrl_teardown();
e27e3dac	203	edac_unregister_sysfs_edac_name();
7c9281d7 DT	204	}
	205
	206	/*
	207	* Inform the kernel of our entry and exit points
	208	*/
	209	module_init(edac_init);
	210	module_exit(edac_exit);
	211
	212	MODULE_LICENSE("GPL");
	213	MODULE_AUTHOR("Doug Thompson www.softwarebitmaker.com, et al");
	214	MODULE_DESCRIPTION("Core library routines for EDAC reporting");
	215
	216	/* refer to _sysfs.c files for parameters that are exported via sysfs /
	217
	218	#ifdef CONFIG_EDAC_DEBUG
	219	module_param(edac_debug_level, int, 0644);
	220	MODULE_PARM_DESC(edac_debug_level, "Debug level");
	221	#endif