faulthandler —— 轉(zhuǎn)儲 Python 的跟蹤信息?
3.3 新版功能.
當(dāng)故障、超時或收到用戶信號時，利用本模塊內(nèi)的函數(shù)可轉(zhuǎn)儲 Python 跟蹤信息。調(diào)用 faulthandler.enable() 可安裝 SIGSEGV 、 SIGFPE 、 SIGABRT 、 SIGBUS 和 SIGILL 信號的故障處理程序。通過設(shè)置 PYTHONFAULTHANDLER 環(huán)境變量或 -X faulthandler 命令行參數(shù)，還可以在啟動時開啟這些設(shè)置。
故障處理程序與操作系統(tǒng)的故障處理程序兼容，比如 Apport 或 Windows 故障處理程序等。如果 sigaltstack() 函數(shù)可用，本模塊將為信號處理程序使用備用堆棧。這樣即便堆棧溢出也能轉(zhuǎn)儲跟蹤信息。
故障處理程序?qū)⒃跒?zāi)難性場合調(diào)用，因此只能使用信號安全的函數(shù)（比如不能在堆上分配內(nèi)存）。由于這一限制，與正常的 Python 跟蹤相比，轉(zhuǎn)儲量是最小的。
只支持 ASCII 碼。編碼時會用到
backslashreplace錯誤處理程序。每個字符串限制在 500 個字符以內(nèi)。
只會顯式文件名、函數(shù)名和行號。（不顯示源代碼）
上限是 100 頁內(nèi)存幀和 100 個線程。
反序排列：最近的調(diào)用最先顯示。
默認(rèn)情況下，Python 的跟蹤信息會寫入 sys.stderr。為了能看到跟蹤信息，應(yīng)用程序必須運行于終端中。日志文件也可以傳給 faulthandler.enable()。
本模塊是用 C 語言實現(xiàn)的，所以才能在崩潰或 Python 死鎖時轉(zhuǎn)儲跟蹤信息。
在 Python 啟動時， Python 開發(fā)模式 會調(diào)用 faulthandler.enable()。
轉(zhuǎn)儲跟蹤信息?
- faulthandler.dump_traceback(file=sys.stderr, all_threads=True)?
將所有線程的跟蹤數(shù)據(jù)轉(zhuǎn)儲到 file 中。如果 all_threads 為
False，則只轉(zhuǎn)儲當(dāng)前線程。在 3.5 版更改: 增加了向本函數(shù)傳入文件描述符的支持。
故障處理程序的狀態(tài)?
- faulthandler.enable(file=sys.stderr, all_threads=True)?
啟用故障處理程序：為
SIGSEGV、SIGFPE、SIGABRT、SIGBUS和SIGILL信號安裝處理程序，以轉(zhuǎn)儲 Python 跟蹤信息。如果 all_threads 為True，則會為每個運行中的線程生成跟蹤信息。否則只轉(zhuǎn)儲當(dāng)前線程。file 必須保持打開狀態(tài)，直至停用故障處理程序為止：參見 文件描述符相關(guān)話題。
在 3.5 版更改: 增加了向本函數(shù)傳入文件描述符的支持。
在 3.6 版更改: 在 Windows 系統(tǒng)中，同時會安裝一個 Windows 異常處理程序。
在 3.10 版更改: 現(xiàn)在如果 all_threads 為 True，則轉(zhuǎn)儲信息會包含垃圾收集器是否正在運行。
- faulthandler.is_enabled()?
檢查故障處理程序是否被啟用。
一定時間后轉(zhuǎn)儲跟蹤數(shù)據(jù)。?
- faulthandler.dump_traceback_later(timeout, repeat=False, file=sys.stderr, exit=False)?
在 timeout 秒超時后，轉(zhuǎn)儲所有線程的跟蹤信息，如果 repeat 為
True，則每隔 timeout 秒轉(zhuǎn)儲一次。如果 exit 為True，則在轉(zhuǎn)儲跟蹤信息后調(diào)用_exit()，參數(shù) status=1。請注意，_exit()會立即關(guān)閉進(jìn)程，這意味著不做任何清理工作，如刷新文件緩沖區(qū)等。如果調(diào)用兩次函數(shù)，則新的調(diào)用將取代之前的參數(shù)，超時時間也會重置。計時器的精度為亞秒級。file 必須保持打開狀態(tài)，直至跟蹤信息轉(zhuǎn)儲完畢，或調(diào)用了
cancel_dump_traceback_later()：參見 文件描述符相關(guān)話題。本函數(shù)用一個看門狗線程實現(xiàn)。
在 3.7 版更改: 該函數(shù)現(xiàn)在總是可用。
在 3.5 版更改: 增加了向本函數(shù)傳入文件描述符的支持。
- faulthandler.cancel_dump_traceback_later()?
取消
dump_traceback_later()的最后一次調(diào)用。
轉(zhuǎn)儲用戶信號的跟蹤信息。?
- faulthandler.register(signum, file=sys.stderr, all_threads=True, chain=False)?
注冊一個用戶信號：為 signum 信號安裝一個處理程序，將所有線程或當(dāng)前線程（all_threads 為
False時）的跟蹤信息轉(zhuǎn)儲到 file 中。如果 chain 為True，則調(diào)用上一層處理程序。file 必須保持打開狀態(tài)，直至該信號被
unregister()注銷：參見 文件描述符相關(guān)話題。Windows 中不可用。
在 3.5 版更改: 增加了向本函數(shù)傳入文件描述符的支持。
- faulthandler.unregister(signum)?
注銷一個用戶信號：卸載由
register()安裝的 signum 信號處理程序。如果信號已注冊，返回True，否則返回False。Windows 中不可用。
文件描述符相關(guān)話題?
enable() 、 dump_traceback_later() 和 register() 保留其 file 參數(shù)給出的文件描述符。 如果文件關(guān)閉，文件描述符將被一個新文件重新使用；或者用 os.dup2() 替換了文件描述符，則跟蹤信息將被寫入另一個文件。 每次文件被替換時，都會再次調(diào)用這些函數(shù)。
示例?
在 Linux 中啟用和停用內(nèi)存段故障的默認(rèn)處理程序：
$ python3 -c "import ctypes; ctypes.string_at(0)"
Segmentation fault
$ python3 -q -X faulthandler
>>> import ctypes
>>> ctypes.string_at(0)
Fatal Python error: Segmentation fault
Current thread 0x00007fb899f39700 (most recent call first):
File "/home/python/cpython/Lib/ctypes/__init__.py", line 486 in string_at
File "<stdin>", line 1 in <module>
Segmentation fault