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