Share via

Modules Window (Compact 2013)

  • Article

3/26/2014

The Modules window enables you to load and unload the symbols for a module. It provides different information depending on whether the debugger is running or if it is at a debug stop or a breakpoint. To display the window, go to Debug > Windows > Modules.

A symbol is a name that represents a register, an absolute value, or a relative or absolute memory address. Symbols, generated by the compiler, explain the relationship between source code and object code.

Using the Modules window, you can:

  • Display information about symbols
  • Change symbols
  • Unload symbols
  • Use an executable file to reload symbols
  • Log symbols
  • Set debug zones
  • Choose docking or non-docking mode

When the Debugger Is Running

The following list describes the columns of information that appear in the Modules window when the debugger is running.

  • Module
    Displays the names of modules running on the target device. Does not include modules loaded as data files; for example, resource-only/multilingual user interface (MUI) .dll files. For more information about data files, see Target Control Debugging: gi Command.
  • Image Address Range
    Displays the address range in the memory of the device where the module is located.
  • Module Handle
    Identifies the handle to the module.
  • Usage Mask
    Identifies the number of the process that is using the .dll file.
  • Relocated-Data Address Range
    Displays the address range of relocated data. If no data was relocated, this field is blank.

  • Status
    Displays the status of the module's debugger symbols.

    • Loaded - Debugger has loaded debugger symbols.
    • Unloaded - Debugger has not loaded debugger symbols.
  • Timestamp
    Indicates the time stamp of the most recently loaded symbol file.

  • Flags
    Identifies flags that indicate actions taken when the module was loaded. The following table shows the possible values.

    Flag

    Value

    Description

    DON’T_RESOLVE_DLL_REFERENCES

    0x1

    If the executable file is a DLL, the system did not call DllMain for process and thread initialization. In addition, this value indicates that the kernel did not load the DLL dependencies.

    LOAD_LIBRARY_AS_DATAFILE

    0x2

    DLL was mapped into the virtual address space of the calling process as if it were a data file.

    LOAD_WITH_ALTERED_SEARCH_PATH

    0x8

    Not supported.

    LOAD_LIBRARY_IN_KERNEL

    0x8000

    DLL was loaded by LoadKernelLibrary.
  • Trust Level
    Indicates the trust level of the module.
  • PDB Name
    Displays the name of the .pdb file that contains the symbols for the module.
  • PDB GUID
    Displays the GUID for the .pdb file.
  • PDB Age
    Displays the number of seconds elapsed since the .pdb file produced.
  • Symbol Path
    Displays the path where the symbols for the module are stored on the desktop computer.

When the Debugger Is Stopped

The following list describes the columns of information that appear in the Modules window when the debugger is stopped and Target Control Debugging is running.

  • Module
    Displays the names of all modules running on the device.
  • Address
    Displays the load address in the memory of the device where the module is located.
  • Module/Process Handle
    Displays the handle for the module or process.

  • InUSE
    Displays the In Use status for the module.

    Executable (.exe) files display Not Available.

Context Menu

A context menu appears when you right-click the Modules window. Some functions on this menu are also available as toolbar buttons. The context menu contains the following functions.

  • Copy
    Copies the text of the selected row to the clipboard.
  • Refresh
    Deletes all entries in the window and updates the window to contain the most recent entry information.
  • Log
    Formats and copies all data in this window to the Log tab of the Output window.
  • Auto Refresh on Step
    Performs a Refresh function after each debugger step operation.
  • Auto Log on Step
    Performs a Log function after each debugger step operation.
  • Load Symbols
    Loads the debugger symbols for the selected module. Disabled when symbols are not available.
  • Unload Symbols
    Unloads the debugger symbols for the selected module.
  • Load All Symbols
    Loads the debugger symbols for all modules.
  • Unload All Symbols
    Unloads the debugger symbols for all modules.
  • List Sources
    Lists the source files for the highlighted module.
  • List process
    Lists all processes for this module. Disabled when in run mode.

See Also

Reference

Debug Zones Dialog Box

Concepts

Platform Builder User Interface

Other Resources

Platform Builder Windows