whereis subcommand for dbx: Display the full qualifications of symbols

Format

whereis [-exhaustive] identifier

Description

The whereis subcommand displays the full qualifications of all the symbols whose names match the specified identifier. The order in which the symbols print is not significant.

Options

-exhaustive
Specifies that whereis is to search for symbols in all compile units. This option only applies when a module map is being used. If one is being used, then the default is to use quick mode, which searches for symbols only in the current compile unit and global lists. In that case, using this option might degrade performance. If a module map is not being used, then this subcommand always searches for symbols in all compile units.

Usage notes

  1. The whereis subcommand can be run only while the dbx debug program is running.

Examples

  1. To display the qualified names of all symbols named x, enter:
    whereis x
    An example of a possible output is:
    "x1.c".x
    
    FDBX9998: whereis quick mode will only search symbol x in current CU 
    and global lists. 	To list all symbol x, please use whereis -exhaustive x,
    but that will cause all debug data files to be loaded and performance 
    will be degraded.
  2. To display the qualified names of all symbols named x in exhaustive mode, enter:
    whereis -exhaustive x
    An example of a possible output is:
    ."x1.c".x
    ."x2.c".x

Related information

The which subcommand.