|Stable release||15.8 / June 15, 2012|
|Operating system||Unix, Linux|
|Type||C and C++ programming tool|
cscope is a console mode or text-based graphical interface that allows computer programmers or software developers to search C source code (there is limited support for other languages). It is often used on very large projects to find source code, functions, declarations, definitions and regular expressions given a text string. cscope is free and available under a BSD License. The original developer of cscope is Joe Steffen.
The history of the tool goes back to the days of the PDP-11, but it is still used by developers who are accustomed to using the vi or Vim editor or other text-based editors (instead of GUI-based editors). The functionality within Cscope is available to varying degrees in modern graphical source editors.
Mode of use
cscope is used in two phases. First a developer builds the cscope database. The developer can often use
find or other Unix tools to get the list of filenames that they need to index into a file called
cscope.files. The developer then builds a database using the command
cscope -b -q -k. The
k flag is intended to build a database for an operating system/and or C library source code. It will not look in
/usr/include. Second, the developer can now search those files using the command
cscope -d. Often an index needs to be re-built whenever changes are made to files.
In software development it is often very useful to be able to find the callers of a function because this is the way to understand how code works and what other parts of the program expect from a function. cscope can find the callers and callees of functions, but it is not a compiler and it does that by searching the text for keywords. This has the disadvantages that macros and duplicate symbol names can generate an unclear graph. There are other programs that can extract this information by parsing the source code or looking at the generated object files.
CCTree is a native Vim plugin that integrates with the Vim editor and offers functionalities similar to Kscope and Seascope.