signal.c File Reference

Signal handling. More...

#include "config.h"
#include <stddef.h>
#include <signal.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "message.h"
#include "signal2.h"

Include dependency graph for signal.c:

Go to the source code of this file.

Functions
void	mutt_sig_empty_handler (int sig)
	Dummy signal handler. More...
void	mutt_sig_exit_handler (int sig)
	Notify the user and shutdown gracefully. More...
void	mutt_sig_init (sig_handler_t sig_fn, sig_handler_t exit_fn, sig_handler_t segv_fn)
	Initialise the signal handling. More...
void	mutt_sig_block (void)
	Block signals during critical operations. More...
void	mutt_sig_unblock (void)
	Restore previously blocked signals. More...
void	mutt_sig_block_system (void)
	Block signals before calling exec() More...
void	mutt_sig_unblock_system (bool restore)
	Restore previously blocked signals. More...
void	mutt_sig_allow_interrupt (bool allow)
	Allow/disallow Ctrl-C (SIGINT) More...

Variables
static sigset_t	Sigset
static sigset_t	SigsetSys
static struct sigaction	SysOldInt
static struct sigaction	SysOldQuit
static bool	SignalsBlocked
static bool	SysSignalsBlocked
static sig_handler_t	sig_handler = mutt_sig_empty_handler
static sig_handler_t	exit_handler = mutt_sig_exit_handler
static sig_handler_t	segv_handler = mutt_sig_exit_handler

Detailed Description

Signal handling.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file signal.c.

Function Documentation

mutt_sig_empty_handler()

void mutt_sig_empty_handler

(

int

sig

)

Dummy signal handler.

Parameters

sig	Signal number, e.g. SIGINT

Useful for signals that we can't ignore, or don't want to do anything with.

Definition at line 57 of file signal.c.

{
}

Here is the caller graph for this function:

mutt_sig_exit_handler()

void mutt_sig_exit_handler

(

int

sig

)

Notify the user and shutdown gracefully.

Parameters

sig	Signal number, e.g. SIGINT

Definition at line 65 of file signal.c.

{
#ifdef HAVE_DECL_SYS_SIGLIST
  printf(_("Caught signal %d (%s) ...  Exiting\n"), sig, sys_siglist[sig]);
#elif (defined(__sun__) && defined(__svr4__))
  printf(_("Caught signal %d (%s) ...  Exiting\n"), sig, _sys_siglist[sig]);
#elif (defined(__alpha) && defined(__osf__))
  printf(_("Caught signal %d (%s) ...  Exiting\n"), sig, __sys_siglist[sig]);
#else
  printf(_("Caught signal %d ...  Exiting\n"), sig);
#endif
  exit(0);
}

Here is the caller graph for this function:

mutt_sig_init()

void mutt_sig_init	(	sig_handler_t	sig_fn,
		sig_handler_t	exit_fn,
		sig_handler_t	segv_fn
	)

Initialise the signal handling.

Parameters

sig_fn	Function to handle signals
exit_fn	Function to call on uncaught signals
segv_fn	Function to call on a segfault (Segmentation Violation)

Set up handlers to ignore or catch signals of interest. We use three handlers for the signals we want to catch, ignore, or exit.

Definition at line 88 of file signal.c.

{
  if (sig_fn)
    sig_handler = sig_fn;
 
  if (exit_fn)
    exit_handler = exit_fn;
 
  if (segv_fn)
    segv_handler = segv_fn;
 
  struct sigaction act;
 
  sigemptyset(&act.sa_mask);
  act.sa_flags = 0;
  act.sa_handler = SIG_IGN;
  sigaction(SIGPIPE, &act, NULL);
 
  act.sa_handler = segv_handler;
  sigaction(SIGSEGV, &act, NULL);
 
  act.sa_handler = exit_handler;
  sigaction(SIGTERM, &act, NULL);
  sigaction(SIGHUP, &act, NULL);
  sigaction(SIGQUIT, &act, NULL);
 
  /* we want to avoid race conditions */
  sigaddset(&act.sa_mask, SIGTSTP);
 
  act.sa_handler = sig_handler;
 
  /* we want SIGALRM to abort the current syscall, so we do this before
   * setting the SA_RESTART flag below.  currently this is only used to
   * timeout on a connect() call in a reasonable amount of time. */
  sigaction(SIGALRM, &act, NULL);
 
/* we also don't want to mess with interrupted system calls */
#ifdef SA_RESTART
  act.sa_flags = SA_RESTART;
#endif
 
  sigaction(SIGCONT, &act, NULL);
  sigaction(SIGTSTP, &act, NULL);
  sigaction(SIGINT, &act, NULL);
  sigaction(SIGWINCH, &act, NULL);
 
  /* POSIX doesn't allow us to ignore SIGCHLD,
   * so we just install a dummy handler for it */
  act.sa_handler = mutt_sig_empty_handler;
  /* don't need to block any other signals here */
  sigemptyset(&act.sa_mask);
  /* we don't want to mess with stopped children */
  act.sa_flags |= SA_NOCLDSTOP;
  sigaction(SIGCHLD, &act, NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_sig_block()

void mutt_sig_block

(

void

)

Block signals during critical operations.

It's important that certain signals don't interfere with critical operations. Call mutt_sig_unblock() to restore the signals' behaviour.

Definition at line 150 of file signal.c.

{
  if (SignalsBlocked)
    return;
 
  sigemptyset(&Sigset);
  sigaddset(&Sigset, SIGTERM);
  sigaddset(&Sigset, SIGHUP);
  sigaddset(&Sigset, SIGTSTP);
  sigaddset(&Sigset, SIGINT);
  sigaddset(&Sigset, SIGWINCH);
  sigprocmask(SIG_BLOCK, &Sigset, 0);
  SignalsBlocked = true;
}

Here is the caller graph for this function:

mutt_sig_unblock()

void mutt_sig_unblock

(

void

)

Restore previously blocked signals.

Definition at line 168 of file signal.c.

{
  if (!SignalsBlocked)
    return;
 
  sigprocmask(SIG_UNBLOCK, &Sigset, 0);
  SignalsBlocked = false;
}

Here is the caller graph for this function:

mutt_sig_block_system()

void mutt_sig_block_system

(

void

)

Block signals before calling exec()

It's important that certain signals don't interfere with the child process. Call mutt_sig_unblock_system() to restore the signals' behaviour.

Definition at line 183 of file signal.c.

{
  if (SysSignalsBlocked)
    return;
 
  struct sigaction sa;
 
  /* POSIX: ignore SIGINT and SIGQUIT & block SIGCHLD before exec */
  sa.sa_handler = SIG_IGN;
  sa.sa_flags = 0;
  sigemptyset(&sa.sa_mask);
  sigaction(SIGINT, &sa, &SysOldInt);
  sigaction(SIGQUIT, &sa, &SysOldQuit);
 
  sigemptyset(&SigsetSys);
  sigaddset(&SigsetSys, SIGCHLD);
  sigprocmask(SIG_BLOCK, &SigsetSys, 0);
  SysSignalsBlocked = true;
}

Here is the caller graph for this function:

mutt_sig_unblock_system()

void mutt_sig_unblock_system

(

bool

restore

)

Restore previously blocked signals.

Parameters

restore

If true, restore previous SIGINT, SIGQUIT behaviour

Definition at line 207 of file signal.c.

{
  if (!SysSignalsBlocked)
    return;
 
  sigprocmask(SIG_UNBLOCK, &SigsetSys, NULL);
  if (restore)
  {
    sigaction(SIGQUIT, &SysOldQuit, NULL);
    sigaction(SIGINT, &SysOldInt, NULL);
  }
  else
  {
    struct sigaction sa;
 
    sa.sa_handler = SIG_DFL;
    sigemptyset(&sa.sa_mask);
    sa.sa_flags = 0;
    sigaction(SIGQUIT, &sa, NULL);
    sigaction(SIGINT, &sa, NULL);
  }
 
  SysSignalsBlocked = false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_sig_allow_interrupt()

void mutt_sig_allow_interrupt

(

bool

allow

)

Allow/disallow Ctrl-C (SIGINT)

Parameters

allow

True to allow Ctrl-C to interrupt signals

Allow the user to interrupt some long operations.

Definition at line 238 of file signal.c.

{
  struct sigaction sa;
 
  memset(&sa, 0, sizeof(sa));
  sa.sa_handler = sig_handler;
#ifdef SA_RESTART
  if (!allow)
    sa.sa_flags |= SA_RESTART;
#endif
  sigaction(SIGINT, &sa, NULL);
}

Here is the caller graph for this function:

Variable Documentation

Sigset

sigset_t Sigset

static

Definition at line 39 of file signal.c.

SigsetSys

sigset_t SigsetSys

static

Definition at line 40 of file signal.c.

SysOldInt

struct sigaction SysOldInt

static

Definition at line 41 of file signal.c.

SysOldQuit

struct sigaction SysOldQuit

static

Definition at line 42 of file signal.c.

SignalsBlocked

bool SignalsBlocked

static

Definition at line 43 of file signal.c.

SysSignalsBlocked

bool SysSignalsBlocked

static

Definition at line 44 of file signal.c.

sig_handler

sig_handler_t sig_handler = mutt_sig_empty_handler

static

Definition at line 46 of file signal.c.

exit_handler

sig_handler_t exit_handler = mutt_sig_exit_handler

static

Definition at line 47 of file signal.c.

segv_handler

sig_handler_t segv_handler = mutt_sig_exit_handler

static

Definition at line 48 of file signal.c.