Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Quick start

Install Ripscope, then open a terminal in your C project. Keep the project index on a local disk. For other storage arrangements, see index locations.

1. Find a definition

Search for a function in your project. This example finds main.

ripscope -R -L -1 main

Ripscope creates the index, searches subdirectories and prints each matching file, function, line number and source line. Replace main with another function name to explore your code.

2. Find more code

Use the search that fits your question.

FindCommand
A definitionripscope -L -1 NAME
Callers of a functionripscope -L -3 NAME
Functions it callsripscope -L -2 NAME
Assignments to a variableripscope -L -9 NAME

Replace NAME with a function or variable from your project. Command-line searches refresh the index automatically after edits.

3. Search from your editor

With the installer or one plugin-manager line, open a C file in your project and search: :cs find g main in Vim, :RipscopeFind g main in Neovim, or C-c s g in Emacs. The first search indexes the project into your cache directory, and later searches see your saved edits. The Vim, Neovim and Emacs guides explain how the project is found, file-list selection and optional manual updates.

Prefer a guided example? Follow the example project. For include directories, file lists and other project options, see building an index.