Intel® Inspector User Guide for Linux* OS

ID 767796
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of 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

CAUTION:

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