| extern "C" { | |
| /* Forward declaration */ | |
| struct _is; | |
| /* Write the Python traceback into the file 'fd'. For example: | |
| Traceback (most recent call first): | |
| File "xxx", line xxx in <xxx> | |
| File "xxx", line xxx in <xxx> | |
| ... | |
| File "xxx", line xxx in <xxx> | |
| This function is written for debug purpose only, to dump the traceback in | |
| the worst case: after a segmentation fault, at fatal error, etc. That's why, | |
| it is very limited. Strings are truncated to 100 characters and encoded to | |
| ASCII with backslashreplace. It doesn't write the source code, only the | |
| function name, filename and line number of each frame. Write only the first | |
| 100 frames: if the traceback is truncated, write the line " ...". | |
| This function is signal safe. */ | |
| PyAPI_FUNC(void) _Py_DumpTraceback( | |
| int fd, | |
| PyThreadState *tstate); | |
| /* Write the traceback of all threads into the file 'fd'. current_thread can be | |
| NULL. | |
| Return NULL on success, or an error message on error. | |
| This function is written for debug purpose only. It calls | |
| _Py_DumpTraceback() for each thread, and so has the same limitations. It | |
| only write the traceback of the first 100 threads: write "..." if there are | |
| more threads. | |
| If current_tstate is NULL, the function tries to get the Python thread state | |
| of the current thread. It is not an error if the function is unable to get | |
| the current Python thread state. | |
| If interp is NULL, the function tries to get the interpreter state from | |
| the current Python thread state, or from | |
| _PyGILState_GetInterpreterStateUnsafe() in last resort. | |
| It is better to pass NULL to interp and current_tstate, the function tries | |
| different options to retrieve this information. | |
| This function is signal safe. */ | |
| PyAPI_FUNC(const char*) _Py_DumpTracebackThreads( | |
| int fd, | |
| struct _is *interp, | |
| PyThreadState *current_tstate); | |
| /* Write a Unicode object into the file descriptor fd. Encode the string to | |
| ASCII using the backslashreplace error handler. | |
| Do nothing if text is not a Unicode object. The function accepts Unicode | |
| string which is not ready (PyUnicode_WCHAR_KIND). | |
| This function is signal safe. */ | |
| PyAPI_FUNC(void) _Py_DumpASCII(int fd, PyObject *text); | |
| /* Format an integer as decimal into the file descriptor fd. | |
| This function is signal safe. */ | |
| PyAPI_FUNC(void) _Py_DumpDecimal( | |
| int fd, | |
| size_t value); | |
| /* Format an integer as hexadecimal with width digits into fd file descriptor. | |
| The function is signal safe. */ | |
| PyAPI_FUNC(void) _Py_DumpHexadecimal( | |
| int fd, | |
| uintptr_t value, | |
| Py_ssize_t width); | |
| PyAPI_FUNC(PyObject*) _PyTraceBack_FromFrame( | |
| PyObject *tb_next, | |
| PyFrameObject *frame); | |
| } | |