mirror of
https://github.com/llvm/llvm-project.git
synced 2025-04-26 09:06:07 +00:00

The builtin causes the program to stop its execution abnormally and shows a human-readable description of the reason for the termination when a debugger is attached or in a symbolicated crash log. The motivation for the builtin is explained in the following RFC: https://discourse.llvm.org/t/rfc-adding-builtin-verbose-trap-string-literal/75845 clang's CodeGen lowers the builtin to `llvm.trap` and emits debugging information that represents an artificial inline frame whose name encodes the category and reason strings passed to the builtin.
55 lines
2.7 KiB
C++
55 lines
2.7 KiB
C++
// RUN: %clang_cc1 -triple arm64-apple-ios -std=c++20 -emit-llvm -debug-info-kind=limited %s -o - | FileCheck %s
|
|
|
|
// CHECK-LABEL: define void @_Z2f0v()
|
|
// CHECK: call void @llvm.trap(), !dbg ![[LOC17:.*]]
|
|
|
|
// CHECK: declare void @llvm.trap() #[[ATTR1:.*]]
|
|
|
|
// CHECK-LABEL: define void @_Z2f1v()
|
|
// CHECK: call void @llvm.trap(), !dbg ![[LOC23:.*]]
|
|
// CHECK: call void @llvm.trap(), !dbg ![[LOC25:.*]]
|
|
|
|
// CHECK-LABEL: define void @_Z2f3v()
|
|
// CHECK: call void @_Z2f2IXadsoKcL_ZL8constCatEEEXadsoS0_L_ZL8constMsgEEEEvv()
|
|
|
|
// CHECK-LABEL: define internal void @_Z2f2IXadsoKcL_ZL8constCatEEEXadsoS0_L_ZL8constMsgEEEEvv
|
|
// CHECK: call void @llvm.trap(), !dbg ![[LOC36:.*]]
|
|
|
|
// CHECK: attributes #[[ATTR1]] = { cold {{.*}}}
|
|
|
|
// CHECK: ![[FILESCOPE:.*]] = !DIFile(filename: "{{.*}}debug-info-verbose-trap.cpp"
|
|
|
|
char const constCat[] = "category2";
|
|
char const constMsg[] = "hello";
|
|
|
|
// CHECK: ![[SUBPROG14:.*]] = distinct !DISubprogram(name: "f0", linkageName: "_Z2f0v",
|
|
// CHECK: ![[LOC17]] = !DILocation(line: 0, scope: ![[SUBPROG18:.*]], inlinedAt: ![[LOC20:.*]])
|
|
// CHECK: ![[SUBPROG18]] = distinct !DISubprogram(name: "__clang_trap_msg$category1$Argument_must_not_be_null", scope: ![[FILESCOPE]], file: ![[FILESCOPE]], type: !{{.*}}, flags: DIFlagArtificial, spFlags: DISPFlagDefinition, unit: !{{.*}})
|
|
// CHECK: ![[LOC20]] = !DILocation(line: [[@LINE+2]], column: 3, scope: ![[SUBPROG14]])
|
|
void f0() {
|
|
__builtin_verbose_trap("category1", "Argument_must_not_be_null");
|
|
}
|
|
|
|
// CHECK: ![[SUBPROG22:.*]] = distinct !DISubprogram(name: "f1", linkageName: "_Z2f1v",
|
|
// CHECK: ![[LOC23]] = !DILocation(line: 0, scope: ![[SUBPROG18]], inlinedAt: ![[LOC24:.*]])
|
|
// CHECK: ![[LOC24]] = !DILocation(line: [[@LINE+5]], column: 3, scope: ![[SUBPROG22]])
|
|
// CHECK: ![[LOC25]] = !DILocation(line: 0, scope: ![[SUBPROG26:.*]], inlinedAt: ![[LOC27:.*]])
|
|
// CHECK: ![[SUBPROG26]] = distinct !DISubprogram(name: "__clang_trap_msg$category2$hello", scope: ![[FILESCOPE]], file: ![[FILESCOPE]], type: !{{.*}}, flags: DIFlagArtificial, spFlags: DISPFlagDefinition, unit: !{{.*}})
|
|
// CHECK: ![[LOC27]] = !DILocation(line: [[@LINE+3]], column: 3, scope: ![[SUBPROG22]])
|
|
void f1() {
|
|
__builtin_verbose_trap("category1", "Argument_must_not_be_null");
|
|
__builtin_verbose_trap("category2", "hello");
|
|
}
|
|
|
|
// CHECK: ![[SUBPROG32:.*]] = distinct !DISubprogram(name: "f2<constCat, constMsg>", linkageName: "_Z2f2IXadsoKcL_ZL8constCatEEEXadsoS0_L_ZL8constMsgEEEEvv",
|
|
// CHECK: ![[LOC36]] = !DILocation(line: 0, scope: ![[SUBPROG26]], inlinedAt: ![[LOC37:.*]])
|
|
// CHECK: ![[LOC37]] = !DILocation(line: [[@LINE+3]], column: 3, scope: ![[SUBPROG32]])
|
|
template <const char * const category, const char * const reason>
|
|
void f2() {
|
|
__builtin_verbose_trap(category, reason);
|
|
}
|
|
|
|
void f3() {
|
|
f2<constCat, constMsg>();
|
|
}
|