98 lines
5.5 KiB
C++
98 lines
5.5 KiB
C++
//! \~\file pisignals.h
|
||
//! \~\ingroup System
|
||
//! \~\brief
|
||
//! \~english System signals
|
||
//! \~russian Сигналы системы
|
||
/*
|
||
PIP - Platform Independent Primitives
|
||
Signals
|
||
Ivan Pelipenko peri4ko@yandex.ru
|
||
|
||
This program is free software: you can redistribute it and/or modify
|
||
it under the terms of the GNU Lesser General Public License as published by
|
||
the Free Software Foundation, either version 3 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 Lesser General Public License for more details.
|
||
|
||
You should have received a copy of the GNU Lesser General Public License
|
||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
#ifndef PISIGNALS_H
|
||
#define PISIGNALS_H
|
||
|
||
#include "piflags.h"
|
||
|
||
#include <functional>
|
||
|
||
//! \~\ingroup System
|
||
//! \~\brief
|
||
//! \~english Helper for installing process signal handlers.
|
||
//! \~russian Вспомогательный класс для установки обработчиков сигналов процесса.
|
||
class PIP_EXPORT PISignals {
|
||
public:
|
||
//! \~english Supported process signals.
|
||
//! \~russian Поддерживаемые сигналы процесса.
|
||
enum Signal {
|
||
Interrupt = 0x01 /** \~english Interrupt from keyboard \~russian Прерывание с клавиатуры */,
|
||
Illegal = 0x02 /** \~english Illegal instruction \~russian Недопустимая инструкция */,
|
||
Abort = 0x04 /** \~english Abort signal \~russian Сигнал аварийного завершения */,
|
||
FPE = 0x08 /** \~english Floating-point exception \~russian Исключение с плавающей точкой */,
|
||
SegFault = 0x10 /** \~english Invalid memory reference \~russian Недопустимое обращение к памяти */,
|
||
Termination = 0x20 /** \~english Termination request \~russian Запрос на завершение */,
|
||
Hangup = 0x40 /** \~english Hangup on controlling terminal \~russian Разрыв управляющего терминала */,
|
||
Quit = 0x80 /** \~english Quit from keyboard \~russian Завершение с клавиатуры */,
|
||
Kill = 0x100 /** \~english Forced termination \~russian Принудительное завершение */,
|
||
BrokenPipe = 0x200 /** \~english Write to a pipe without readers \~russian Запись в канал без читателей */,
|
||
Timer = 0x400 /** \~english Alarm timer signal \~russian Сигнал таймера alarm */,
|
||
UserDefined1 = 0x800 /** \~english User-defined signal 1 \~russian Пользовательский сигнал 1 */,
|
||
UserDefined2 = 0x1000 /** \~english User-defined signal 2 \~russian Пользовательский сигнал 2 */,
|
||
ChildStopped = 0x2000 /** \~english Child process changed state \~russian Дочерний процесс изменил состояние */,
|
||
Continue = 0x4000 /** \~english Continue a stopped process \~russian Продолжение остановленного процесса */,
|
||
StopProcess = 0x8000 /** \~english Stop process execution \~russian Остановить выполнение процесса */,
|
||
StopTTY = 0x10000 /** \~english Stop from terminal \~russian Остановка с терминала */,
|
||
StopTTYInput =
|
||
0x20000 /** \~english Background process requested terminal input \~russian Фоновый процесс запросил ввод с терминала */,
|
||
StopTTYOutput =
|
||
0x40000 /** \~english Background process requested terminal output \~russian Фоновый процесс запросил вывод в терминал */,
|
||
All = 0xFFFFF /** \~english Bit mask of all supported signals \~russian Битовая маска всех поддерживаемых сигналов */
|
||
};
|
||
|
||
//! \~english Callback invoked for each grabbed signal.
|
||
//! \~russian Обратный вызов, вызываемый для каждого перехваченного сигнала.
|
||
typedef std::function<void(PISignals::Signal)> SignalEvent;
|
||
|
||
//! \~english Installs callback that receives grabbed signals.
|
||
//! \~russian Устанавливает обратный вызов, получающий перехваченные сигналы.
|
||
static void setSlot(SignalEvent slot) { ret_func = std::move(slot); }
|
||
|
||
//! \~english Redirects selected signals to the slot set by \a setSlot().
|
||
//! \~russian Перенаправляет выбранные сигналы в обработчик, заданный через \a setSlot().
|
||
static void grabSignals(PIFlags<PISignals::Signal> signals_);
|
||
|
||
//! \~english Restores default handlers for selected signals.
|
||
//! \~russian Восстанавливает обработчики по умолчанию для выбранных сигналов.
|
||
static void releaseSignals(PIFlags<PISignals::Signal> signals_);
|
||
|
||
//! \~english Raises the specified signal in the current process.
|
||
//! \~russian Посылает указанный сигнал текущему процессу.
|
||
static void raiseSignal(PISignals::Signal signal);
|
||
|
||
private:
|
||
PISignals() { ret_func = 0; }
|
||
~PISignals() {}
|
||
|
||
static int signalCode(PISignals::Signal signal);
|
||
static PISignals::Signal signalFromCode(int signal);
|
||
static void signal_event(int signal);
|
||
|
||
static SignalEvent ret_func;
|
||
};
|
||
|
||
|
||
#endif // PISIGNALS_H
|