Posted by & filed under Documentation.

The Understand 2.0GUI has command line options that may prove useful to you automation and personal efficiency reasons.

To see the options, just start Understand with “-help”:

%understand -help

2008-07-24 22.56

Here are the current options (updated 24 July 2008):

Understand file1 file2 file3 etc [options]

Open a list of files by including the list after the application name.



Use this option to pas arguments to an existing instance of Understand. If more than one exists, the one with the lowest PID will get the commands.Will start new one if none exist.

cwd path

Set the current working directory to “path”. Doesn’t change the cwd if path doesn’t exist.


Use the path to the last opened project as the cwd.

db filename

Open the project file “filename”. Does not assume .udb extension.


Open the last project opened by the application.

noproject )

Do not open a project. This overrides -project, -lastproject, and also (more usefully) automatic settings to load projects on startup.It also clears any automatic settings so they will not happen until set again in the GUI.

visit filename [line-number column-number]

Open the file “filename” in an editor window. Path is relative to CWD of Understand instance doing the visit. Optionally position caret at line-number and column-number

contextmenu filename [-line number -col number -text number]

Show the context-menu for “filename” at the current global mouse coordinates. For better accuracy as to what entity the menu acts on specify more information with -line, -col and -text. This is useful for integrating Understand context menus into other editors, debuggers and other applications. See Using Understand with an External Editor for an example of using this menu in SlickEdit.


Startup understand and load a database:

understand -db foo.udb

Load file foo.cpp existing Understand 2.0 instance.

understand foo.cpp -existing

Open the Understand and automatically open the last project:

understand -lastproject

Visit line 22, column 3 of file foo.cpp in an existing instance of Understand 2.0

understand -existing -visit foo.cpp 22 3

Bring up the context menu for an function named “foo” in file foo.cpp

understand -existing -contextmenu foo.cpp -text foo