function::usymline - Linux


function::usymline interrogates C++ classes, functions, and variables for user-specified symbols. It allows for easy and efficient analysis of source code for specific symbols.


function::usymline [options] [<file> | --all]


  • -a, –all: Scans all source files in the current directory and subdirectories.
  • -c, –count-files: Prints the number of files containing the specified symbol(s).
  • -f, –function-symbol: Searches for the specified function symbol.
  • -g, –global-symbol: Searches for the specified global variable or class symbol.
  • -s, –symbol: Specifies the symbol to search for.
  • -t, –type: Specifies the type of symbol to search for (function or global).
  • -v, –verbose: Displays more detailed output, including the path and line number where symbols are found.


Simple usage:

function::usymline -s MyFunction

Search for all functions named "MyFunction":

function::usymline -f MyFunction

Search for all global variables named "MyVariable":

function::usymline -g MyVariable

Count files containing the symbol "MySymbol":

function::usymline -c -s MySymbol

Common Issues

  • No matching symbols found: Ensure that the specified symbol exists in the source code and that the search parameters are correct.
  • Access denied: Verify that you have the necessary permissions to access the source files.


Combine with grep:

function::usymline -s MyFunction | grep -E "int|float"

Parse results with Python:

import subprocess

output =["function::usymline", "-s", "MyFunction"], stdout=subprocess.PIPE).stdout
symbols = [line.strip() for line in output.decode("utf-8").splitlines()]

Related Commands

  • c++filt
  • ctags
  • nm