% cscope
% 杨秀隆
% 20140619

cscope

相当于 source insight 里的 look up reference

帮助文档

:help if_cscop.txt

它被设计用来回答以下的问题:

• 什么地方用到了这个符号？

• 这是在什么地方定义的？

• 这个变量在哪里被赋值？

• 这个全局符号的定义在哪里？

• 这个函数在源文件中的哪个地方？

• 哪些函数调用了这个函数？

• 这个函数调用了哪些函数？

• 信息 "out of space" 从哪来？

• 这个源文件在整个目录结构中处于什么位置？

• 哪些文件包含这个头文件？

安装Cscope

如果你的系统中有cscope命令, 则可以跳过这一小段, 如果没有, 就先跟着我一起安装一个吧.

在Cscope的主页: //cscope.sourceforge.net 下载一个源码包, 解压后编译安装:

./configure

make

make install //需要root权限

配置

在~/vimrc中增加一句:

:setcscopequickfix=s-,c-,d-,i-,t-,e- 这个是设定是否使用 quickfix 窗口来显示 cscope 结果, 用法在后面会说到。

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

$ 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

使用cscope

进入vim后第一件事是要把刚才生成的cscope文件导入到vim中来, 用下面的命令:

:cs add ../cscope.out /home/wooin/vim71

不能只写前半句

:cs add ../cscope.out

因为源码是多级目录的, 如果这样写, cscope是无法在子目录中的源码中工作的, 当然, 如果你的源码都在同一级目录中就无所谓了.如果你要经常用cscope的话, 可以把上面那句加到~/.vimrc中去.

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

:csfind g vim_strsave 如下图:

按下回车后vim会自动跳转到第一个符合要求的地方, 并且在命令栏显示有多少符合要求的结果, 如图:

如果自动跳转的位置你不满意, 想看其他的结果, 可以用下面的命令打开QuickFix窗口:

:cw

这时你就可以慢慢挑选了^_^

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:

nmaps :cs find s=expand("")

nmap g :cs find g=expand("")

nmap c :cs find c=expand("")

nmap t :cs find t=expand("")

nmap e :cs find e=expand("")

nmap f :cs find f=expand("")

nmap i :cs find i^=expand("")$

nmap d :cs find d=expand("") 当光标停在某个你要查找的词上时, 按下g, 就是查找该对象的定义, 其他的同理.

按这种组合键有一点技巧,按了后要马上按下一个键,否则屏幕一闪就回到nomal状态了

g的按法是先按"Ctrl+Shift+-", 然后很快再按"g"

reset :重新初始化所有连接。

用法 : csreset