除錯 Subversion ¶

除錯 DAV 伺服器 ¶

'mod_dav_svn.so' 包含主要的 Subversion 伺服器邏輯；它作為 mod_dav 中的模組執行，而 mod_dav 則作為 httpd 中的模組執行。如果 httpd 可能使用動態共用模組，您可能需要在 mod_dav_svn 中設定中斷點之前 set breakpoint pending on（在 ~/.gdbinit 中）。或者，您可以啟動 httpd，中斷它，設定中斷點，然後繼續

   % gdb httpd
   (gdb) run -X
   ^C
   (gdb) break some_func_in_mod_dav_svn
   (gdb) continue

-X 開關等同於 -DONE_PROCESS 和 -DNO_DETACH，分別確保 httpd 以單一執行緒執行，並保持附加至 tty。一旦啟動，它就會靜候並等待要求；此時，您可按 Control-C 並設定中斷點。

您可能想要觀察 Apache 的執行時間記錄檔

   /usr/local/apache2/logs/error_log
   /usr/local/apache2/logs/access_log

以協助判斷可能出錯的位置，以及中斷點的設定位置。

或者，在工作副本中執行 ./subversion/tests/cmdline/davautocheck.sh --gdb 將使用該工作副本中的 mod_dav_svn 啟動 httpd。然後，您可以針對它執行個別 Python 測試：./basic_tests.py --url=https://127.0.0.1:3691/。

在 Unix 上除錯 ra_svn 客戶端和伺服器 ¶

ra_svn 中的錯誤通常會顯示下列難以理解的錯誤訊息之一

  svn: Malformed network data
  svn: Connection closed unexpectedly

(第一個訊息也可能表示資料串流在隧道模式中因使用者點檔案或掛勾指令碼而損毀；請參閱 問題 #1145。)第一個訊息通常表示您必須除錯客戶端；第二個訊息通常表示您必須除錯伺服器。

使用 --disable-shared --enable-maintainer-mode 建置可以最輕鬆地除錯 ra_svn。使用後者選項時，錯誤訊息會精確告知您應在何行設定中斷點；否則，請在 marshal.c:vparse_tuple() 的結尾處查詢行號，該處會傳回「格式錯誤的網路資料」錯誤。

若要除錯客戶端，只需在 gdb 中將其拉起，設定中斷點，然後執行有問題的指令

  % gdb svn
  (gdb) break marshal.c:NNN
  (gdb) run ARGS
  Breakpoint 1, vparse_tuple (list=___, pool=___, fmt=___, 
    ap=___) at subversion/libsvn_ra_svn/marshal.c:NNN
  NNN                                 "Malformed network data");

有幾項有用的資訊

• 後溯會精確告知您哪個通訊協定交換失敗。

• "print *conn" 會顯示連線緩衝區。read_buf、read_ptr 和 read_end 代表讀取緩衝區，可以顯示封送器正在查看的資料。（由於 read_buf 通常不會在 read_end 處以 0 終止，因此請小心錯誤地假設緩衝區中有垃圾資料。）

• 格式字串決定了封送器預期會看到什麼。

要除錯在守護程式模式下的伺服器，請在 gdb 中將其拉起，設定中斷點（通常在客戶端上出現「連線意外關閉」錯誤表示伺服器上出現「格式錯誤的網路資料」錯誤，儘管它也可能表示核心傾印），並執行「-X」選項以提供單一連線

  % gdb svnserve
  (gdb) break marshal.c:NNN
  (gdb) run -X

然後執行有問題的客戶端命令。從那裡開始，就像除錯客戶端一樣。

在通道模式下除錯伺服器比較麻煩。您需要將類似「{ int x = 1; while (x); }」的東西貼在 svnserve 的 main() 頂端，並將產生的 svnserve 放到伺服器上的使用者路徑中。然後開始執行，gdb 附加伺服器上的程序，「設定 x = 0」，並按需要逐步執行程式碼。

使用 Wireshark 進行網路追蹤 ¶

使用 Wireshark（以前稱為「Ethereal」）竊聽對話。

首先，請確定在同一個 wireshark 會話中的擷取之間，您按了清除，否則來自一個擷取的篩選器（例如，HTTP 擷取）可能會干擾其他擷取（例如，ra_svn 擷取）。

假設您已清除，那麼

1. 拉下擷取功能表，然後選擇擷取 篩選器。

2. 如果要偵錯 http:// (WebDAV) 協定，則在彈出的視窗中，選擇「HTTP TCP 埠 (80)」（這會產生篩選器字串「tcp port http」）。

   如果要偵錯 svn:// (ra_svn) 協定，則選擇新增，為新的篩選器命名（例如「ra_svn」），然後在篩選器字串方塊中輸入「tcp port 3690」。

   完成後，按一下確定。

3. 再次前往擷取功能表，這次選擇介面，然後按一下適當介面旁的選項（您可能想要介面「lo」，代表「迴路」，假設伺服器會在與用戶端相同的機器上執行）。

4. 取消勾選適當的核取方塊以關閉混雜模式。

5. 按一下右下角的開始按鈕以開始擷取。

6. 執行您的 Subversion 用戶端。

7. 在作業完成時按一下停止圖示（乙太網路介面卡上方的紅色 X），或者擷取->停止應該會生效。現在您已完成擷取。它看起來像是一串很長的清單。

8. 按一下通訊協定欄位以排序。

9. 然後，按一下第一個相關的列以選取它；通常這會是第一個列。

10. 按一下滑鼠右鍵，然後選擇追蹤 TCP 串流。您會看到 Subversion 用戶端 HTTP 轉換的請求/回應配對。

上述說明是針對 Wireshark 的圖形版本（版本 0.99.6），不適用於稱為「tshark」的命令列版本（對應到「tethereal」，源自 Wireshark 當時稱為 Ethereal 的時候）。

使用 socat 進行網路追蹤 ¶

另一種替代方案是在 Subversion 用戶端和伺服器之間設定一個記錄中繼伺服器。要這樣做的簡單方法是使用 socat 程式。例如，要記錄與 svnserve 執行個體的通訊，請執行下列指令

socat -v TCP-LISTEN:9630,reuseaddr,fork TCP4:localhost:svn

然後使用 svn://127.0.0.1:9630/ 的 URL 基礎執行您的 svn 指令；socat 會將 9630 埠的流量轉發到正常的 svnserve 埠 (3690)，並會將兩個方向的所有流量列印到標準錯誤，並在流量方向前面加上 < 和 > 符號表示流量方向。

若要從加密的 https:// 連線記錄可讀的 HTTP，請執行一個使用 TLS 連線到伺服器的 socat 代理

socat -v TCP-LISTEN:9630,reuseaddr,fork OPENSSL:example.com:443

然後將其用作純文字 http:// 連線的代理

svn ls http://example.com/svn/repos/trunk \
    --config-option servers:global:http-proxy-host=localhost \
    --config-option servers:global:http-proxy-port=9630 \
    --config-option servers:global:http-compression=no

socat 代理會記錄純文字 HTTP，而與伺服器之間的所有網路流量都會使用 TLS 加密。

使用 http-proxy 進行網路追蹤 ¶

如果您正在除錯 http 客戶端/伺服器設定，可以使用網路除錯代理，例如 Charles 或 Fiddler。

設定好此類代理後，您需要設定 Subversion 以使用代理。這可以使用 servers 設定檔中的 http-proxy-host 和 http-proxy-port 參數來完成。您也可以使用這些選項在命令列中指定代理 --config-option 'servers:global:http-proxy-host=127.0.0.1' --config-option 'servers:global:http-proxy-port=8888'。