2 * APEI Error Record Serialization Table debug support
4 * ERST is a way provided by APEI to save and retrieve hardware error
5 * information to and from a persistent store. This file provide the
6 * debugging/testing support for ERST kernel support and firmware
9 * Copyright 2010 Intel Corp.
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License version
14 * 2 as published by the Free Software Foundation.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 #include <linux/kernel.h>
27 #include <linux/module.h>
28 #include <linux/uaccess.h>
29 #include <acpi/apei.h>
30 #include <linux/miscdevice.h>
32 #include "apei-internal.h"
34 #define ERST_DBG_PFX "ERST DBG: "
36 #define ERST_DBG_RECORD_LEN_MAX 0x4000
38 static void *erst_dbg_buf;
39 static unsigned int erst_dbg_buf_len;
41 /* Prevent erst_dbg_read/write from being invoked concurrently */
42 static DEFINE_MUTEX(erst_dbg_mutex);
44 static int erst_dbg_open(struct inode *inode, struct file *file)
51 pos = (int *)&file->private_data;
53 rc = erst_get_record_id_begin(pos);
57 return nonseekable_open(inode, file);
60 static int erst_dbg_release(struct inode *inode, struct file *file)
62 erst_get_record_id_end();
67 static long erst_dbg_ioctl(struct file *f, unsigned int cmd, unsigned long arg)
74 case APEI_ERST_CLEAR_RECORD:
75 rc = copy_from_user(&record_id, (void __user *)arg,
79 return erst_clear(record_id);
80 case APEI_ERST_GET_RECORD_COUNT:
81 rc = erst_get_record_count();
85 rc = put_user(record_count, (u32 __user *)arg);
94 static ssize_t erst_dbg_read(struct file *filp, char __user *ubuf,
95 size_t usize, loff_t *off)
104 if (mutex_lock_interruptible(&erst_dbg_mutex) != 0)
107 pos = (int *)&filp->private_data;
110 rc = erst_get_record_id_next(pos, &id);
114 if (id == APEI_ERST_INVALID_RECORD_ID) {
116 * If the persistent store is empty initially, the function
117 * 'erst_read' below will return "-ENOENT" value. This causes
118 * 'retry_next' label is entered again. The returned value
119 * should be zero indicating the read operation is EOF.
126 rc = len = erst_read(id, erst_dbg_buf, erst_dbg_buf_len);
127 /* The record may be cleared by others, try read next record */
132 if (len > ERST_DBG_RECORD_LEN_MAX) {
133 pr_warning(ERST_DBG_PFX
134 "Record (ID: 0x%llx) length is too long: %zd\n",
139 if (len > erst_dbg_buf_len) {
142 p = kmalloc(len, GFP_KERNEL);
147 erst_dbg_buf_len = len;
156 if (copy_to_user(ubuf, erst_dbg_buf, len))
160 mutex_unlock(&erst_dbg_mutex);
161 return rc ? rc : len;
164 static ssize_t erst_dbg_write(struct file *filp, const char __user *ubuf,
165 size_t usize, loff_t *off)
168 struct cper_record_header *rcd;
170 if (!capable(CAP_SYS_ADMIN))
173 if (usize > ERST_DBG_RECORD_LEN_MAX) {
174 pr_err(ERST_DBG_PFX "Too long record to be written\n");
178 if (mutex_lock_interruptible(&erst_dbg_mutex))
180 if (usize > erst_dbg_buf_len) {
183 p = kmalloc(usize, GFP_KERNEL);
188 erst_dbg_buf_len = usize;
190 rc = copy_from_user(erst_dbg_buf, ubuf, usize);
197 if (rcd->record_length != usize)
200 rc = erst_write(erst_dbg_buf);
203 mutex_unlock(&erst_dbg_mutex);
204 return rc < 0 ? rc : usize;
207 static const struct file_operations erst_dbg_ops = {
208 .owner = THIS_MODULE,
209 .open = erst_dbg_open,
210 .release = erst_dbg_release,
211 .read = erst_dbg_read,
212 .write = erst_dbg_write,
213 .unlocked_ioctl = erst_dbg_ioctl,
217 static struct miscdevice erst_dbg_dev = {
218 .minor = MISC_DYNAMIC_MINOR,
220 .fops = &erst_dbg_ops,
223 static __init int erst_dbg_init(void)
226 pr_info(ERST_DBG_PFX "ERST support is disabled.\n");
229 return misc_register(&erst_dbg_dev);
232 static __exit void erst_dbg_exit(void)
234 misc_deregister(&erst_dbg_dev);
238 module_init(erst_dbg_init);
239 module_exit(erst_dbg_exit);
241 MODULE_AUTHOR("Huang Ying");
242 MODULE_DESCRIPTION("APEI Error Record Serialization Table debug support");
243 MODULE_LICENSE("GPL");