文件首頁
MySQL NDB Cluster API 開發人員指南
相關文件 下載本手冊
PDF (US Ltr) - 3.6Mb
PDF (A4) - 3.6Mb


4.3.1.13 Dbug

Dbug 允許 clusterj 應用程式啟用 cluster ndbapi 程式庫中的 DBUG 功能。dbug 狀態是一個控制字串,由以冒號分隔的旗標組成。旗標為

  • d 設定偵錯旗標

  • a[,filename] 將偵錯輸出附加到檔案

  • A[,filename] 類似 a[,filename],但會在每次操作後清除輸出

  • d[,keyword[,keyword...]] 啟用來自具有指定關鍵字的巨集的輸出

  • D[,tenths] 在每次操作後延遲指定的十分之一秒

  • f[,function[,function...]] 將輸出限制為指定的函式清單

  • F 在每個輸出中標記來源檔的檔案名稱

  • i 在每個輸出中標記目前程序的程序 ID

  • g[,function[,function...]] 設定指定函式清單的設定檔

  • L 在每個輸出中標記來源檔的行號

  • n 在每個輸出中標記目前的函式巢狀深度

  • N 在每個輸出中標記連續的數字

  • o[,filename] 將偵錯輸出覆寫到檔案

  • O[,filename] 類似 o[,filename],但會在每次操作後清除輸出

  • p[,pid[,pid...]] 將輸出限制為指定的程序 ID 清單

  • P 在每個輸出中標記程序名稱

  • r 將縮排層級重設為零

  • t[,depth] 將函式巢狀限制為指定的深度

  • T 在每個輸出中標記目前的時間戳記

例如,若要追蹤呼叫並僅針對「jointx」輸出偵錯資訊,並覆寫檔案「/tmp/dbug/jointx」的內容,請使用「t:d,jointx:o,/tmp/dbug/jointx」這個控制字串。上述內容可以寫成 ClusterJHelper.newDbug().trace().debug("jointx").output("/tmp/dbug/jointx").set();

4.3.1.13.1 摘要
 public interface Dbug {
// Public Methods  public abstract Dbug append(String fileName);
  public abstract Dbug debug(String string);
  public abstract Dbug debug(String[] strings);
  public abstract Dbug flush();
  public abstract String get();
  public abstract Dbug output(String fileName);
  public abstract void pop();
  public abstract void print(String keyword,
                             String message);

  public abstract void push();
  public abstract void push(String state);
  public abstract void set();
  public abstract void set(String state);
  public abstract Dbug trace();
}
4.3.1.13.2 append(String)
public abstract Dbug append(String fileName);

指定偵錯輸出的檔案名稱 (附加)。

表 4.26 append(String)

參數 描述
fileName 檔案的名稱
傳回

4.3.1.13.3 debug(String)
public abstract Dbug debug(String string);

設定偵錯關鍵字清單。

表 4.27 debug(String)

參數 描述
string 逗號分隔的偵錯關鍵字
傳回

4.3.1.13.4 debug(String[])
public abstract Dbug debug(String[] strings);

設定偵錯關鍵字清單。

表 4.28 debug(String[])

參數 描述
strings 偵錯關鍵字
傳回

4.3.1.13.5 flush()
public abstract Dbug flush();

強制在每次輸出操作後清除。

表 4.29 flush()

參數 描述
傳回

4.3.1.13.6 get()
public abstract String get();

傳回目前狀態。

表 4.30 get()

參數 描述
傳回 目前狀態

4.3.1.13.7 output(String)
public abstract Dbug output(String fileName);

指定偵錯輸出的檔案名稱 (覆寫)。

表 4.31 output(String)

參數 描述
fileName 檔案的名稱
傳回

4.3.1.13.8 pop()
public abstract void pop();

彈出目前的狀態。新的狀態將會是先前推送的狀態。

4.3.1.13.9 print(String, String)
public abstract void print(String keyword,
                           String message);

列印偵錯訊息。

4.3.1.13.10 push()
public abstract void push();

推送方法定義的目前狀態。

4.3.1.13.11 push(String)
public abstract void push(String state);

推送目前的狀態,並將參數設定為新的狀態。

表 4.32 push(String)

參數 描述
state 新的狀態

4.3.1.13.12 set()
public abstract void set();

將目前狀態設定為方法定義的狀態。

4.3.1.13.13 set(String)
public abstract void set(String state);

從參數設定目前的狀態。

表 4.33 set(String)

參數 描述
state 新的狀態

4.3.1.13.14 trace()
public abstract Dbug trace();

設定追蹤旗標。

表 4.34 trace()

參數 描述
傳回