Cscope 的使用

- 日理万妓 2022-06-03 04:00 388阅读 0赞

--------------------

<table style="font-family:'Times New Roman'"> 
 <tbody> 
  <tr> 
   <td> <pre> 8、Cscope 的使用

这下更厉害了, 用Cscope自己的话说 - "你可以把它当做是超过频的ctags", 
其功能和强大程度可见一斑吧, 关于它的介绍我就不详细说了, 如果你安装好了前
文介绍的中文帮助手册, 用下面的命令看看介绍吧:
        :help if_cscop.txt
 
    我在这里简单摘抄一点, 供还在犹豫的朋友看看:
    Cscope 是一个交互式的屏幕下使用的工具，用来帮助你:
        * 无须在厚厚的程序清单中翻来翻去就可以认识一个 C 程序的工作原理。
        * 无须熟悉整个程序就可以知道清楚程序 bug 所要修改的代码位置。
        * 检查提议的改动 (如添加一个枚举值) 可能会产生的效果。
        * 验证所有的源文件都已经作了需要的修改；例如给某一个现存的函数添
          加一个参数。
        * 在所有相关的源文件中对一个全局变量改名。
        * 在所有相关的位置将一个常数改为一个预处理符号。

它被设计用来回答以下的问题:
        * 什么地方用到了这个符号？
        * 这是在什么地方定义的？
        * 这个变量在哪里被赋值？
        * 这个全局符号的定义在哪里？
        * 这个函数在源文件中的哪个地方？
        * 哪些函数调用了这个函数？
        * 这个函数调用了哪些函数？
        * 信息 "out of space" 从哪来？
        * 这个源文件在整个目录结构中处于什么位置？
        * 哪些文件包含这个头文件？

安装Cscope:
    如果你的系统中有cscope命令, 则可以跳过这一小段, 如果没有, 就先跟着我
一起安装一个吧.
    在Cscope的主页: <a href="http://cscope.sourceforge.net/" rel="nofollow">http://cscope.sourceforge.net</a>下载一个源码包, 解压后
编译安装:
        # ./configure
        # make
        # make install       // 需要root权限

先在~/vimrc中增加一句:
        :set cscopequickfix=s-,c-,d-,i-,t-,e-
 
    这个是设定是否使用 quickfix 窗口来显示 cscope 结果, 用法在后面会说到
。

跟Ctags一样, 要使用其功能必须先为你的代码生成一个cscope的数据库, 在项
目的根目录运行下面的命令:

$ cd /home/wooin/vim71/
        $ cscope -Rbq
        # 此后会生成三个文件
        $ ll cscope.*
        -rw-rw-r-- 1 wooin wooin 1.1M 2007-09-30 10:56 cscope.in.out
        -rw-rw-r-- 1 wooin wooin 6.7M 2007-09-30 10:56 cscope.out
        -rw-rw-r-- 1 wooin wooin 5.1M 2007-09-30 10:56 cscope.po.out
        # 打开文件, 开始Coding
        $ cd src
        $ vi main.c
 
    进入vim后第一件事是要把刚才生成的cscope文件导入到vim中来, 用下面的命
令:
        :cs add /home/wooin/vim71/cscope.out /home/wooin/vim71 
    上面这条命令很重要, 必须写全, 不能只写前半句:
        :cs add /home/wooin/vim71/cscope.out
    因为源码是多级目录的, 如果这样写, cscope是无法在子目录中的源码中工作
的, 当然, 如果你的源码都在同一级目录中就无所谓了. 如果你要经常用cscope的
话, 可以把上面那句加到~/.vimrc中去.

下面我们来操练一下, 查找函数vim_strsave()的定义, 用命令:
        :cs find g vim_strsave

(--- 图8 ---)
    按下回车后会自动跳转到vim_strsave()的定义处. 此时你肯定会说Ctags也可
以做到这个呀, 那么下面说的这个Ctags就无法做到了, 我想查找vim_strsave()到
底在那些地方被调用过了, 用命令:
        :cs find c vim_strsave 
    按下回车后vim会自动跳转到第一个符合要求的地方, 并且在命令栏显示有多少
符合要求的结果, 如图:

(--- 图9 ---)
    如果自动跳转的位置你不满意, 想看其他的结果, 可以用下面的命令打开Quick
Fix窗口:
        :cw
 
    如图:

(--- 图10 ---)
    这时你就可以慢慢挑选了^_^

cscope的主要功能是通过同的子命令"find"来实现的
    "cscope find"的用法:
    cs find c|d|e|f|g|i|s|t name

0 或 s   查找本 C 符号(可以跳过注释) 
    1 或 g   查找本定义 
    2 或 d   查找本函数调用的函数 
    3 或 c   查找调用本函数的函数 
    4 或 t   查找本字符串 
    6 或 e   查找本 egrep 模式 
    7 或 f   查找本文件 
    8 或 i   查找包含本文件的文件

如果每次查找都要输入一长串命令的话还真是件讨人厌的事情, Cscope的帮助
手册中推荐了一些快捷键的用法, 下面是其中一组, 也是我用的, 将下面的内容添
加到~/.vimrc中, 并重启vim:
         <pre style="border:0px; font-family:'Courier 10 Pitch',Courier,monospace; font-size:13px; margin-top:0px; margin-bottom:1.625em; outline:0px; padding:0.75em 1.625em; vertical-align:baseline; background-color:rgb(244,244,244); line-height:1.5; overflow:auto; color:rgb(55,55,55)">"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
" cscope setting
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
if has("cscope")
  set csprg=/usr/bin/cscope
  set csto=1
  set cst
  set nocsverb
  " add any database in current directory
  if filereadable("cscope.out")
      cs add cscope.out
  endif
  set csverb
endif

nmap &lt;C-@&gt;s :cs find s &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;g :cs find g &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;c :cs find c &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;t :cs find t &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;e :cs find e &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;f :cs find f &lt;C-R&gt;=expand("&lt;cfile&gt;")&lt;CR&gt;&lt;CR&gt;
nmap &lt;C-@&gt;i :cs find i ^&lt;C-R&gt;=expand("&lt;cfile&gt;")&lt;CR&gt;$&lt;CR&gt;
nmap &lt;C-@&gt;d :cs find d &lt;C-R&gt;=expand("&lt;cword&gt;")&lt;CR&gt;&lt;CR&gt;
 </pre>    当光标停在某个你要查找的词上时, 按下&lt;C-_&gt;g, 就是查找该对象的定义, 其他的同理.    按这种组合键有一点技巧,按了&lt;C-_&gt;后要马上按下一个键,否则屏幕一闪就回到nomal状态了    &lt;C-_&gt;g的按法是先按"Ctrl+Shift+-", 然后很快再按"s"    很奇怪, 其中的这句:        nmap &lt;C-_&gt;i :cs find i ^&lt;C-R&gt;=expand("&lt;cfile&gt;")&lt;CR&gt;$&lt;CR&gt;    在我的vim中无法工作, 但是我改成:        nmap &lt;C-_&gt;i :cs find i &lt;C-R&gt;=expand("&lt;cfile&gt;")&lt;CR&gt;&lt;CR&gt;    就可以正常工作了, 不知道是什么原因? 有哪位朋友知道请告诉我.    cscope的其他功能你可以通过帮助手册自己慢慢学习    reset : 重新初始化所有连接。    用法  : cs reset</pre> </td> 
  </tr> 
 </tbody> 
</table>