remove unnecessary cm_return_val_if_fail()
[claws.git] / src / crash.c
blob52dc9f93810012417a5b0eaa848e6407ee92d63f
1 /*
2 * Claws Mail -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 2002-2015 by the Claws Mail Team
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
19 #ifdef HAVE_CONFIG_H
20 # include <config.h>
21 #endif
23 #ifdef CRASH_DIALOG
25 #include "defs.h"
27 #include <glib.h>
28 #include <glib/gi18n.h>
29 #include <gtk/gtk.h>
30 #include <stdio.h>
31 #include <stdlib.h>
32 #include <signal.h>
33 #include <time.h>
34 #include <sys/types.h>
35 #include <sys/wait.h>
37 #include <errno.h>
38 #include <fcntl.h>
40 #if HAVE_SYS_UTSNAME_H
41 # include <sys/utsname.h>
42 #endif
44 #if defined(__GNU_LIBRARY__) && !defined(__UCLIBC__)
45 # include <gnu/libc-version.h>
46 #endif
48 #include "main.h"
49 #include "claws.h"
50 #include "crash.h"
51 #include "file-utils.h"
52 #include "filesel.h"
53 #include "version.h"
54 #include "prefs_common.h"
55 #include "manage_window.h"
58 * NOTE: the crash dialog is called when claws is not
59 * initialized, so do not assume settings are available.
60 * for example, loading / creating pixmaps seems not
61 * to be possible.
64 /***/
66 static GtkWidget *crash_dialog_show (const gchar *text,
67 const gchar *debug_output);
68 static void crash_create_debugger_file (void);
69 static void crash_save_crash_log (GtkButton *, const gchar *);
70 static void crash_create_bug_report (GtkButton *, const gchar *);
71 static void crash_debug (unsigned long crash_pid,
72 gchar *exe_image,
73 GString *debug_output);
74 static const gchar *get_compiled_in_features (void);
75 static const gchar *get_lib_version (void);
76 static const gchar *get_operating_system (void);
77 static gboolean is_crash_dialog_allowed (void);
78 static void crash_handler (int sig);
79 static void crash_cleanup_exit (void);
81 /***/
83 static const gchar *DEBUG_SCRIPT = "thread all apply\nbt full\nkill\nq";
85 /***/
87 /*!
88 *\brief install crash handlers
90 void crash_install_handlers(void)
92 #if CRASH_DIALOG
93 sigset_t mask;
95 if (!is_crash_dialog_allowed()) return;
97 sigemptyset(&mask);
99 #ifdef SIGSEGV
100 signal(SIGSEGV, crash_handler);
101 sigaddset(&mask, SIGSEGV);
102 #endif
104 #ifdef SIGFPE
105 signal(SIGFPE, crash_handler);
106 sigaddset(&mask, SIGFPE);
107 #endif
109 #ifdef SIGILL
110 signal(SIGILL, crash_handler);
111 sigaddset(&mask, SIGILL);
112 #endif
114 #ifdef SIGABRT
115 signal(SIGABRT, crash_handler);
116 sigaddset(&mask, SIGABRT);
117 #endif
119 sigprocmask(SIG_UNBLOCK, &mask, 0);
120 #endif /* CRASH_DIALOG */
123 /***/
126 *\brief crash dialog entry point
128 void crash_main(const char *arg)
130 #if CRASH_DIALOG
131 gchar *text;
132 gchar **tokens;
133 unsigned long pid;
134 GString *output;
136 crash_create_debugger_file();
137 tokens = g_strsplit(arg, ",", 0);
139 pid = atol(tokens[0]);
140 text = g_strdup_printf(_("Claws Mail process (%ld) received signal %ld"),
141 pid, atol(tokens[1]));
143 output = g_string_new("");
144 crash_debug(pid, tokens[2], output);
147 * try to get the settings
149 prefs_common_read_config();
151 crash_dialog_show(text, output->str);
152 g_string_free(output, TRUE);
153 g_free(text);
154 g_strfreev(tokens);
155 #endif /* CRASH_DIALOG */
159 *\brief show crash dialog
161 *\param text Description
162 *\param debug_output Output text by gdb
164 *\return GtkWidget * Dialog widget
166 static GtkWidget *crash_dialog_show(const gchar *text, const gchar *debug_output)
168 GtkWidget *window1;
169 GtkWidget *vbox1;
170 GtkWidget *hbox1;
171 GtkWidget *label1;
172 GtkWidget *frame1;
173 GtkWidget *scrolledwindow1;
174 GtkWidget *text1;
175 GtkWidget *hbuttonbox3;
176 GtkWidget *hbuttonbox4;
177 GtkWidget *button3;
178 GtkWidget *button4;
179 GtkWidget *button5;
180 gchar *crash_report;
181 GtkTextBuffer *buffer;
182 GtkTextIter iter;
184 window1 = gtkut_window_new(GTK_WINDOW_TOPLEVEL, "crash");
185 gtk_container_set_border_width(GTK_CONTAINER(window1), 5);
186 gtk_window_set_title(GTK_WINDOW(window1), _("Claws Mail has crashed"));
187 gtk_window_set_position(GTK_WINDOW(window1), GTK_WIN_POS_CENTER);
188 gtk_window_set_type_hint(GTK_WINDOW(window1), GDK_WINDOW_TYPE_HINT_DIALOG);
189 gtk_window_set_modal(GTK_WINDOW(window1), TRUE);
190 gtk_window_set_default_size(GTK_WINDOW(window1), 460, 272);
193 vbox1 = gtk_vbox_new(FALSE, 2);
194 gtk_widget_show(vbox1);
195 gtk_container_add(GTK_CONTAINER(window1), vbox1);
197 hbox1 = gtk_hbox_new(FALSE, 4);
198 gtk_widget_show(hbox1);
199 gtk_box_pack_start(GTK_BOX(vbox1), hbox1, FALSE, TRUE, 0);
200 gtk_container_set_border_width(GTK_CONTAINER(hbox1), 4);
202 label1 = gtk_label_new
203 (g_strdup_printf(_("%s.\nPlease file a bug report and include the information below."), text));
204 gtk_widget_show(label1);
205 gtk_box_pack_start(GTK_BOX(hbox1), label1, TRUE, TRUE, 0);
206 gtk_misc_set_alignment(GTK_MISC(label1), 7.45058e-09, 0.5);
208 frame1 = gtk_frame_new(_("Debug log"));
209 gtk_widget_show(frame1);
210 gtk_box_pack_start(GTK_BOX(vbox1), frame1, TRUE, TRUE, 0);
212 scrolledwindow1 = gtk_scrolled_window_new(NULL, NULL);
213 gtk_widget_show(scrolledwindow1);
214 gtk_container_add(GTK_CONTAINER(frame1), scrolledwindow1);
215 gtk_container_set_border_width(GTK_CONTAINER(scrolledwindow1), 3);
216 gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(scrolledwindow1),
217 GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC);
219 text1 = gtk_text_view_new();
220 gtk_text_view_set_editable(GTK_TEXT_VIEW(text1), FALSE);
221 gtk_widget_show(text1);
222 gtk_container_add(GTK_CONTAINER(scrolledwindow1), text1);
224 crash_report = g_strdup_printf(
225 "Claws Mail version %s\n"
226 "GTK+ version %d.%d.%d / GLib %d.%d.%d\n"
227 "Locale: %s (charset: %s)\n"
228 "Features:%s\n"
229 "Operating system: %s\n"
230 "C Library: %s\n--\n%s",
231 VERSION,
232 gtk_major_version, gtk_minor_version, gtk_micro_version,
233 glib_major_version, glib_minor_version, glib_micro_version,
234 conv_get_current_locale(), conv_get_locale_charset_str(),
235 get_compiled_in_features(),
236 get_operating_system(),
237 get_lib_version(),
238 debug_output);
240 buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text1));
241 gtk_text_buffer_get_start_iter(buffer, &iter);
242 gtk_text_buffer_insert(buffer, &iter, crash_report, -1);
244 hbuttonbox3 = gtk_hbutton_box_new();
245 gtk_widget_show(hbuttonbox3);
246 gtk_box_pack_start(GTK_BOX(vbox1), hbuttonbox3, FALSE, FALSE, 0);
248 hbuttonbox4 = gtk_hbutton_box_new();
249 gtk_widget_show(hbuttonbox4);
250 gtk_box_pack_start(GTK_BOX(vbox1), hbuttonbox4, FALSE, FALSE, 0);
252 button3 = gtk_button_new_with_label(_("Close"));
253 gtk_widget_show(button3);
254 gtk_container_add(GTK_CONTAINER(hbuttonbox4), button3);
255 gtk_widget_set_can_default(button3, TRUE);
257 button4 = gtk_button_new_with_label(_("Save..."));
258 gtk_widget_show(button4);
259 gtk_container_add(GTK_CONTAINER(hbuttonbox4), button4);
260 gtk_widget_set_can_default(button4, TRUE);
262 button5 = gtk_button_new_with_label(_("Create bug report"));
263 gtk_widget_show(button5);
264 gtk_container_add(GTK_CONTAINER(hbuttonbox4), button5);
265 gtk_widget_set_can_default(button5, TRUE);
267 g_signal_connect(G_OBJECT(window1), "delete_event",
268 G_CALLBACK(gtk_main_quit), NULL);
269 g_signal_connect(G_OBJECT(button3), "clicked",
270 G_CALLBACK(gtk_main_quit), NULL);
271 g_signal_connect(G_OBJECT(button4), "clicked",
272 G_CALLBACK(crash_save_crash_log), crash_report);
273 g_signal_connect(G_OBJECT(button5), "clicked",
274 G_CALLBACK(crash_create_bug_report), NULL);
276 MANAGE_WINDOW_SIGNALS_CONNECT(window1);
278 gtk_widget_show(window1);
280 gtk_main();
281 return window1;
286 *\brief create debugger script file in claws directory.
287 * all the other options (creating temp files) looked too
288 * convoluted.
290 static void crash_create_debugger_file(void)
292 gchar *filespec = g_strconcat(get_rc_dir(), G_DIR_SEPARATOR_S, DEBUGGERRC, NULL);
294 str_write_to_file(DEBUG_SCRIPT, filespec, TRUE);
295 g_free(filespec);
299 *\brief saves crash log to a file
301 static void crash_save_crash_log(GtkButton *button, const gchar *text)
303 time_t timer;
304 struct tm *lt;
305 char buf[100];
306 struct tm buft;
307 gchar *filename;
309 timer = time(NULL);
310 lt = localtime_r(&timer, &buft);
311 strftime(buf, sizeof buf, "claws-crash-log-%Y-%m-%d-%H-%M-%S.txt", lt);
312 if (NULL != (filename = filesel_select_file_save(_("Save crash information"), buf))
313 && *filename)
314 str_write_to_file(text, filename, TRUE);
315 g_free(filename);
319 *\brief create bug report (goes to Claws Mail bug tracker)
321 static void crash_create_bug_report(GtkButton *button, const gchar *data)
323 open_uri(BUGZILLA_URI, prefs_common_get_uri_cmd());
327 *\brief launches debugger and attaches it to crashed claws
329 static void crash_debug(unsigned long crash_pid,
330 gchar *exe_image,
331 GString *debug_output)
333 int choutput[2];
334 pid_t pid;
336 if (pipe(choutput) == -1) {
337 g_print("can't pipe - error %s", g_strerror(errno));
338 return;
341 if (0 == (pid = fork())) {
342 char *argp[10];
343 char **argptr = argp;
344 gchar *filespec = g_strconcat(get_rc_dir(), G_DIR_SEPARATOR_S, DEBUGGERRC, NULL);
346 if (setgid(getgid()) != 0)
347 perror("setgid");
348 if (setuid(getuid()) != 0)
349 perror("setuid");
352 * setup debugger to attach to crashed claws
354 *argptr++ = "gdb";
355 *argptr++ = "--nw";
356 *argptr++ = "--nx";
357 *argptr++ = "--quiet";
358 *argptr++ = "--batch";
359 *argptr++ = "-x";
360 *argptr++ = filespec;
361 *argptr++ = exe_image;
362 *argptr++ = g_strdup_printf("%ld", crash_pid);
363 *argptr = NULL;
366 * redirect output to write end of pipe
368 close(1);
369 if (dup(choutput[1]) < 0)
370 perror("dup");
371 close(choutput[0]);
372 if (-1 == execvp("gdb", argp))
373 perror("execvp");
374 } else {
375 char buf[100];
376 int r;
378 waitpid(pid, NULL, 0);
381 * make it non blocking
383 if (-1 == fcntl(choutput[0], F_SETFL, O_NONBLOCK))
384 g_print("set to non blocking failed\n");
387 * get the output
389 do {
390 r = read(choutput[0], buf, sizeof buf - 1);
391 if (r > 0) {
392 buf[r] = 0;
393 g_string_append(debug_output, buf);
395 } while (r > 0);
397 close(choutput[0]);
398 close(choutput[1]);
401 * kill the process we attached to
403 kill(crash_pid, SIGCONT);
407 /***/
410 *\brief features
412 static const gchar *get_compiled_in_features(void)
414 return g_strdup_printf("%s",
415 #if INET6
416 " IPv6"
417 #endif
418 #if HAVE_ICONV
419 " iconv"
420 #endif
421 #if HAVE_LIBCOMPFACE
422 " compface"
423 #endif
424 #if USE_GNUTLS
425 " GnuTLS"
426 #endif
427 #if USE_LDAP
428 " LDAP"
429 #endif
430 #if USE_JPILOT
431 " JPilot"
432 #endif
433 #if USE_ENCHANT
434 " GNU/aspell"
435 #endif
436 #if HAVE_LIBETPAN
437 " libetpan"
438 #endif
439 #if HAVE_LIBSM
440 " libSM"
441 #endif
442 "");
445 /***/
448 *\brief library version
450 static const gchar *get_lib_version(void)
452 #if defined(__UCLIBC__)
453 return g_strdup_printf("uClibc %i.%i.%i", __UCLIBC_MAJOR__, __UCLIBC_MINOR__, __UCLIBC_SUBLEVEL__);
454 #elif defined(__GNU_LIBRARY__)
455 return g_strdup_printf("GNU libc %s", gnu_get_libc_version());
456 #else
457 return g_strdup(_("Unknown"));
458 #endif
461 /***/
464 *\brief operating system
466 static const gchar *get_operating_system(void)
468 #if HAVE_SYS_UTSNAME_H
469 struct utsname utsbuf;
470 uname(&utsbuf);
471 return g_strdup_printf("%s %s (%s)",
472 utsbuf.sysname,
473 utsbuf.release,
474 utsbuf.machine);
475 #else
476 return g_strdup(_("Unknown"));
478 #endif
481 /***/
484 *\brief see if the crash dialog is allowed (because some
485 * developers may prefer to run Claws Mail under gdb...)
487 static gboolean is_crash_dialog_allowed(void)
489 return !g_getenv("CLAWS_NO_CRASH");
493 *\brief this handler will probably evolve into
494 * something better.
496 static void crash_handler(int sig)
498 pid_t pid;
499 static volatile unsigned long crashed_ = 0;
502 * let's hope argv0 aren't trashed.
503 * both are defined in main.c.
505 extern gchar *argv0;
509 * besides guarding entrancy it's probably also better
510 * to mask off signals
512 if (crashed_) return;
514 crashed_++;
516 #ifdef SIGTERM
517 if (sig == SIGTERM)
518 clean_quit(NULL);
519 #endif
522 * gnome ungrabs focus, and flushes gdk. mmmh, good idea.
524 gdk_pointer_ungrab(GDK_CURRENT_TIME);
525 gdk_keyboard_ungrab(GDK_CURRENT_TIME);
526 gdk_flush();
528 if (0 == (pid = fork())) {
529 char buf[50];
530 char *args[5];
533 * probably also some other parameters (like GTK+ ones).
534 * also we pass the full startup dir and the real command
535 * line typed in (argv0)
537 args[0] = argv0;
538 args[1] = "--debug";
539 args[2] = "--crash";
540 sprintf(buf, "%d,%d,%s", getppid(), sig, argv0);
541 args[3] = buf;
542 args[4] = NULL;
544 if (chdir(claws_get_startup_dir()) != 0)
545 FILE_OP_ERROR(claws_get_startup_dir(), "chdir");
546 if (setgid(getgid()) != 0)
547 perror("setgid");
548 if (setuid(getuid()) != 0 )
549 perror("setuid");
550 execvp(argv0, args);
551 perror("execvp");
552 } else {
553 waitpid(pid, NULL, 0);
554 crash_cleanup_exit();
555 _exit(253);
558 _exit(253);
562 *\brief put all the things here we can do before
563 * letting the program die
565 static void crash_cleanup_exit(void)
567 const char *filename = claws_get_socket_name();
568 claws_unlink(filename);
571 #endif