# 提交錯誤報告 [TOC] 當使用`swoole`發生段錯誤時，請及時向開發組報告。可以使用`gdb`工具來得到一份`bt`信息。使用`gdb`跟蹤需要在編譯`swoole`時增加`--enable-debug`參數。 > 如果不方便`gdb`，也可以提供一份可穩定復現的`demo`程序 打開core dump ~~~ ulimit -c unlimited ~~~ 使用`gdb`來查看`core dump`信息。`core`文件一般在當前目錄，如果操作系統做了處理，將`core dump`文件放置到其他目錄，請替換為相應的路徑 ~~~ gdb php core gdb php /tmp/core.4596 ~~~ 在gdb下輸入bt查看調用棧信息 ~~~ (gdb)bt Program terminated with signal 11, Segmentation fault. #0 0x00007f1cdbe205e0 in swServer_onTimer (reactor=<value optimized out>, event=...) at /usr/local/php/swoole-swoole-1.5.9b/src/network/Server.c:92 92 serv->onTimer(serv, timer_node->interval); Missing separate debuginfos, use: debuginfo-install php-cli-5.3.3-22.el6.x86_64 ~~~ 在gdb中使用f指令查看代碼段 ~~~ (gdb)f 1 (gdb)f 0 ~~~ 如果沒有函數調用棧信息，可能是編譯去除了debug信息。請手工修改swoole源碼目錄下的`Makefile`文件，修改CFLAGS為 ~~~ CFLAGS = -Wall -pthread -g -O0 ~~~ ## 內存檢測 除了使用`gdb`分析之外可以使用`valgrind`工具檢測程序是否正常運行。 ~~~ USE_ZEND_ALLOC=0 valgrind php your_file.php ~~~ * 程序邏輯覆蓋后執行`ctrl+c`中斷，將屏幕打印的信息復制到文件中 ~~~ 注意：有些情況下在虛擬機下共享目錄core文件無法生成，會生成一個0字節的文件，請將core文件生成目錄改到/var/log/core下。 ~~~ ## 提交問題 請將上面的得到的信息，連同機器信息，包括`php -v``gcc -v``uname -a`提交到[Github Issues頁面](https://github.com/swoole/swoole-src/issues/new)或者發送郵件到[team@swoole.com](mailto:team@swoole.com)。 若確定是`Swoole`底層的問題，開發組會快速解決。 ## 反饋建議 為了減少`Swoole`內核開發者與反饋者之間的溝通成本，請認真閱讀以下內容，在`GitHub`平臺盡可能地按照`Issue`模板提交問題。 * 請提供發生問題時使用的`php`、`swoole`、操作系統、`gcc`和`openssl`（可選）版本信息 * 請描述具體是什么情況下發生，盡可能地給出可穩定重現的**代碼**和**測試過程** * 請使用`valgrind`、`gdb`、`strace`等工具進行初步地問題跟蹤，并貼出相關信息和線索 * 請認真查看`php`錯誤日志、`swoole`的`log_file`、操作系統的`syslog`等日志信息，找到可能與該問題關聯的信息和線索 ## 獲取版本信息 #### php ~~~ php -v ~~~ #### swoole ~~~ php --ri swoole ~~~ #### 操作系統類型 如`Linux`、`MacOS`、`FreeBSD`、`CygWin`、`樹莓派`等 #### 內核版本 ~~~ uname -a ~~~ #### gcc ~~~ gcc -v ~~~ #### openssl ~~~ openssl version ~~~