1btparser(1) General Commands Manual btparser(1)
2
3
4
6 btparser - a backtrace analyzer
7
9 btparser [option]... [FILE]...
10
12 btparser is a command line tool that analyzes backtraces produced by
13 GDB and provides their textual representation useful for crash duplica‐
14 tion detection.
15
16 By default, btparser prints the backtrace tree created by parsing the
17 input file.
18
19
21 Basic startup options
22
23 -V, --version
24 Displays version of btparser.
25
26 -?, --help
27 Print a help message describing all of btparser’s command-line
28 options.
29
30
31 Actions
32
33 -r, --rate
34 Print a float number between 0 and 1, representing the quality
35 of the backtrace.
36
37 -c, --crash-function
38 Print the name of the function where the program crashed, if
39 it's successfully detected.
40
41 -h, --duplicate-hash
42 Print a short, textual representation of the backtrace, useful
43 for detecting the backtrace duplicates.
44
45 -s, --distances
46 Print Damerau–Levenshtein distances between the backtraces spec‐
47 ified on the command line.
48
49 -g, --dendrogram
50 Cluster backtraces by their distance and print an ASCII repre‐
51 sentation of the dendrogram.
52
53 -l, --clusters=LEVEL
54 Print clusters cut from the dendrogram at the specified level.
55
56
57 Additional options
58
59 -i, --stdin
60 Read input from the standard input rather than file.
61
62 -m, --max-frames=FRAMES
63 When creating optimized backtrace or preparing backtrace for
64 comparison, limit the number of frames to FRAMES. (default 8)
65
66 -z, --min-cluster-size=SIZE
67 When printing clusters, ignore clusters that contain fewer than
68 SIZE objects. (default 2)
69
70 -d, --debug
71 Prints debug information when scanning/parsing the backtrace.
72
73 -v, --verbose
74 Print more output than usual.
75
76
77
78btparser 0.17 24 May 2010 btparser(1)