Intel® Inspector User Guide for Linux* OS

User Guide

  • 2021.4
  • 09/27/2021
  • Public Content
Contents

search-dir

Specify an alternative location(s) for finding application support files.

Syntax

-search-dir all|bin|src|sym[:p|:r|:rp]=
<PATH>
Arguments
The pathname of a search directory, the type of file and search instructions.
pathname
The PATH/name of the search directory, and can include environment paths and absolute paths.
File types
  • all: any of these file types
  • bin: binary files
  • src: source files
  • sym: symbol files
:r
Perform a recursive search of all subdirectories
:p
Specify the highest priority search directories, which will be searched prior to others. Use this to avoid picking up the wrong module by absolute path when moving a result between machines.
:rp
Combine these two arguments to perform a recursive search of all subdirectories and indicate highest priority search directories.
Example:
-search-dir all:r=C:\myProject
For multiple arguments: You may specify this option multiple times in a single command, or specify multiple arguments in a comma-separated list (no spaces). For example, the following are equivalent:
-search-dir all:p=dir1 -search-dir sym=dir2 -search-dir bin:r=dir3
-search-dir all:p=dir1,sym=dir2,bin:r=dir3
Make sure there are no spaces after commas.
Default
For binary and symbol information files: System environment PATH settings and directory in which target resides.
For source files: Directories specified in debug information files.
Description
Use
search-dir
 when you want to search non-standard directories during target execution, analysis, and finalization. This can be useful when:
  • Source files reside somewhere other than where debug information indicates.
  • Debug information files are not located with binary files.
Example
This example:
  • Runs a
    Detect Deadlocks and Data Races (ti2)
     analysis on the application
    myApp
    .
  • Searches the
    nonstandard
     subdirectory within the current working directory for support files needed to execute the
    myApp
     target during the
    collect
     action.
  • Stores the result in the default
    r@@@ti2
     result directory in the current working directory, where
    @@@
     represents the next available number.
  • Generates a summary report of detected problems, and writes it to the
    inspxe-cl.txt
     file in the result directory. 
$ inspxe-cl -collect ti2 -search-dir all=nonstandard -- myApp

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.