1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * UBSAN error reporting functions
4 *
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
6 * Author: Andrey Ryabinin <ryabinin.a.a@gmail.com>
7 */
8
9#include <linux/bitops.h>
10#include <linux/bug.h>
11#include <linux/ctype.h>
12#include <linux/init.h>
13#include <linux/kernel.h>
14#include <linux/types.h>
15#include <linux/sched.h>
16#include <linux/uaccess.h>
17#include <linux/ubsan.h>
18#include <kunit/test-bug.h>
19
20#include "ubsan.h"
21
22#if defined(CONFIG_UBSAN_TRAP) || defined(CONFIG_UBSAN_KVM_EL2)
23/*
24 * Only include matches for UBSAN checks that are actually compiled in.
25 * The mappings of struct SanitizerKind (the -fsanitize=xxx args) to
26 * enum SanitizerHandler (the traps) in Clang is in clang/lib/CodeGen/.
27 */
28const char *report_ubsan_failure(u32 check_type)
29{
30 switch (check_type) {
31#ifdef CONFIG_UBSAN_BOUNDS
32 /*
33 * SanitizerKind::ArrayBounds and SanitizerKind::LocalBounds
34 * emit SanitizerHandler::OutOfBounds.
35 */
36 case ubsan_out_of_bounds:
37 return "UBSAN: array index out of bounds";
38#endif
39#ifdef CONFIG_UBSAN_SHIFT
40 /*
41 * SanitizerKind::ShiftBase and SanitizerKind::ShiftExponent
42 * emit SanitizerHandler::ShiftOutOfBounds.
43 */
44 case ubsan_shift_out_of_bounds:
45 return "UBSAN: shift out of bounds";
46#endif
47#if defined(CONFIG_UBSAN_DIV_ZERO) || defined(CONFIG_UBSAN_INTEGER_WRAP)
48 /*
49 * SanitizerKind::IntegerDivideByZero and
50 * SanitizerKind::SignedIntegerOverflow emit
51 * SanitizerHandler::DivremOverflow.
52 */
53 case ubsan_divrem_overflow:
54 return "UBSAN: divide/remainder overflow";
55#endif
56#ifdef CONFIG_UBSAN_UNREACHABLE
57 /*
58 * SanitizerKind::Unreachable emits
59 * SanitizerHandler::BuiltinUnreachable.
60 */
61 case ubsan_builtin_unreachable:
62 return "UBSAN: unreachable code";
63#endif
64#if defined(CONFIG_UBSAN_BOOL) || defined(CONFIG_UBSAN_ENUM)
65 /*
66 * SanitizerKind::Bool and SanitizerKind::Enum emit
67 * SanitizerHandler::LoadInvalidValue.
68 */
69 case ubsan_load_invalid_value:
70 return "UBSAN: loading invalid value";
71#endif
72#ifdef CONFIG_UBSAN_ALIGNMENT
73 /*
74 * SanitizerKind::Alignment emits SanitizerHandler::TypeMismatch
75 * or SanitizerHandler::AlignmentAssumption.
76 */
77 case ubsan_alignment_assumption:
78 return "UBSAN: alignment assumption";
79 case ubsan_type_mismatch:
80 return "UBSAN: type mismatch";
81#endif
82#ifdef CONFIG_UBSAN_INTEGER_WRAP
83 /*
84 * SanitizerKind::SignedIntegerOverflow emits
85 * SanitizerHandler::AddOverflow, SanitizerHandler::SubOverflow,
86 * or SanitizerHandler::MulOverflow.
87 */
88 case ubsan_add_overflow:
89 return "UBSAN: integer addition overflow";
90 case ubsan_sub_overflow:
91 return "UBSAN: integer subtraction overflow";
92 case ubsan_mul_overflow:
93 return "UBSAN: integer multiplication overflow";
94#endif
95 default:
96 return "UBSAN: unrecognized failure code";
97 }
98}
99
100#endif
101
102#ifndef CONFIG_UBSAN_TRAP
103static const char * const type_check_kinds[] = {
104 "load of",
105 "store to",
106 "reference binding to",
107 "member access within",
108 "member call on",
109 "constructor call on",
110 "downcast of",
111 "downcast of"
112};
113
114#define REPORTED_BIT 31
115
116#if (BITS_PER_LONG == 64) && defined(__BIG_ENDIAN)
117#define COLUMN_MASK (~(1U << REPORTED_BIT))
118#define LINE_MASK (~0U)
119#else
120#define COLUMN_MASK (~0U)
121#define LINE_MASK (~(1U << REPORTED_BIT))
122#endif
123
124#define VALUE_LENGTH 40
125
126static bool was_reported(struct source_location *location)
127{
128 return test_and_set_bit(REPORTED_BIT, addr: &location->reported);
129}
130
131static bool suppress_report(struct source_location *loc)
132{
133 return current->in_ubsan || was_reported(location: loc);
134}
135
136static bool type_is_int(struct type_descriptor *type)
137{
138 return type->type_kind == type_kind_int;
139}
140
141static bool type_is_signed(struct type_descriptor *type)
142{
143 WARN_ON(!type_is_int(type));
144 return type->type_info & 1;
145}
146
147static unsigned type_bit_width(struct type_descriptor *type)
148{
149 return 1 << (type->type_info >> 1);
150}
151
152static bool is_inline_int(struct type_descriptor *type)
153{
154 unsigned inline_bits = sizeof(unsigned long)*8;
155 unsigned bits = type_bit_width(type);
156
157 WARN_ON(!type_is_int(type));
158
159 return bits <= inline_bits;
160}
161
162static s_max get_signed_val(struct type_descriptor *type, void *val)
163{
164 if (is_inline_int(type)) {
165 unsigned extra_bits = sizeof(s_max)*8 - type_bit_width(type);
166 unsigned long ulong_val = (unsigned long)val;
167
168 return ((s_max)ulong_val) << extra_bits >> extra_bits;
169 }
170
171 if (type_bit_width(type) == 64)
172 return *(s64 *)val;
173
174 return *(s_max *)val;
175}
176
177static bool val_is_negative(struct type_descriptor *type, void *val)
178{
179 return type_is_signed(type) && get_signed_val(type, val) < 0;
180}
181
182static u_max get_unsigned_val(struct type_descriptor *type, void *val)
183{
184 if (is_inline_int(type))
185 return (unsigned long)val;
186
187 if (type_bit_width(type) == 64)
188 return *(u64 *)val;
189
190 return *(u_max *)val;
191}
192
193static void val_to_string(char *str, size_t size, struct type_descriptor *type,
194 void *value)
195{
196 if (type_is_int(type)) {
197 if (type_bit_width(type) == 128) {
198#if defined(CONFIG_ARCH_SUPPORTS_INT128)
199 u_max val = get_unsigned_val(type, val: value);
200
201 scnprintf(buf: str, size, fmt: "0x%08x%08x%08x%08x",
202 (u32)(val >> 96),
203 (u32)(val >> 64),
204 (u32)(val >> 32),
205 (u32)(val));
206#else
207 WARN_ON(1);
208#endif
209 } else if (type_is_signed(type)) {
210 scnprintf(buf: str, size, fmt: "%lld",
211 (s64)get_signed_val(type, val: value));
212 } else {
213 scnprintf(buf: str, size, fmt: "%llu",
214 (u64)get_unsigned_val(type, val: value));
215 }
216 }
217}
218
219static void ubsan_prologue(struct source_location *loc, const char *reason)
220{
221 current->in_ubsan++;
222
223 pr_warn(CUT_HERE);
224
225 pr_err("UBSAN: %s in %s:%d:%d\n", reason, loc->file_name,
226 loc->line & LINE_MASK, loc->column & COLUMN_MASK);
227
228 kunit_fail_current_test("%s in %s", reason, loc->file_name);
229}
230
231static void ubsan_epilogue(void)
232{
233 dump_stack();
234 pr_warn("---[ end trace ]---\n");
235
236 current->in_ubsan--;
237
238 check_panic_on_warn(origin: "UBSAN");
239}
240
241static void handle_overflow(struct overflow_data *data, void *lhs,
242 void *rhs, char op)
243{
244
245 struct type_descriptor *type = data->type;
246 char lhs_val_str[VALUE_LENGTH];
247 char rhs_val_str[VALUE_LENGTH];
248
249 if (suppress_report(loc: &data->location))
250 return;
251
252 ubsan_prologue(loc: &data->location, reason: type_is_signed(type) ?
253 "signed-integer-overflow" :
254 "unsigned-integer-overflow");
255
256 val_to_string(str: lhs_val_str, size: sizeof(lhs_val_str), type, value: lhs);
257 val_to_string(str: rhs_val_str, size: sizeof(rhs_val_str), type, value: rhs);
258 pr_err("%s %c %s cannot be represented in type %s\n",
259 lhs_val_str,
260 op,
261 rhs_val_str,
262 type->type_name);
263
264 ubsan_epilogue();
265}
266
267void __ubsan_handle_add_overflow(void *data,
268 void *lhs, void *rhs)
269{
270
271 handle_overflow(data, lhs, rhs, op: '+');
272}
273EXPORT_SYMBOL(__ubsan_handle_add_overflow);
274
275void __ubsan_handle_sub_overflow(void *data,
276 void *lhs, void *rhs)
277{
278 handle_overflow(data, lhs, rhs, op: '-');
279}
280EXPORT_SYMBOL(__ubsan_handle_sub_overflow);
281
282void __ubsan_handle_mul_overflow(void *data,
283 void *lhs, void *rhs)
284{
285 handle_overflow(data, lhs, rhs, op: '*');
286}
287EXPORT_SYMBOL(__ubsan_handle_mul_overflow);
288
289void __ubsan_handle_negate_overflow(void *_data, void *old_val)
290{
291 struct overflow_data *data = _data;
292 char old_val_str[VALUE_LENGTH];
293
294 if (suppress_report(loc: &data->location))
295 return;
296
297 ubsan_prologue(loc: &data->location, reason: "negation-overflow");
298
299 val_to_string(str: old_val_str, size: sizeof(old_val_str), type: data->type, value: old_val);
300
301 pr_err("negation of %s cannot be represented in type %s:\n",
302 old_val_str, data->type->type_name);
303
304 ubsan_epilogue();
305}
306EXPORT_SYMBOL(__ubsan_handle_negate_overflow);
307
308void __ubsan_handle_implicit_conversion(void *_data, void *from_val, void *to_val)
309{
310 struct implicit_conversion_data *data = _data;
311 char from_val_str[VALUE_LENGTH];
312 char to_val_str[VALUE_LENGTH];
313
314 if (suppress_report(loc: &data->location))
315 return;
316
317 val_to_string(str: from_val_str, size: sizeof(from_val_str), type: data->from_type, value: from_val);
318 val_to_string(str: to_val_str, size: sizeof(to_val_str), type: data->to_type, value: to_val);
319
320 ubsan_prologue(loc: &data->location, reason: "implicit-conversion");
321
322 pr_err("cannot represent %s value %s during %s %s, truncated to %s\n",
323 data->from_type->type_name,
324 from_val_str,
325 type_check_kinds[data->type_check_kind],
326 data->to_type->type_name,
327 to_val_str);
328
329 ubsan_epilogue();
330}
331EXPORT_SYMBOL(__ubsan_handle_implicit_conversion);
332
333void __ubsan_handle_divrem_overflow(void *_data, void *lhs, void *rhs)
334{
335 struct overflow_data *data = _data;
336 char rhs_val_str[VALUE_LENGTH];
337
338 if (suppress_report(loc: &data->location))
339 return;
340
341 ubsan_prologue(loc: &data->location, reason: "division-overflow");
342
343 val_to_string(str: rhs_val_str, size: sizeof(rhs_val_str), type: data->type, value: rhs);
344
345 if (type_is_signed(type: data->type) && get_signed_val(type: data->type, val: rhs) == -1)
346 pr_err("division of %s by -1 cannot be represented in type %s\n",
347 rhs_val_str, data->type->type_name);
348 else
349 pr_err("division by zero\n");
350
351 ubsan_epilogue();
352}
353EXPORT_SYMBOL(__ubsan_handle_divrem_overflow);
354
355static void handle_null_ptr_deref(struct type_mismatch_data_common *data)
356{
357 if (suppress_report(loc: data->location))
358 return;
359
360 ubsan_prologue(loc: data->location, reason: "null-ptr-deref");
361
362 pr_err("%s null pointer of type %s\n",
363 type_check_kinds[data->type_check_kind],
364 data->type->type_name);
365
366 ubsan_epilogue();
367}
368
369static void handle_misaligned_access(struct type_mismatch_data_common *data,
370 unsigned long ptr)
371{
372 if (suppress_report(loc: data->location))
373 return;
374
375 ubsan_prologue(loc: data->location, reason: "misaligned-access");
376
377 pr_err("%s misaligned address %p for type %s\n",
378 type_check_kinds[data->type_check_kind],
379 (void *)ptr, data->type->type_name);
380 pr_err("which requires %ld byte alignment\n", data->alignment);
381
382 ubsan_epilogue();
383}
384
385static void handle_object_size_mismatch(struct type_mismatch_data_common *data,
386 unsigned long ptr)
387{
388 if (suppress_report(loc: data->location))
389 return;
390
391 ubsan_prologue(loc: data->location, reason: "object-size-mismatch");
392 pr_err("%s address %p with insufficient space\n",
393 type_check_kinds[data->type_check_kind],
394 (void *) ptr);
395 pr_err("for an object of type %s\n", data->type->type_name);
396 ubsan_epilogue();
397}
398
399static void ubsan_type_mismatch_common(struct type_mismatch_data_common *data,
400 unsigned long ptr)
401{
402 unsigned long flags = user_access_save();
403
404 if (!ptr)
405 handle_null_ptr_deref(data);
406 else if (data->alignment && !IS_ALIGNED(ptr, data->alignment))
407 handle_misaligned_access(data, ptr);
408 else
409 handle_object_size_mismatch(data, ptr);
410
411 user_access_restore(flags);
412}
413
414void __ubsan_handle_type_mismatch(struct type_mismatch_data *data,
415 void *ptr)
416{
417 struct type_mismatch_data_common common_data = {
418 .location = &data->location,
419 .type = data->type,
420 .alignment = data->alignment,
421 .type_check_kind = data->type_check_kind
422 };
423
424 ubsan_type_mismatch_common(data: &common_data, ptr: (unsigned long)ptr);
425}
426EXPORT_SYMBOL(__ubsan_handle_type_mismatch);
427
428void __ubsan_handle_type_mismatch_v1(void *_data, void *ptr)
429{
430 struct type_mismatch_data_v1 *data = _data;
431 struct type_mismatch_data_common common_data = {
432 .location = &data->location,
433 .type = data->type,
434 .alignment = 1UL << data->log_alignment,
435 .type_check_kind = data->type_check_kind
436 };
437
438 ubsan_type_mismatch_common(data: &common_data, ptr: (unsigned long)ptr);
439}
440EXPORT_SYMBOL(__ubsan_handle_type_mismatch_v1);
441
442void __ubsan_handle_out_of_bounds(void *_data, void *index)
443{
444 struct out_of_bounds_data *data = _data;
445 char index_str[VALUE_LENGTH];
446
447 if (suppress_report(loc: &data->location))
448 return;
449
450 ubsan_prologue(loc: &data->location, reason: "array-index-out-of-bounds");
451
452 val_to_string(str: index_str, size: sizeof(index_str), type: data->index_type, value: index);
453 pr_err("index %s is out of range for type %s\n", index_str,
454 data->array_type->type_name);
455 ubsan_epilogue();
456}
457EXPORT_SYMBOL(__ubsan_handle_out_of_bounds);
458
459void __ubsan_handle_shift_out_of_bounds(void *_data, void *lhs, void *rhs)
460{
461 struct shift_out_of_bounds_data *data = _data;
462 struct type_descriptor *rhs_type = data->rhs_type;
463 struct type_descriptor *lhs_type = data->lhs_type;
464 char rhs_str[VALUE_LENGTH];
465 char lhs_str[VALUE_LENGTH];
466 unsigned long ua_flags = user_access_save();
467
468 if (suppress_report(loc: &data->location))
469 goto out;
470
471 ubsan_prologue(loc: &data->location, reason: "shift-out-of-bounds");
472
473 val_to_string(str: rhs_str, size: sizeof(rhs_str), type: rhs_type, value: rhs);
474 val_to_string(str: lhs_str, size: sizeof(lhs_str), type: lhs_type, value: lhs);
475
476 if (val_is_negative(type: rhs_type, val: rhs))
477 pr_err("shift exponent %s is negative\n", rhs_str);
478
479 else if (get_unsigned_val(type: rhs_type, val: rhs) >=
480 type_bit_width(type: lhs_type))
481 pr_err("shift exponent %s is too large for %u-bit type %s\n",
482 rhs_str,
483 type_bit_width(lhs_type),
484 lhs_type->type_name);
485 else if (val_is_negative(type: lhs_type, val: lhs))
486 pr_err("left shift of negative value %s\n",
487 lhs_str);
488 else
489 pr_err("left shift of %s by %s places cannot be"
490 " represented in type %s\n",
491 lhs_str, rhs_str,
492 lhs_type->type_name);
493
494 ubsan_epilogue();
495out:
496 user_access_restore(ua_flags);
497}
498EXPORT_SYMBOL(__ubsan_handle_shift_out_of_bounds);
499
500
501void __ubsan_handle_builtin_unreachable(void *_data)
502{
503 struct unreachable_data *data = _data;
504 ubsan_prologue(loc: &data->location, reason: "unreachable");
505 pr_err("calling __builtin_unreachable()\n");
506 ubsan_epilogue();
507 panic(fmt: "can't return from __builtin_unreachable()");
508}
509EXPORT_SYMBOL(__ubsan_handle_builtin_unreachable);
510
511void __ubsan_handle_load_invalid_value(void *_data, void *val)
512{
513 struct invalid_value_data *data = _data;
514 char val_str[VALUE_LENGTH];
515 unsigned long ua_flags = user_access_save();
516
517 if (suppress_report(loc: &data->location))
518 goto out;
519
520 ubsan_prologue(loc: &data->location, reason: "invalid-load");
521
522 val_to_string(str: val_str, size: sizeof(val_str), type: data->type, value: val);
523
524 pr_err("load of value %s is not a valid value for type %s\n",
525 val_str, data->type->type_name);
526
527 ubsan_epilogue();
528out:
529 user_access_restore(ua_flags);
530}
531EXPORT_SYMBOL(__ubsan_handle_load_invalid_value);
532
533void __ubsan_handle_alignment_assumption(void *_data, unsigned long ptr,
534 unsigned long align,
535 unsigned long offset)
536{
537 struct alignment_assumption_data *data = _data;
538 unsigned long real_ptr;
539
540 if (suppress_report(loc: &data->location))
541 return;
542
543 ubsan_prologue(loc: &data->location, reason: "alignment-assumption");
544
545 if (offset)
546 pr_err("assumption of %lu byte alignment (with offset of %lu byte) for pointer of type %s failed",
547 align, offset, data->type->type_name);
548 else
549 pr_err("assumption of %lu byte alignment for pointer of type %s failed",
550 align, data->type->type_name);
551
552 real_ptr = ptr - offset;
553 pr_err("%saddress is %lu aligned, misalignment offset is %lu bytes",
554 offset ? "offset " : "", BIT(real_ptr ? __ffs(real_ptr) : 0),
555 real_ptr & (align - 1));
556
557 ubsan_epilogue();
558}
559EXPORT_SYMBOL(__ubsan_handle_alignment_assumption);
560
561#endif /* !CONFIG_UBSAN_TRAP */
562

Provided by KDAB

Privacy Policy
Improve your Profiling and Debugging skills
Find out more

source code of linux/lib/ubsan.c