/*
 * ZoneMinder Signal Handling Interface, $Date$, $Revision$
 * Copyright (C) 2001-2008 Philip Coombes
 *
 * 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, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/

#ifndef ZM_SIGNAL_H
#define ZM_SIGNAL_H

#include "zm_config.h"
#include <atomic>
#include <csignal>
#include <syslog.h>

#if HAVE_LIBUNWIND
#define UNW_LOCAL_ONLY
#include <libunwind.h>
#elif HAVE_EXECINFO_H
#include <execinfo.h>
#endif
#if HAVE_UCONTEXT_H
#include <ucontext.h>
#endif

typedef RETSIGTYPE (SigHandler)( int );
#if ( HAVE_SIGINFO_T && HAVE_UCONTEXT_T )
typedef RETSIGTYPE (SigActionHandler)( int, siginfo_t *info, void *context );
#endif

extern bool zm_reload;
extern std::atomic<bool> zm_terminate;

// Where the die handler writes its crash report besides stderr. Both keep a
// descriptor of their own that is never closed, so the handler can write(2) to
// it at any moment.
// The log file at fd: called by the Logger each time it opens one.
void zmSetCrashLogFile(int fd);
// Syslog, sending to the socket at path as ident, with the Logger's facility.
// _PATH_LOG is the platform's socket: /dev/log on Linux, /var/run/syslog on
// macOS, /var/run/log on FreeBSD.
#ifndef _PATH_LOG
#define _PATH_LOG "/dev/log"
#endif
void zmSetCrashSyslog(const char *ident, const char *path = _PATH_LOG);
// Give the calling thread its own stack for the die handler, so a stack
// overflow on that thread is reported too. Call at the start of a thread.
void zmSetThreadAltStack();

RETSIGTYPE zmc_hup_handler( int signal );
RETSIGTYPE zmc_term_handler( int signal );
#if ( HAVE_SIGINFO_T && HAVE_UCONTEXT_T )
RETSIGTYPE zmc_die_handler( int signal, siginfo_t *info, void *context );
#else
RETSIGTYPE zmc_die_handler( int signal );
#endif

void zmSetHupHandler( SigHandler *handler );
void zmSetTermHandler( SigHandler *handler );
void zmSetPipeHandler( SigHandler *handler );
#if ( HAVE_SIGINFO_T && HAVE_UCONTEXT_T )
void zmSetDieHandler( SigActionHandler *handler );
#else
void zmSetDieHandler( SigHandler *handler );
#endif

void zmSetDefaultHupHandler();
void zmSetDefaultTermHandler();
void zmSetDefaultPipeHandler();
void zmSetDefaultDieHandler();

#endif // ZM_SIGNAL_H