Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
allendowney
GitHub Repository: allendowney/cpython
 Path: blob/main/Include/internal/pycore_faulthandler.h
12 views
1
#ifndef Py_INTERNAL_FAULTHANDLER_H

2
#define Py_INTERNAL_FAULTHANDLER_H

3
#ifdef __cplusplus

4
extern "C" {

5
#endif

6


7
#ifndef Py_BUILD_CORE

8
#  error "this header requires Py_BUILD_CORE define"

9
#endif

10


11
#ifdef HAVE_SIGACTION

12
#  include <signal.h>

13
#endif

14


15


16
#ifndef MS_WINDOWS

17
   /* register() is useless on Windows, because only SIGSEGV, SIGABRT and

18
      SIGILL can be handled by the process, and these signals can only be used

19
      with enable(), not using register() */

20
#  define FAULTHANDLER_USER

21
#endif

22


23


24
#ifdef HAVE_SIGACTION

25
/* Using an alternative stack requires sigaltstack()

26
   and sigaction() SA_ONSTACK */

27
#  ifdef HAVE_SIGALTSTACK

28
#    define FAULTHANDLER_USE_ALT_STACK

29
#  endif

30
typedef struct sigaction _Py_sighandler_t;

31
#else

32
typedef PyOS_sighandler_t _Py_sighandler_t;

33
#endif  // HAVE_SIGACTION

34


35


36
#ifdef FAULTHANDLER_USER

37
struct faulthandler_user_signal {

38
    int enabled;

39
    PyObject *file;

40
    int fd;

41
    int all_threads;

42
    int chain;

43
    _Py_sighandler_t previous;

44
    PyInterpreterState *interp;

45
};

46
#endif /* FAULTHANDLER_USER */

47


48


49
struct _faulthandler_runtime_state {

50
    struct {

51
        int enabled;

52
        PyObject *file;

53
        int fd;

54
        int all_threads;

55
        PyInterpreterState *interp;

56
#ifdef MS_WINDOWS

57
        void *exc_handler;

58
#endif

59
    } fatal_error;

60


61
    struct {

62
        PyObject *file;

63
        int fd;

64
        PY_TIMEOUT_T timeout_us;   /* timeout in microseconds */

65
        int repeat;

66
        PyInterpreterState *interp;

67
        int exit;

68
        char *header;

69
        size_t header_len;

70
        /* The main thread always holds this lock. It is only released when

71
           faulthandler_thread() is interrupted before this thread exits, or at

72
           Python exit. */

73
        PyThread_type_lock cancel_event;

74
        /* released by child thread when joined */

75
        PyThread_type_lock running;

76
    } thread;

77


78
#ifdef FAULTHANDLER_USER

79
    struct faulthandler_user_signal *user_signals;

80
#endif

81


82
#ifdef FAULTHANDLER_USE_ALT_STACK

83
    stack_t stack;

84
    stack_t old_stack;

85
#endif

86
};

87


88
#define _faulthandler_runtime_state_INIT \

89
    { \

90
        .fatal_error = { \

91
            .fd = -1, \

92
        }, \

93
    }

94


95


96
#ifdef __cplusplus

97
}

98
#endif

99
#endif /* !Py_INTERNAL_FAULTHANDLER_H */

100


101