diff options
Diffstat (limited to 'lib/Utils/backtrace.h')
| -rw-r--r-- | lib/Utils/backtrace.h | 42 |
1 files changed, 21 insertions, 21 deletions
diff --git a/lib/Utils/backtrace.h b/lib/Utils/backtrace.h index dd6d69c2..df5def56 100644 --- a/lib/Utils/backtrace.h +++ b/lib/Utils/backtrace.h @@ -1,10 +1,10 @@ /* Backtrace parsing and processing. - - If we transform analyzer plugins to separate applications one day, - this functionality should be moved to CCpp analyzer, which will - then easily provide what abrt-backtrace utility provides now. Currently - the code is used by abrt-backtrace, so it is shared in the utils + + If we transform analyzer plugins to separate applications one day, + this functionality should be moved to CCpp analyzer, which will + then easily provide what abrt-backtrace utility provides now. Currently + the code is used by abrt-backtrace, so it is shared in the utils library. Copyright (C) 2009, 2010 RedHat inc. @@ -57,8 +57,8 @@ struct thread struct backtrace { struct thread *threads; - /* - * The frame where the crash happened according to GDB. + /* + * The frame where the crash happened according to GDB. * It might be that we can not tell to which thread this frame belongs, * because all threads end with mutually indistinguishable frames. */ @@ -83,16 +83,16 @@ extern void backtrace_print_tree(struct backtrace *backtrace, bool verbose); /* Returns the backtrace tree string representation. */ extern struct strbuf *backtrace_tree_as_str(struct backtrace *backtrace, bool verbose); -/* - * Frees all threads except the one provided as parameters. +/* + * Frees all threads except the one provided as parameters. * It does not check whether one is a member of backtrace. * Caller must know that. */ -extern void backtrace_remove_threads_except_one(struct backtrace *backtrace, +extern void backtrace_remove_threads_except_one(struct backtrace *backtrace, struct thread *one); -/* - * Search all threads and tries to find the one that caused the crash. +/* + * Search all threads and tries to find the one that caused the crash. * It might return NULL if the thread cannot be determined. */ extern struct thread *backtrace_find_crash_thread(struct backtrace *backtrace); @@ -105,24 +105,24 @@ extern void backtrace_limit_frame_depth(struct backtrace *backtrace, int depth); extern void backtrace_remove_exit_handlers(struct backtrace *backtrace); /* - * Removes frames known as not causing crash, but that are often + * Removes frames known as not causing crash, but that are often * a part of a backtrace. */ extern void backtrace_remove_noncrash_frames(struct backtrace *backtrace); /* Parses the backtrace and stores it to a structure. - * @returns + * @returns * Returns the backtrace struct representation, or NULL if the parser failed. * Caller of this function is responsible for backtrace_free()ing the returned value. * Defined in backtrace_parser.y. */ extern struct backtrace *backtrace_parse(char *input, bool debug_parser, bool debug_scanner); -/* Reads the input file and calculates "independent" backtrace from it. "Independent" means - * that the memory addresses that differ from run to run are removed from the backtrace, and +/* Reads the input file and calculates "independent" backtrace from it. "Independent" means + * that the memory addresses that differ from run to run are removed from the backtrace, and * also variable names and values are removed. - * - * This function can be called when backtrace_parse() call fails. It provides a shorter + * + * This function can be called when backtrace_parse() call fails. It provides a shorter * version of backtrace, with a chance that hash calculated from the returned value can be used * to detect duplicates. However, this kind of duplicate detection is very low-quality. * @returns @@ -131,16 +131,16 @@ extern struct backtrace *backtrace_parse(char *input, bool debug_parser, bool de */ extern struct strbuf *independent_backtrace(const char *input); -/* Get the quality of backtrace, as a number of "stars". +/* Get the quality of backtrace, as a number of "stars". * @returns * Value 0 to 4. */ extern int backtrace_rate_old(const char *backtrace); -/* Evaluates the quality of the backtrace, meaning the ratio of frames +/* Evaluates the quality of the backtrace, meaning the ratio of frames * with function name fully known to all frames. * @returns - * A number between 0 and 1. 0 means the lowest quality, + * A number between 0 and 1. 0 means the lowest quality, * 1 means full backtrace is known. */ extern float backtrace_quality(struct backtrace *backtrace); |