mirror of
https://github.com/Mercury-Language/mercury.git
synced 2025-12-13 04:44:39 +00:00
d465fa53cb
Discussion of these changes can be found on the Mercury developers
mailing list archives from June 2018.
COPYING.LIB:
Add a special linking exception to the LGPL.
*:
Update references to COPYING.LIB.
Clean up some minor errors that have accumulated in copyright
messages.
104 lines
3.7 KiB
C
104 lines
3.7 KiB
C
// vim: ts=4 sw=4 expandtab ft=c
|
|
|
|
// Copyright (C) 1998, 2000, 2002, 2004-2005, 2010 The University of Melbourne.
|
|
// Copyright (C) 2016, 2018 The Mercury team.
|
|
// This file is distributed under the terms specified in COPYING.LIB.
|
|
|
|
// mercury_signal.h - functions for setting up signal handlers.
|
|
//
|
|
// This defines a generic signal handler setup mechanism.
|
|
//
|
|
// NOTE: If `struct sigcontext' is needed, mercury_signal.h must be
|
|
// included before anything which could include <signal.h>.
|
|
|
|
#ifndef MERCURY_SIGNAL_H
|
|
#define MERCURY_SIGNAL_H
|
|
|
|
#include "mercury_regs.h" // include before system headers
|
|
#include "mercury_conf.h"
|
|
|
|
#ifdef MR_HAVE_SIGCONTEXT_STRUCT
|
|
// Some versions of Linux call it struct sigcontext_struct, some call it
|
|
// struct sigcontext. The following #define eliminates the differences.
|
|
|
|
#define sigcontext_struct sigcontext // must be before #include <signal.h>
|
|
struct sigcontext; // this forward decl avoids a gcc warning in signal.h
|
|
|
|
// On some systems (e.g. most versions of Linux) we need to #define
|
|
// __KERNEL__ to get sigcontext_struct from <signal.h>.
|
|
// This stuff must come before anything else that might include <signal.h>,
|
|
// otherwise the #define __KERNEL__ may not work.
|
|
|
|
#define __KERNEL__
|
|
#include <signal.h> // must come third
|
|
#undef __KERNEL__
|
|
|
|
// Some versions of Linux define it in <signal.h>, others define it in
|
|
// <asm/sigcontext.h>. We try both.
|
|
|
|
#ifdef MR_HAVE_ASM_SIGCONTEXT_H
|
|
#include <asm/sigcontext.h>
|
|
#endif
|
|
#else
|
|
#include <signal.h>
|
|
#endif
|
|
|
|
#include "mercury_types.h"
|
|
#include "mercury_std.h"
|
|
|
|
#ifdef MR_HAVE_SIGACTION
|
|
typedef struct sigaction MR_signal_action;
|
|
#else
|
|
typedef MR_Code * MR_signal_action;
|
|
#endif
|
|
|
|
// MR_setup_signal sets a signal handler (handler) to handle signals
|
|
// of the given signal type (sig).
|
|
// If the handler cannot be setup, it aborts with the given error message.
|
|
//
|
|
// If the signal handler requires siginfo to be provided (e.g. it needs
|
|
// access to stored registers), need_info must be MR_TRUE.
|
|
// Note that on some platforms, signal information is provided
|
|
// regardless of the value of need_info.
|
|
|
|
extern void MR_setup_signal(int sig, MR_Code *handler, MR_bool need_info,
|
|
const char * error_message);
|
|
|
|
// As above, but don't arrange for system calls to be restarted
|
|
// if the signal is received.
|
|
|
|
extern void MR_setup_signal_no_restart(int sig, MR_Code *handler,
|
|
MR_bool need_info, const char * error_message);
|
|
|
|
// Reset a signal to its default handler. (see SIG_DFL in signal(2)).
|
|
|
|
extern void MR_reset_signal(int sig);
|
|
|
|
// As above, but initialize a signal action suitable to be passed to
|
|
// MR_set_signal_action rather than setting a signal handler for a signal.
|
|
|
|
extern void MR_init_signal_action(MR_signal_action* act, MR_Code *handler,
|
|
MR_bool need_info, MR_bool should_restart_system_call);
|
|
|
|
// Get the current action for the given signal.
|
|
// If the action cannot be retrieved, it aborts with the given error message.
|
|
|
|
extern void MR_get_signal_action(int sig, MR_signal_action *old_action,
|
|
const char *error_message);
|
|
|
|
// Restore the action for the given signal to the result
|
|
// of a previous call to MR_get_signal_action().
|
|
// If the action cannot be set, it aborts with the given error message.
|
|
|
|
extern void MR_set_signal_action(int sig, MR_signal_action *action,
|
|
const char *error_message);
|
|
|
|
// Change the behaviour of system calls when the the specified signal
|
|
// is received. If restart is MR_TRUE, they will be restarted;
|
|
// if it is MR_FALSE, they won't. This function may have no effect
|
|
// on some systems.
|
|
|
|
extern void MR_signal_should_restart(int sig, MR_bool restart);
|
|
|
|
#endif // not MERCURY_SIGNAL_H
|