Signal Handling API

Prototype for a Signal Handler function. More...

Functions
static void	curses_signal_handler (int sig)
	Catch signals and relay the info to the main program - Implements sig_handler_t -.
static void	curses_exit_handler (int sig)
	Notify the user and shutdown gracefully - Implements sig_handler_t -.
static void	curses_segv_handler (int sig)
	Catch a segfault and print a backtrace - Implements sig_handler_t -.

Detailed Description

Prototype for a Signal Handler function.

Parameters

sig	Signal number, e.g. SIGINT

Function Documentation

curses_signal_handler()

static void curses_signal_handler ( int sig )

static

Catch signals and relay the info to the main program - Implements sig_handler_t -.

Parameters

sig	Signal number, e.g. SIGINT

Definition at line 50 of file mutt_signal.c.

{
  int save_errno = errno;
  enum MuttCursorState old_cursor = MUTT_CURSOR_VISIBLE;
 
  switch (sig)
  {
    case SIGTSTP: /* user requested a suspend */
    {
      const bool c_suspend = cs_subset_bool(NeoMutt->sub, "suspend");
      if (!c_suspend)
        break;
      IsEndwin = isendwin();
      old_cursor = mutt_curses_set_cursor(MUTT_CURSOR_VISIBLE);
      if (!IsEndwin)
        endwin();
      kill(0, SIGSTOP);
    }
      FALLTHROUGH;
 
    case SIGCONT:
      if (!IsEndwin)
        refresh();
      mutt_curses_set_cursor(old_cursor);
      /* We don't receive SIGWINCH when suspended; however, no harm is done by
       * just assuming we received one, and triggering the 'resize' anyway. */
      SigWinch = true;
      break;
 
    case SIGWINCH:
      SigWinch = true;
      break;
 
    case SIGINT:
      SigInt = true;
      break;
  }
  errno = save_errno;
}

Here is the call graph for this function:

Here is the caller graph for this function:

curses_exit_handler()

static void curses_exit_handler ( int sig )

static

Notify the user and shutdown gracefully - Implements sig_handler_t -.

Parameters

sig	Signal number, e.g. SIGTERM

Definition at line 94 of file mutt_signal.c.

{
  mutt_curses_set_cursor(MUTT_CURSOR_VISIBLE);
  endwin(); /* just to be safe */
  mutt_temp_attachments_cleanup();
  mutt_sig_exit_handler(sig); /* DOES NOT RETURN */
}

Here is the call graph for this function:

Here is the caller graph for this function:

curses_segv_handler()

static void curses_segv_handler ( int sig )

static

Catch a segfault and print a backtrace - Implements sig_handler_t -.

Parameters

sig	Signal number, e.g. SIGSEGV

Definition at line 106 of file mutt_signal.c.

{
  mutt_curses_set_cursor(MUTT_CURSOR_VISIBLE);
  endwin(); /* just to be safe */
#ifdef USE_DEBUG_BACKTRACE
  show_backtrace();
#endif
#ifdef USE_DEBUG_GRAPHVIZ
  dump_graphviz("segfault", NULL);
#endif
 
  // Chain the old SEGV handler, it could have been set by ASAN
  if (OldSegvHandler)
    OldSegvHandler(sig);
 
  struct sigaction act = { 0 };
  sigemptyset(&act.sa_mask);
  act.sa_flags = 0;
  act.sa_handler = SIG_DFL;
  sigaction(sig, &act, NULL);
 
  // Re-raise the signal to give outside handlers a chance to deal with it
  raise(sig);
}

Here is the call graph for this function:

Here is the caller graph for this function: