abrt  2.1.11
A tool to inform users about various problems on the running system
libabrt.h
Go to the documentation of this file.
1 /*
2  * Utility routines.
3  *
4  * Licensed under GPLv2, see file COPYING in this tarball for details.
5  */
6 
9 #ifndef LIBABRT_H_
10 #define LIBABRT_H_
11 
12 #include <gio/gio.h> /* dbus */
13 #include "abrt-dbus.h"
14 /* libreport's internal functions we use: */
15 #include <libreport/internal_libreport.h>
16 #include "hooklib.h"
17 
18 #ifdef HAVE_CONFIG_H
19 # include "config.h"
20 #endif
21 
22 /* Must be after #include "config.h" */
23 #if ENABLE_NLS
24 # include <libintl.h>
25 # define _(S) gettext(S)
26 #else
27 # define _(S) (S)
28 #endif
29 
30 #undef NORETURN
31 #define NORETURN __attribute__ ((noreturn))
32 
33 #undef ARRAY_SIZE
34 #define ARRAY_SIZE(x) ((unsigned)(sizeof(x) / sizeof((x)[0])))
35 
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39 
40 /* Some libc's forget to declare these, do it ourself */
41 extern char **environ;
42 #if defined(__GLIBC__) && __GLIBC__ < 2
43 int vdprintf(int d, const char *format, va_list ap);
44 #endif
45 
46 
47 #define low_free_space abrt_low_free_space
48 
54 int low_free_space(unsigned setting_MaxCrashReportsSize, const char *dump_location);
55 
56 #define trim_problem_dirs abrt_trim_problem_dirs
57 void trim_problem_dirs(const char *dirname, double cap_size, const char *exclude_path);
58 #define run_unstrip_n abrt_run_unstrip_n
59 char *run_unstrip_n(const char *dump_dir_name, unsigned timeout_sec);
60 #define get_backtrace abrt_get_backtrace
61 char *get_backtrace(const char *dump_dir_name, unsigned timeout_sec, const char *debuginfo_dirs);
62 
63 
64 #define g_settings_nMaxCrashReportsSize abrt_g_settings_nMaxCrashReportsSize
65 extern unsigned int g_settings_nMaxCrashReportsSize;
66 #define g_settings_sWatchCrashdumpArchiveDir abrt_g_settings_sWatchCrashdumpArchiveDir
67 extern char * g_settings_sWatchCrashdumpArchiveDir;
68 #define g_settings_dump_location abrt_g_settings_dump_location
69 extern char * g_settings_dump_location;
70 #define g_settings_delete_uploaded abrt_g_settings_delete_uploaded
71 extern bool g_settings_delete_uploaded;
72 #define g_settings_autoreporting abrt_g_settings_autoreporting
73 extern bool g_settings_autoreporting;
74 #define g_settings_autoreporting_event abrt_g_settings_autoreporting_event
75 extern char * g_settings_autoreporting_event;
76 #define g_settings_shortenedreporting abrt_g_settings_shortenedreporting
77 extern bool g_settings_shortenedreporting;
78 
79 
80 #define load_abrt_conf abrt_load_abrt_conf
81 int load_abrt_conf(void);
82 #define free_abrt_conf_data abrt_free_abrt_conf_data
83 void free_abrt_conf_data(void);
84 
85 #define load_abrt_conf_file abrt_load_abrt_conf_file
86 int load_abrt_conf_file(const char *file, map_string_t *settings);
87 
88 #define load_abrt_plugin_conf_file abrt_load_abrt_plugin_conf_file
89 int load_abrt_plugin_conf_file(const char *file, map_string_t *settings);
90 
91 #define save_abrt_conf_file abrt_save_abrt_conf_file
92 int save_abrt_conf_file(const char *file, map_string_t *settings);
93 
94 #define save_abrt_plugin_conf_file abrt_save_abrt_plugin_conf_file
95 int save_abrt_plugin_conf_file(const char *file, map_string_t *settings);
96 
97 
98 void migrate_to_xdg_dirs(void);
99 
100 int check_recent_crash_file(const char *filename, const char *executable);
101 
102 /* Returns 1 if abrtd daemon is running, 0 otherwise. */
103 #define daemon_is_ok abrt_daemon_is_ok
104 int daemon_is_ok(void);
105 
111 #define notify_new_path abrt_notify_new_path
112 void notify_new_path(const char *path);
113 
114 /* Note: should be public since unit tests need to call it */
115 #define koops_extract_version abrt_koops_extract_version
116 char *koops_extract_version(const char *line);
117 #define kernel_tainted_short abrt_kernel_tainted_short
118 char *kernel_tainted_short(const char *kernel_bt);
119 #define kernel_tainted_long abrt_kernel_tainted_long
120 char *kernel_tainted_long(const char *tainted_short);
121 #define koops_hash_str abrt_koops_hash_str
122 int koops_hash_str(char hash_str[SHA1_RESULT_LEN*2 + 1], const char *oops_buf);
123 #define koops_extract_oopses abrt_koops_extract_oopses
124 void koops_extract_oopses(GList **oops_list, char *buffer, size_t buflen);
125 #define koops_print_suspicious_strings abrt_koops_print_suspicious_strings
126 void koops_print_suspicious_strings(void);
127 
128 /* dbus client api */
129 
137 int chown_dir_over_dbus(const char *problem_dir_path);
138 
146 int delete_problem_dirs_over_dbus(const GList *problem_dir_paths);
147 
153 problem_data_t *get_problem_data_dbus(const char *problem_dir_path);
154 
161 GList *get_problems_over_dbus(bool authorize);
162 
167 typedef struct ignored_problems ignored_problems_t;
168 
176 ignored_problems_t *ignored_problems_new(char *file_path);
177 
187 
196 void ignored_problems_add(ignored_problems_t *set, const char *problem_id);
197 
206 void ignored_problems_remove(ignored_problems_t *set, const char *problem_id);
207 
218 bool ignored_problems_contains(ignored_problems_t *set, const char *problem_id);
219 
228 void ignored_problems_add_problem_data(ignored_problems_t *set, problem_data_t *pd);
229 
238 void ignored_problems_remove_problem_data(ignored_problems_t *set, problem_data_t *pd);
239 
250 bool ignored_problems_contains_problem_data(ignored_problems_t *set, problem_data_t *pd);
251 
252 #ifdef __cplusplus
253 }
254 #endif
255 
256 #endif
int delete_problem_dirs_over_dbus(const GList *problem_dir_paths)
Delets multiple problems specified by their id (as returned from problem_data_save) ...
void ignored_problems_add_problem_data(ignored_problems_t *set, problem_data_t *pd)
Adds a problem defined by its data to the ignored problems.
GList * get_problems_over_dbus(bool authorize)
Fetches all problems from problem database.
An opaque structure holding a list of ignored problems.
void ignored_problems_remove(ignored_problems_t *set, const char *problem_id)
Removes a problem from the ignored problems.
bool ignored_problems_contains_problem_data(ignored_problems_t *set, problem_data_t *pd)
Checks if a problem defined its data is in the ignored problems.
bool ignored_problems_contains(ignored_problems_t *set, const char *problem_id)
Checks if a problem is in the ignored problems.
ignored_problems_t * ignored_problems_new(char *file_path)
Initializes a new instance of ignored problems.
#define notify_new_path
Sends notification to abrtd that a new problem has been detected.
Definition: libabrt.h:111
void ignored_problems_remove_problem_data(ignored_problems_t *set, problem_data_t *pd)
Removes a problem defined by its data from the ignored problems.
problem_data_t * get_problem_data_dbus(const char *problem_dir_path)
Fetches problem information for specified problem id.
void ignored_problems_free(ignored_problems_t *set)
Destroys an instance of ignored problems.
void ignored_problems_add(ignored_problems_t *set, const char *problem_id)
Adds a problem to the ignored problems.
int low_free_space(unsigned setting_MaxCrashReportsSize, const char *dump_location)
Checks if there is enough free space to store the problem data.
int chown_dir_over_dbus(const char *problem_dir_path)
Changes the access rights of the problem specified by problem id.