Where Online Learning is simpler!

The C and C++ Include Header Files

/usr/include/python3.12/internal/pycore_faulthandler.h


$ cat -n /usr/include/python3.12/internal/pycore_faulthandler.h

     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 */