Intel® Inspector User Guide for Linux* OS

ID 767796
Date 5/15/2022
Public

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

Document Table of Contents

Binary/Symbol Search and Source Search Locations

When using the Intel Inspector:

Binary/Symbol Search Locations

searches binary and symbol files in default locations and in locations specified in the Binary/Symbol Search tab (if specified).

The following lists describe the order and default locations that are searched. As indicated below, some directory searches examine the specified directory and its subdirectories, while other searches do not examine its subdirectories.

The search order on Windows* OS systems is the following:

  1. Search for binary and symbol files in the directories specified in the Binary/Symbol Search tab and their subdirectories (if enabled in the tab).
  2. Search for symbol files in the directories near the related (corresponding) binary file(s) just found, such as a library:
    • Check in the directory of the corresponding binary file, using the corresponding name.
    • Check in the directory of the corresponding binary file, using a related name. For example, for app.dll where a file app_x86.pdb is present, also search for file app.pdb.
  3. Search for files in Visual Studio project directories.

    For symbol files, also search using symbol server paths specified in the Binary/Symbol Search tab in the following notation: srv*C:\localsymbols*http://msdl.microsoft.com/download/symbols and/or provided in Visual Studio Tools > Options > Debugging > Symbols.

  4. Search for binary files in this standard Windows OS system directory:
    • %SYSTEMROOT%\system32\drivers (subdirectories are not searched)
  5. Search for symbol files in these standard Windows OS system directories:
    • All directories specified in the environment variable_NT_SYMBOL_PATH (subdirectories are not searched)
    • srv*%SYSTEMROOT%\symbols (symbol downstream or cache path)
    • %SYSTEMROOT%\symbols\dll (subdirectories are not searched)

The search order on Linux* OS systems is the following:

  1. Search for binary and symbol files in the directories specified in the Binary/Symbol Search tab and their subdirectories (if enabled in the tab).
  2. Search for binary files in directories from the collected result that provide an absolute path name. If the file name vmlinux is present, search these directories:
    • /usr/lib/debug/lib/modules/`uname -r`/vmlinux
    • /boot/vmlinuz-`uname -r`
  3. Search for symbol files in the directories near the related (corresponding) binary file(s) just found, such as a library:
    • Check in the directory of the corresponding binary file, using the corresponding name.
    • Check in the directory of the corresponding binary file, using a related name. For example, for app.dll where a file app_x86.pdb is present, also search for file app.pdb.
    • Search in the .debug subdirectory.
  4. Search for binary files in these standard Linux OS system directories:
    • /lib/modules (subdirectories are not searched)
    • /lib/modules/`uname -r`/kernel (subdirectories are searched)
  5. Search for symbol files in these standard Linux OS system directories:
    • usr/lib/debug(subdirectories are not searched)
    • /usr/lib/debug with appended path to the corresponding binary file, such as /usr/lib/debug/usr/bin/ls.debug

Source Search Locations

A limited set of default source locations are used in addition to the locations specified in the Source Search tab.

The following list describes the order and default locations that are searched. As indicated below, some directory searches examine the specified directory and its subdirectories, while other searches do not examine its subdirectories.

  1. Search for source files in the directories specified in the Source Search tab.
  2. Search for source files in directories from the collected result that provide an absolute path name.
  3. On Linux OS systems: Search for source files in these standard Linux locations (does not search subdirectories):
    • /usr/src
    • /usr/src/linux-headers-`uname -r`