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.
10 * Author: Huang Ying <ying.huang@intel.com>
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.
22 #include <linux/kernel.h>
23 #include <linux/module.h>
24 #include <linux/uaccess.h>
25 #include <acpi/apei.h>
26 #include <linux/miscdevice.h>
28 #include "apei-internal.h"
30 #define ERST_DBG_PFX "ERST DBG: "
32 #define ERST_DBG_RECORD_LEN_MAX 0x4000
34 static void *erst_dbg_buf
;
35 static unsigned int erst_dbg_buf_len
;
37 /* Prevent erst_dbg_read/write from being invoked concurrently */
38 static DEFINE_MUTEX(erst_dbg_mutex
);
40 static int erst_dbg_open(struct inode
*inode
, struct file
*file
)
47 pos
= (int *)&file
->private_data
;
49 rc
= erst_get_record_id_begin(pos
);
53 return nonseekable_open(inode
, file
);
56 static int erst_dbg_release(struct inode
*inode
, struct file
*file
)
58 erst_get_record_id_end();
63 static long erst_dbg_ioctl(struct file
*f
, unsigned int cmd
, unsigned long arg
)
70 case APEI_ERST_CLEAR_RECORD
:
71 rc
= copy_from_user(&record_id
, (void __user
*)arg
,
75 return erst_clear(record_id
);
76 case APEI_ERST_GET_RECORD_COUNT
:
77 rc
= erst_get_record_count();
81 rc
= put_user(record_count
, (u32 __user
*)arg
);
90 static ssize_t
erst_dbg_read(struct file
*filp
, char __user
*ubuf
,
91 size_t usize
, loff_t
*off
)
100 if (mutex_lock_interruptible(&erst_dbg_mutex
) != 0)
103 pos
= (int *)&filp
->private_data
;
106 rc
= erst_get_record_id_next(pos
, &id
);
110 if (id
== APEI_ERST_INVALID_RECORD_ID
) {
112 * If the persistent store is empty initially, the function
113 * 'erst_read' below will return "-ENOENT" value. This causes
114 * 'retry_next' label is entered again. The returned value
115 * should be zero indicating the read operation is EOF.
122 rc
= len
= erst_read(id
, erst_dbg_buf
, erst_dbg_buf_len
);
123 /* The record may be cleared by others, try read next record */
128 if (len
> ERST_DBG_RECORD_LEN_MAX
) {
129 pr_warning(ERST_DBG_PFX
130 "Record (ID: 0x%llx) length is too long: %zd\n",
135 if (len
> erst_dbg_buf_len
) {
138 p
= kmalloc(len
, GFP_KERNEL
);
143 erst_dbg_buf_len
= len
;
152 if (copy_to_user(ubuf
, erst_dbg_buf
, len
))
156 mutex_unlock(&erst_dbg_mutex
);
157 return rc
? rc
: len
;
160 static ssize_t
erst_dbg_write(struct file
*filp
, const char __user
*ubuf
,
161 size_t usize
, loff_t
*off
)
164 struct cper_record_header
*rcd
;
166 if (!capable(CAP_SYS_ADMIN
))
169 if (usize
> ERST_DBG_RECORD_LEN_MAX
) {
170 pr_err(ERST_DBG_PFX
"Too long record to be written\n");
174 if (mutex_lock_interruptible(&erst_dbg_mutex
))
176 if (usize
> erst_dbg_buf_len
) {
179 p
= kmalloc(usize
, GFP_KERNEL
);
184 erst_dbg_buf_len
= usize
;
186 rc
= copy_from_user(erst_dbg_buf
, ubuf
, usize
);
193 if (rcd
->record_length
!= usize
)
196 rc
= erst_write(erst_dbg_buf
);
199 mutex_unlock(&erst_dbg_mutex
);
200 return rc
< 0 ? rc
: usize
;
203 static const struct file_operations erst_dbg_ops
= {
204 .owner
= THIS_MODULE
,
205 .open
= erst_dbg_open
,
206 .release
= erst_dbg_release
,
207 .read
= erst_dbg_read
,
208 .write
= erst_dbg_write
,
209 .unlocked_ioctl
= erst_dbg_ioctl
,
213 static struct miscdevice erst_dbg_dev
= {
214 .minor
= MISC_DYNAMIC_MINOR
,
216 .fops
= &erst_dbg_ops
,
219 static __init
int erst_dbg_init(void)
222 pr_info(ERST_DBG_PFX
"ERST support is disabled.\n");
225 return misc_register(&erst_dbg_dev
);
228 static __exit
void erst_dbg_exit(void)
230 misc_deregister(&erst_dbg_dev
);
234 module_init(erst_dbg_init
);
235 module_exit(erst_dbg_exit
);
237 MODULE_AUTHOR("Huang Ying");
238 MODULE_DESCRIPTION("APEI Error Record Serialization Table debug support");
239 MODULE_LICENSE("GPL");