跳到主要內容

gj: 閱讀 C/C++ 原始碼的好幫手

兩年前剛開始接觸大型 C++ 專案時, 研究了一下尋找 symbol 相關位置的工具。最後依自己的需求, 做了一個小工具 gj。經歷了近兩年的使用和改進, gj 已成為我工作環境裡不可或缺的一塊了。

gj 的特點是:

  • 建立索引和找尋 symbol 的時間極短, 沾 ID Utils 的光, 不費任何力氣就有這樣的成果。
  • 盡可能不要漏掉可能的相關檔案, 並提供互動過濾的機制, 方便找出目標。
  • 和 vim 整合一起使用。

這裡有 gj demo 的畫面。

雖說目前已可應付我自己的九成需求, 還是有不少可改進的地方, 只是用到的情境較少就懶得補了。大家若有興趣使用, 歡迎提供建議。愈多人有需求, 愈有動力來改。或是用過 gj 後, 覺得有其它和 vim 整合得好工具, 也歡迎推薦。

留言

  1. 有試過 unite.vim + unite-grep + unite-tag 嗎 ?

    回覆刪除
  2. 之前沒試過, 看起來頗多功能的, unite-grep 也有內文搜尋 + 檔案路徑的過濾機制, 果然大家的需求都差不多 http://vimeo.com/24700977

    改天來試用看看, 謝啦

    回覆刪除
  3. 試用gj感覺不錯, 目前我也是用vim trace code ,
    但是在有個困搞就trace過程很容易搞亂trace 流程, 目前我只用紙筆紀錄
    不知道是否有什麼有效方法紀錄起來
    謝謝

    回覆刪除
  4. 這問題也困擾著我, 嘗試過紙筆和 vim 後, 目前我是用 vim 另開文字檔記錄。

    主要的原因是方便複製貼上關鍵的函式碼或 backtrace。比方說針對觀察的 call flow 有五層函式一路 call 下去, 我會對這五個函式分別取我有興趣的程式碼, 貼到文字檔裡, 方便我釐清這個 call flow 做了那些事, 為什麼要做這些事

    同時, 我會逐步記錄「我想解決的是什麼問題」, 「已知的事實為何」, 「由已知的事實得出的推論 = 接下來要驗證的目標」, 「目前的疑問 (例如相斥的推論)」。

    不過用 vim 的缺點就是不能像紙筆那樣天馬行空的畫圖, 但考量到要複製或打的字太多了, 目前還是以 vim 編文字檔為主。還在摸索有沒有更方便的作法

    回覆刪除
    回覆
    1. 有考慮graphviz嗎?
      用寫小程式方式來畫圖
      在一開始用
      f1[label="function1()"];
      f2[label="function2()"];
      就可以把一長串的函數名稱縮寫
      接下來用f1->f2就可以在函數間自由連接
      也不用管圖片擺放位置,他會自動幫你調好

      刪除
  5. 之前有用過 graphviz 畫 data flow, 滿方便的。印象中有看過別人作的工具, 用 graphviz 產生 call flow (好像是只能處理 C)。我自己的感覺是這類工具會產生太多資訊, 圖太大不容易讀, 使用經驗不多, 不太有參考性就是了。目前習慣針對有興趣的地方加 log, 配合 gdb 看 backtrace 或直接 log backtrace, 還能應付目前遇到的情況。

    回覆刪除

張貼留言

這個網誌中的熱門文章

(C/C++ ) 如何在 Linux 上使用自行編譯的第三方函式庫

以使用 LevelDB 為例。 抓好並編好相關檔案,編譯方式見第三方函式庫附的說明:$ ls include/ # header files leveldb/ $ ls out-shared/libleveldb.so* # shared library out-shared/libleveldb.so@ out-shared/libleveldb.so.1@ out-shared/libleveldb.so.1.20* 下面的例子用 clang++ 編譯,這裡用到的參數和 g++ 一樣。 問題一:找不到 header$ clang++ sample.cpp sample.cpp:5:10: fatal error: 'leveldb/db.h' file not found #include "leveldb/db.h" ^ 1 error generated. 解法:用 -I 指定 header 位置 問題二:找不到 shared library$ clang++ sample.cpp -I include/ /tmp/sample-2e7dd8.o: In function `main': sample.cpp:(.text+0x1e): undefined reference to `leveldb::Options::Options()' sample.cpp:(.text+0x6f): undefined reference to `leveldb::DB::Open(leveldb::Options const&, std::string const&, leveldb::DB**)' sample.cpp:(.text+0x10c): undefined reference to `leveldb::Status::ToString() const' sample.cpp:(.text+0x7d0): undefined reference to `leveldb::Status::ToString() const' clang: error: linker command failed with exit code 1 (u…

熟悉系統工具好處多多

記一下以前很困擾, 現在秒殺的小事。 更新這篇的時候, 忘了函式庫用的 man page 裝在那個 package。以前就會想辦法 google, 運氣好一下會找到, 運氣不好會多找一會兒。 這回我想到新作法:$ strace -e open man 3 printf > /dev/null # 發現是讀 /usr/share/man/man3/printf.3.gz $ dpkg --search /usr/share/man/man3/printf.3.gz # 找到套件名稱 manpages-dev $ aptitude show manpages-dev # 確認描述符合, 收工

virtualbox 使用 USB 裝置

2012-12-16 更新 現在 (4.x 版) 似乎無需做任何設定, 只要有裝 Oracle VM VirtualBox Extension Pack, 在 VirtualBox 視窗右下角按 USB 的圖示, 再點目標裝置, 即可加入或移除該裝置 同一時間只有 host 或 guest 可擁有該裝置, 所以從 guest OS 移除, 相當於接回 host OS 目前 VirtualBox 只支援 USB 2.0 的插槽, 若偵測不到時, 注意一下是否為這個問題 有時拔拔插插, VirtualBox 會進入奇怪的狀態, 接上去 guest OS 無法連接且跳出 device is busy 的錯誤訊息。試看看拔除該裝置, 重開 guest OS (續上則) 若重開 guest OS 無效, 並且 host OS 已移除該裝置, VirtualBox 的 USB 清單卻仍顯示 "captured", 試看看拔除該裝置, 重開 host OS原文網路上搜一下, 比較多是 Ubuntu 當 host 的解法, 我的情況是 Win7 當 host, Ubuntu 當 guest。 這兩篇說明很詳細《Learn How to Set Up USB and Networking Options in VirtualBox》《幻影千瞳的部落格: VirtualBox 使用筆記(二):使用 USB 裝置》 現在的版本圖形介面很好用了, 不用像第二篇說的那樣用指令操作。這裡記下我的操作步驟: 關掉 guest OS 在 VirtualBox 選單, 選擇 guest OS -> Settings -> USB -> Enable USB 2.0 會出現訊息框, 說明要安裝 Oracle VM VirtualBox Extension Pack。下載後安裝它 host OS 插入 USB 隨身碟 在 VirtualBox 選單, 選擇 guest OS -> Settings -> USB, 點右邊有綠色 "+" 的 USB 頭的圖示, 選擇該 USB 隨身碟, 加入它的 filter 從 host OS 移除 USB 隨身碟 開啟 guest OS 插入 USB 隨身碟, 於是 guest OS 會自動偵測…