Blame glib/gbacktrace.c

Packit ae235b
/* GLIB - Library of useful routines for C programming
Packit ae235b
 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
Packit ae235b
 *
Packit ae235b
 * This library is free software; you can redistribute it and/or
Packit ae235b
 * modify it under the terms of the GNU Lesser General Public
Packit ae235b
 * License as published by the Free Software Foundation; either
Packit ae235b
 * version 2.1 of the License, or (at your option) any later version.
Packit ae235b
 *
Packit ae235b
 * This library is distributed in the hope that it will be useful,
Packit ae235b
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit ae235b
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit ae235b
 * Lesser General Public License for more details.
Packit ae235b
 *
Packit ae235b
 * You should have received a copy of the GNU Lesser General Public
Packit ae235b
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
Packit ae235b
 */
Packit ae235b
Packit ae235b
/*
Packit ae235b
 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
Packit ae235b
 * file for a list of people on the GLib Team.  See the ChangeLog
Packit ae235b
 * files for a list of changes.  These files are distributed with
Packit ae235b
 * GLib at ftp://ftp.gtk.org/pub/gtk/.
Packit ae235b
 */
Packit ae235b
Packit ae235b
/*
Packit ae235b
 * MT safe ; except for g_on_error_stack_trace, but who wants thread safety
Packit ae235b
 * then
Packit ae235b
 */
Packit ae235b
Packit ae235b
#include "config.h"
Packit ae235b
#include "glibconfig.h"
Packit ae235b
Packit ae235b
#include <signal.h>
Packit ae235b
#include <stdarg.h>
Packit ae235b
#include <stdio.h>
Packit ae235b
#include <stdlib.h>
Packit ae235b
Packit ae235b
#ifdef HAVE_SYS_TIME_H
Packit ae235b
#include <sys/time.h>
Packit ae235b
#endif
Packit ae235b
#include <sys/types.h>
Packit ae235b
Packit ae235b
#include <time.h>
Packit ae235b
Packit ae235b
#ifdef G_OS_UNIX
Packit ae235b
#include <unistd.h>
Packit ae235b
#include <sys/wait.h>
Packit ae235b
#ifdef HAVE_SYS_SELECT_H
Packit ae235b
#include <sys/select.h>
Packit ae235b
#endif /* HAVE_SYS_SELECT_H */
Packit ae235b
#endif
Packit ae235b
Packit ae235b
#include <string.h>
Packit ae235b
Packit ae235b
#ifdef G_OS_WIN32
Packit ae235b
#  define STRICT                /* Strict typing, please */
Packit ae235b
#  define _WIN32_WINDOWS 0x0401 /* to get IsDebuggerPresent */
Packit ae235b
#  include <windows.h>
Packit ae235b
#  undef STRICT
Packit ae235b
#else
Packit ae235b
#  include <fcntl.h>
Packit ae235b
#endif
Packit ae235b
Packit ae235b
#include "gbacktrace.h"
Packit ae235b
Packit ae235b
#include "gtypes.h"
Packit ae235b
#include "gmain.h"
Packit ae235b
#include "gprintfint.h"
Packit ae235b
#include "gutils.h"
Packit ae235b
Packit ae235b
Packit ae235b
#ifndef NO_FD_SET
Packit ae235b
#  define SELECT_MASK fd_set
Packit ae235b
#else
Packit ae235b
#  if defined(_IBMR2)
Packit ae235b
#    define SELECT_MASK void
Packit ae235b
#  else
Packit ae235b
#    define SELECT_MASK int
Packit ae235b
#  endif
Packit ae235b
#endif
Packit ae235b
Packit ae235b
Packit ae235b
#ifndef G_OS_WIN32
Packit ae235b
static void stack_trace (char **args);
Packit ae235b
#endif
Packit ae235b
Packit ae235b
/* People want to hit this from their debugger... */
Packit ae235b
GLIB_AVAILABLE_IN_ALL volatile gboolean glib_on_error_halt;
Packit ae235b
volatile gboolean glib_on_error_halt = TRUE;
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_on_error_query:
Packit ae235b
 * @prg_name: the program name, needed by gdb for the "[S]tack trace"
Packit ae235b
 *     option. If @prg_name is %NULL, g_get_prgname() is called to get
Packit ae235b
 *     the program name (which will work correctly if gdk_init() or
Packit ae235b
 *     gtk_init() has been called)
Packit ae235b
 *
Packit ae235b
 * Prompts the user with
Packit ae235b
 * `[E]xit, [H]alt, show [S]tack trace or [P]roceed`.
Packit ae235b
 * This function is intended to be used for debugging use only.
Packit ae235b
 * The following example shows how it can be used together with
Packit ae235b
 * the g_log() functions.
Packit ae235b
 *
Packit ae235b
 * |[
Packit ae235b
 * #include <glib.h>
Packit ae235b
 *
Packit ae235b
 * static void
Packit ae235b
 * log_handler (const gchar   *log_domain,
Packit ae235b
 *              GLogLevelFlags log_level,
Packit ae235b
 *              const gchar   *message,
Packit ae235b
 *              gpointer       user_data)
Packit ae235b
 * {
Packit ae235b
 *   g_log_default_handler (log_domain, log_level, message, user_data);
Packit ae235b
 *
Packit ae235b
 *   g_on_error_query (MY_PROGRAM_NAME);
Packit ae235b
 * }
Packit ae235b
 *
Packit ae235b
 * int
Packit ae235b
 * main (int argc, char *argv[])
Packit ae235b
 * {
Packit ae235b
 *   g_log_set_handler (MY_LOG_DOMAIN,
Packit ae235b
 *                      G_LOG_LEVEL_WARNING |
Packit ae235b
 *                      G_LOG_LEVEL_ERROR |
Packit ae235b
 *                      G_LOG_LEVEL_CRITICAL,
Packit ae235b
 *                      log_handler,
Packit ae235b
 *                      NULL);
Packit ae235b
 *   ...
Packit ae235b
 * ]|
Packit ae235b
 *
Packit ae235b
 * If "[E]xit" is selected, the application terminates with a call
Packit ae235b
 * to _exit(0).
Packit ae235b
 *
Packit ae235b
 * If "[S]tack" trace is selected, g_on_error_stack_trace() is called.
Packit ae235b
 * This invokes gdb, which attaches to the current process and shows
Packit ae235b
 * a stack trace. The prompt is then shown again.
Packit ae235b
 *
Packit ae235b
 * If "[P]roceed" is selected, the function returns.
Packit ae235b
 *
Packit ae235b
 * This function may cause different actions on non-UNIX platforms.
Packit ae235b
 */
Packit ae235b
void
Packit ae235b
g_on_error_query (const gchar *prg_name)
Packit ae235b
{
Packit ae235b
#ifndef G_OS_WIN32
Packit ae235b
  static const gchar * const query1 = "[E]xit, [H]alt";
Packit ae235b
  static const gchar * const query2 = ", show [S]tack trace";
Packit ae235b
  static const gchar * const query3 = " or [P]roceed";
Packit ae235b
  gchar buf[16];
Packit ae235b
Packit ae235b
  if (!prg_name)
Packit ae235b
    prg_name = g_get_prgname ();
Packit ae235b
Packit ae235b
 retry:
Packit ae235b
Packit ae235b
  if (prg_name)
Packit ae235b
    _g_fprintf (stdout,
Packit ae235b
                "%s (pid:%u): %s%s%s: ",
Packit ae235b
                prg_name,
Packit ae235b
                (guint) getpid (),
Packit ae235b
                query1,
Packit ae235b
                query2,
Packit ae235b
                query3);
Packit ae235b
  else
Packit ae235b
    _g_fprintf (stdout,
Packit ae235b
                "(process:%u): %s%s: ",
Packit ae235b
                (guint) getpid (),
Packit ae235b
                query1,
Packit ae235b
                query3);
Packit ae235b
  fflush (stdout);
Packit ae235b
Packit ae235b
  if (isatty(0) && isatty(1))
Packit ae235b
    fgets (buf, 8, stdin);
Packit ae235b
  else
Packit ae235b
    strcpy (buf, "E\n");
Packit ae235b
Packit ae235b
  if ((buf[0] == 'E' || buf[0] == 'e')
Packit ae235b
      && buf[1] == '\n')
Packit ae235b
    _exit (0);
Packit ae235b
  else if ((buf[0] == 'P' || buf[0] == 'p')
Packit ae235b
           && buf[1] == '\n')
Packit ae235b
    return;
Packit ae235b
  else if (prg_name
Packit ae235b
           && (buf[0] == 'S' || buf[0] == 's')
Packit ae235b
           && buf[1] == '\n')
Packit ae235b
    {
Packit ae235b
      g_on_error_stack_trace (prg_name);
Packit ae235b
      goto retry;
Packit ae235b
    }
Packit ae235b
  else if ((buf[0] == 'H' || buf[0] == 'h')
Packit ae235b
           && buf[1] == '\n')
Packit ae235b
    {
Packit ae235b
      while (glib_on_error_halt)
Packit ae235b
        ;
Packit ae235b
      glib_on_error_halt = TRUE;
Packit ae235b
      return;
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    goto retry;
Packit ae235b
#else
Packit ae235b
  if (!prg_name)
Packit ae235b
    prg_name = g_get_prgname ();
Packit ae235b
Packit ae235b
  MessageBox (NULL, "g_on_error_query called, program terminating",
Packit ae235b
              (prg_name && *prg_name) ? prg_name : NULL,
Packit ae235b
              MB_OK|MB_ICONERROR);
Packit ae235b
  _exit(0);
Packit ae235b
#endif
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_on_error_stack_trace:
Packit ae235b
 * @prg_name: the program name, needed by gdb for the "[S]tack trace"
Packit ae235b
 *     option
Packit ae235b
 *
Packit ae235b
 * Invokes gdb, which attaches to the current process and shows a
Packit ae235b
 * stack trace. Called by g_on_error_query() when the "[S]tack trace"
Packit ae235b
 * option is selected. You can get the current process's program name
Packit ae235b
 * with g_get_prgname(), assuming that you have called gtk_init() or
Packit ae235b
 * gdk_init().
Packit ae235b
 *
Packit ae235b
 * This function may cause different actions on non-UNIX platforms.
Packit ae235b
 */
Packit ae235b
void
Packit ae235b
g_on_error_stack_trace (const gchar *prg_name)
Packit ae235b
{
Packit ae235b
#if defined(G_OS_UNIX)
Packit ae235b
  pid_t pid;
Packit ae235b
  gchar buf[16];
Packit ae235b
  gchar *args[4] = { "gdb", NULL, NULL, NULL };
Packit ae235b
  int status;
Packit ae235b
Packit ae235b
  if (!prg_name)
Packit ae235b
    return;
Packit ae235b
Packit ae235b
  _g_sprintf (buf, "%u", (guint) getpid ());
Packit ae235b
Packit ae235b
  args[1] = (gchar*) prg_name;
Packit ae235b
  args[2] = buf;
Packit ae235b
Packit ae235b
  pid = fork ();
Packit ae235b
  if (pid == 0)
Packit ae235b
    {
Packit ae235b
      stack_trace (args);
Packit ae235b
      _exit (0);
Packit ae235b
    }
Packit ae235b
  else if (pid == (pid_t) -1)
Packit ae235b
    {
Packit ae235b
      perror ("unable to fork gdb");
Packit ae235b
      return;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  waitpid (pid, &status, 0);
Packit ae235b
#else
Packit ae235b
  if (IsDebuggerPresent ())
Packit ae235b
    G_BREAKPOINT ();
Packit ae235b
  else
Packit ae235b
    g_abort ();
Packit ae235b
#endif
Packit ae235b
}
Packit ae235b
Packit ae235b
#ifndef G_OS_WIN32
Packit ae235b
Packit ae235b
static gboolean stack_trace_done = FALSE;
Packit ae235b
Packit ae235b
static void
Packit ae235b
stack_trace_sigchld (int signum)
Packit ae235b
{
Packit ae235b
  stack_trace_done = TRUE;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
stack_trace (char **args)
Packit ae235b
{
Packit ae235b
  pid_t pid;
Packit ae235b
  int in_fd[2];
Packit ae235b
  int out_fd[2];
Packit ae235b
  SELECT_MASK fdset;
Packit ae235b
  SELECT_MASK readset;
Packit ae235b
  struct timeval tv;
Packit ae235b
  int sel, idx, state;
Packit ae235b
  char buffer[256];
Packit ae235b
  char c;
Packit ae235b
Packit ae235b
  stack_trace_done = FALSE;
Packit ae235b
  signal (SIGCHLD, stack_trace_sigchld);
Packit ae235b
Packit ae235b
  if ((pipe (in_fd) == -1) || (pipe (out_fd) == -1))
Packit ae235b
    {
Packit ae235b
      perror ("unable to open pipe");
Packit ae235b
      _exit (0);
Packit ae235b
    }
Packit ae235b
Packit ae235b
  pid = fork ();
Packit ae235b
  if (pid == 0)
Packit ae235b
    {
Packit ae235b
      /* Save stderr for printing failure below */
Packit ae235b
      int old_err = dup (2);
Packit ae235b
      fcntl (old_err, F_SETFD, fcntl (old_err, F_GETFD) | FD_CLOEXEC);
Packit ae235b
Packit ae235b
      close (0); dup (in_fd[0]);   /* set the stdin to the in pipe */
Packit ae235b
      close (1); dup (out_fd[1]);  /* set the stdout to the out pipe */
Packit ae235b
      close (2); dup (out_fd[1]);  /* set the stderr to the out pipe */
Packit ae235b
Packit ae235b
      execvp (args[0], args);      /* exec gdb */
Packit ae235b
Packit ae235b
      /* Print failure to original stderr */
Packit ae235b
      close (2); dup (old_err);
Packit ae235b
      perror ("exec gdb failed");
Packit ae235b
      _exit (0);
Packit ae235b
    }
Packit ae235b
  else if (pid == (pid_t) -1)
Packit ae235b
    {
Packit ae235b
      perror ("unable to fork");
Packit ae235b
      _exit (0);
Packit ae235b
    }
Packit ae235b
Packit ae235b
  FD_ZERO (&fdset);
Packit ae235b
  FD_SET (out_fd[0], &fdset);
Packit ae235b
Packit ae235b
  write (in_fd[1], "backtrace\n", 10);
Packit ae235b
  write (in_fd[1], "p x = 0\n", 8);
Packit ae235b
  write (in_fd[1], "quit\n", 5);
Packit ae235b
Packit ae235b
  idx = 0;
Packit ae235b
  state = 0;
Packit ae235b
Packit ae235b
  while (1)
Packit ae235b
    {
Packit ae235b
      readset = fdset;
Packit ae235b
      tv.tv_sec = 1;
Packit ae235b
      tv.tv_usec = 0;
Packit ae235b
Packit ae235b
      sel = select (FD_SETSIZE, &readset, NULL, NULL, &tv;;
Packit ae235b
      if (sel == -1)
Packit ae235b
        break;
Packit ae235b
Packit ae235b
      if ((sel > 0) && (FD_ISSET (out_fd[0], &readset)))
Packit ae235b
        {
Packit ae235b
          if (read (out_fd[0], &c, 1))
Packit ae235b
            {
Packit ae235b
              switch (state)
Packit ae235b
                {
Packit ae235b
                case 0:
Packit ae235b
                  if (c == '#')
Packit ae235b
                    {
Packit ae235b
                      state = 1;
Packit ae235b
                      idx = 0;
Packit ae235b
                      buffer[idx++] = c;
Packit ae235b
                    }
Packit ae235b
                  break;
Packit ae235b
                case 1:
Packit ae235b
                  buffer[idx++] = c;
Packit ae235b
                  if ((c == '\n') || (c == '\r'))
Packit ae235b
                    {
Packit ae235b
                      buffer[idx] = 0;
Packit ae235b
                      _g_fprintf (stdout, "%s", buffer);
Packit ae235b
                      state = 0;
Packit ae235b
                      idx = 0;
Packit ae235b
                    }
Packit ae235b
                  break;
Packit ae235b
                default:
Packit ae235b
                  break;
Packit ae235b
                }
Packit ae235b
            }
Packit ae235b
        }
Packit ae235b
      else if (stack_trace_done)
Packit ae235b
        break;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  close (in_fd[0]);
Packit ae235b
  close (in_fd[1]);
Packit ae235b
  close (out_fd[0]);
Packit ae235b
  close (out_fd[1]);
Packit ae235b
  _exit (0);
Packit ae235b
}
Packit ae235b
Packit ae235b
#endif /* !G_OS_WIN32 */