signal
Устанавливает обработчики для асинхронных событий
Этот модуль предоставляет механизмы для использования обработчиков сигналов в Python.
Общие правила
Функция signal.signal () позволяет определять пользовательские обработчики, которые будут выполняться при получении сигнала. Установлено небольшое количество обработчиков по умолчанию: SIGPIPE игнорируется (поэтому об ошибках записи в каналах и сокетах можно сообщать как об обычных исключениях Python), а SIGINT преобразуется в исключение KeyboardInterrupt, если родительский процесс не изменил его.
После установки обработчик для конкретного сигнала остается установленным до его явного сброса (Python эмулирует интерфейс стиля BSD независимо от базовой реализации), за исключением обработчика для SIGCHLD, который следует базовой реализации.
Выполнение обработчиков сигналов Python
Обработчик сигналов Python не выполняется внутри обработчика сигналов низкого уровня (C). Вместо этого обработчик сигналов низкого уровня устанавливает флаг, который сообщает виртуальной машине выполнить соответствующий обработчик сигнала Python в более поздний момент (например, в следующей инструкции байт-кода). Это имеет последствия:
Бессмысленно отлавливать синхронные ошибки, такие как SIGFPE или SIGSEGV, вызванные недопустимой операцией в коде C. Python вернется из обработчика сигнала в код C, который, вероятно, снова вызовет тот же сигнал, что приведет к зависанию Python. Начиная с Python 3.3, вы можете использовать модуль обработки ошибок для сообщения о синхронных ошибках.
Долговременные вычисления, реализованные исключительно на C (например, сопоставление регулярных выражений для большого объема текста), могут выполняться непрерывно в течение произвольного количества времени, независимо от полученных сигналов. Обработчики сигналов Python будут вызваны по окончании вычислений.
Сигналы и потоки
Обработчики сигналов Python всегда выполняются в основном потоке Python, даже если сигнал был получен в другом потоке. Это означает, что сигналы нельзя использовать как средство межпоточного взаимодействия. Вместо этого вы можете использовать примитивы синхронизации из модуля threading.
Кроме того, только основной поток может устанавливать новый обработчик сигнала.
Содержание модуля
Изменено в версии 3.5: перечисленные ниже константы, связанные с сигналом (SIG*), обработчиком (SIG_DFL, SIG_IGN) и sigmask (SIG_BLOCK, SIG_UNBLOCK, SIG_SETMASK), были преобразованы в перечисления enums. Функции getsignal (), pthread_sigmask (), sigpending () и sigwait () возвращают удобочитаемые перечисления enums.
В модуле signal определены следующие переменные:
signal.SIG_DFL - выполняет функцию по умолчанию для сигнала
signal.SIG_IGN - обработчик просто игнорирует данный сигнал
signal.SIGABRT
signal.SIGALRM - сигнал таймера от alarm(2) в Unix
signal.SIGBREAK
signal.SIGBUS
signal.SIGCHLD - дочерний процесс остановлен или прекращен
не заполнено...
signal.SIGUSR1 - определяемый пользователем сигнал 1
signal.SIGUSR2 - определяемый пользователем сигнал 2
не заполнено...
Модуль signal определяет одно исключение:
signal.ItimerError exception
Модуль signal определяет следующие функции:
signal.alarm () - отправляет сигнал SIGALRM через указанное количество секунд
signal.getsignal ()
signal.strsignal ()
signal. valid_signals ()
signal.pause () - приостанавливает процесс, пока не будет перехвачен следующий сигнал
не заполнено...
signal.signal () - задает обработчик для сигнала
не заполнено...
Пример
Вот минимальный пример программы. Он использует функцию alarm (), чтобы ограничить время ожидания открытия файла; это полезно, если файл предназначен для последовательного устройства, которое не может быть включено, что обычно приводит к зависанию os.open () на неопределенное время. Решение - установить 5-секундный сигнал тревоги перед открытием файла; если операция длится слишком долго, будет отправлен аварийный сигнал, и обработчик вызовет исключение.
Примечание для SIGPIPE
Передача вывода вашей программы по конвейеру таким инструментам, как head(1), вызовет отправку сигнала SIGPIPE вашему процессу, когда приемник его стандартного вывода закроется раньше. Это приводит к возникновению исключения, например BrokenPipeError: [Errno 32] Broken pipe
. Чтобы обработать этот случай, оберните вашу точку входа, чтобы перехватить это исключение, следующим образом:
Не устанавливайте для SIGPIPE значение SIG_DFL, чтобы избежать ошибки BrokenPipeError. Это может привести к неожиданному завершению вашей программы также всякий раз, когда какое-либо соединение сокета прерывается, пока ваша программа все еще пишет в него.
Last updated