Blame view

lib/bug.c 4.68 KB
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
1
2
3
4
5
6
7
  /*
    Generic support for BUG()
  
    This respects the following config options:
  
    CONFIG_BUG - emit BUG traps.  Nothing happens without this.
    CONFIG_GENERIC_BUG - enable this code.
b93a531e3   Jan Beulich   allow bug table e...
8
9
    CONFIG_GENERIC_BUG_RELATIVE_POINTERS - use 32-bit pointers relative to
  	the containing struct bug_entry for bug_addr and file.
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
    CONFIG_DEBUG_BUGVERBOSE - emit full file+line information for each BUG
  
    CONFIG_BUG and CONFIG_DEBUG_BUGVERBOSE are potentially user-settable
    (though they're generally always on).
  
    CONFIG_GENERIC_BUG is set by each architecture using this code.
  
    To use this, your architecture must:
  
    1. Set up the config options:
       - Enable CONFIG_GENERIC_BUG if CONFIG_BUG
  
    2. Implement BUG (and optionally BUG_ON, WARN, WARN_ON)
       - Define HAVE_ARCH_BUG
       - Implement BUG() to generate a faulting instruction
       - NOTE: struct bug_entry does not have "file" or "line" entries
         when CONFIG_DEBUG_BUGVERBOSE is not enabled, so you must generate
         the values accordingly.
  
    3. Implement the trap
       - In the illegal instruction trap handler (typically), verify
         that the fault was in kernel mode, and call report_bug()
       - report_bug() will return whether it was a false alarm, a warning,
         or an actual bug.
       - You must implement the is_valid_bugaddr(bugaddr) callback which
         returns true if the eip is a real kernel address, and it points
         to the expected BUG trap instruction.
  
      Jeremy Fitzhardinge <jeremy@goop.org> 2006
   */
c56ba7033   Fabian Frederick   lib/bug.c: conver...
40
41
  
  #define pr_fmt(fmt) fmt
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
42
43
  #include <linux/list.h>
  #include <linux/module.h>
da9eac899   Paul Mundt   lib: taint kernel...
44
  #include <linux/kernel.h>
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
45
  #include <linux/bug.h>
608e26196   Heiko Carstens   generic bug: use ...
46
  #include <linux/sched.h>
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
47
48
  
  extern const struct bug_entry __start___bug_table[], __stop___bug_table[];
b93a531e3   Jan Beulich   allow bug table e...
49
50
51
52
53
54
55
56
  static inline unsigned long bug_addr(const struct bug_entry *bug)
  {
  #ifndef CONFIG_GENERIC_BUG_RELATIVE_POINTERS
  	return bug->bug_addr;
  #else
  	return (unsigned long)bug + bug->bug_addr_disp;
  #endif
  }
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
57
  #ifdef CONFIG_MODULES
1fb9341ac   Rusty Russell   module: put modul...
58
  /* Updates are protected by module mutex */
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
59
60
61
62
63
  static LIST_HEAD(module_bug_list);
  
  static const struct bug_entry *module_find_bug(unsigned long bugaddr)
  {
  	struct module *mod;
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
64
  	const struct bug_entry *bug = NULL;
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
65

0be964be0   Peter Zijlstra   module: Sanitize ...
66
  	rcu_read_lock_sched();
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
67
  	list_for_each_entry_rcu(mod, &module_bug_list, bug_list) {
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
68
  		unsigned i;
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
69
  		bug = mod->bug_table;
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
70
  		for (i = 0; i < mod->num_bugs; ++i, ++bug)
b93a531e3   Jan Beulich   allow bug table e...
71
  			if (bugaddr == bug_addr(bug))
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
72
  				goto out;
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
73
  	}
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
74
75
  	bug = NULL;
  out:
0be964be0   Peter Zijlstra   module: Sanitize ...
76
  	rcu_read_unlock_sched();
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
77
78
  
  	return bug;
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
79
  }
5336377d6   Linus Torvalds   modules: Fix modu...
80
81
  void module_bug_finalize(const Elf_Ehdr *hdr, const Elf_Shdr *sechdrs,
  			 struct module *mod)
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
82
83
84
  {
  	char *secstrings;
  	unsigned int i;
0be964be0   Peter Zijlstra   module: Sanitize ...
85
  	lockdep_assert_held(&module_mutex);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
  	mod->bug_table = NULL;
  	mod->num_bugs = 0;
  
  	/* Find the __bug_table section, if present */
  	secstrings = (char *)hdr + sechdrs[hdr->e_shstrndx].sh_offset;
  	for (i = 1; i < hdr->e_shnum; i++) {
  		if (strcmp(secstrings+sechdrs[i].sh_name, "__bug_table"))
  			continue;
  		mod->bug_table = (void *) sechdrs[i].sh_addr;
  		mod->num_bugs = sechdrs[i].sh_size / sizeof(struct bug_entry);
  		break;
  	}
  
  	/*
  	 * Strictly speaking this should have a spinlock to protect against
  	 * traversals, but since we only traverse on BUG()s, a spinlock
  	 * could potentially lead to deadlock and thus be counter-productive.
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
103
104
  	 * Thus, this uses RCU to safely manipulate the bug list, since BUG
  	 * must run in non-interruptive state.
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
105
  	 */
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
106
  	list_add_rcu(&mod->bug_list, &module_bug_list);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
107
108
109
110
  }
  
  void module_bug_cleanup(struct module *mod)
  {
0be964be0   Peter Zijlstra   module: Sanitize ...
111
  	lockdep_assert_held(&module_mutex);
0286b5ea1   Masami Hiramatsu   lib/bug: Use RCU ...
112
  	list_del_rcu(&mod->bug_list);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
  }
  
  #else
  
  static inline const struct bug_entry *module_find_bug(unsigned long bugaddr)
  {
  	return NULL;
  }
  #endif
  
  const struct bug_entry *find_bug(unsigned long bugaddr)
  {
  	const struct bug_entry *bug;
  
  	for (bug = __start___bug_table; bug < __stop___bug_table; ++bug)
b93a531e3   Jan Beulich   allow bug table e...
128
  		if (bugaddr == bug_addr(bug))
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
129
130
131
132
  			return bug;
  
  	return module_find_bug(bugaddr);
  }
608e26196   Heiko Carstens   generic bug: use ...
133
  enum bug_trap_type report_bug(unsigned long bugaddr, struct pt_regs *regs)
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
134
135
136
137
138
139
140
141
142
  {
  	const struct bug_entry *bug;
  	const char *file;
  	unsigned line, warning;
  
  	if (!is_valid_bugaddr(bugaddr))
  		return BUG_TRAP_TYPE_NONE;
  
  	bug = find_bug(bugaddr);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
143
144
145
146
147
148
  	file = NULL;
  	line = 0;
  	warning = 0;
  
  	if (bug) {
  #ifdef CONFIG_DEBUG_BUGVERBOSE
b93a531e3   Jan Beulich   allow bug table e...
149
  #ifndef CONFIG_GENERIC_BUG_RELATIVE_POINTERS
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
150
  		file = bug->file;
b93a531e3   Jan Beulich   allow bug table e...
151
152
153
  #else
  		file = (const char *)bug + bug->file_disp;
  #endif
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
154
155
156
157
158
159
160
  		line = bug->line;
  #endif
  		warning = (bug->flags & BUGFLAG_WARNING) != 0;
  	}
  
  	if (warning) {
  		/* this is a WARN_ON rather than BUG/BUG_ON */
2553b67a1   Josh Poimboeuf   lib/bug.c: use co...
161
162
  		__warn(file, line, (void *)bugaddr, BUG_GET_TAINT(bug), regs,
  		       NULL);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
163
164
  		return BUG_TRAP_TYPE_WARN;
  	}
b0f4c4b32   Prarit Bhargava   bugs, x86: Fix pr...
165
166
  	printk(KERN_DEFAULT "------------[ cut here ]------------
  ");
e2e7e0932   Anton Blanchard   lib/bug.c: make W...
167

7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
168
  	if (file)
c56ba7033   Fabian Frederick   lib/bug.c: conver...
169
170
  		pr_crit("kernel BUG at %s:%u!
  ", file, line);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
171
  	else
c56ba7033   Fabian Frederick   lib/bug.c: conver...
172
173
174
  		pr_crit("Kernel BUG at %p [verbose debug info unavailable]
  ",
  			(void *)bugaddr);
7664c5a1d   Jeremy Fitzhardinge   [PATCH] Generic B...
175
176
177
  
  	return BUG_TRAP_TYPE_BUG;
  }