RSM Debug File

From RAD Studio
Jump to: navigation, search

Go Up to File Types Index

When you build a Delphi project for 32-bit Windows or 64-bit Windows, and the Include remote debug symbols option in Project > Options > Delphi Compiler > Linking is true, RAD Studio generates an RSM debug file.

Symbol tables contain information for the debugger such as the mapping of machine instructions to source line numbers or the names and types of variables declared in the source files. When you debug Delphi projects locally, RAD Studio does not use your RSM debug file because the compiler holds the symbol tables in memory. However, when you debug Delphi projects remotely, you must generate an RSM debug file that contains those symbol tables; otherwise, RAD Studio does not stop at your breakpoints.

Note: For iOS Device, macOS, macOS ARM, Linux, and Android, the Delphi compiler generates the debug information inside the executable. You do not need an RSM debug file for these platforms.

The file name of the RSM debug file is:

  • <project>.rsm for 32-bit Windows and 64-bit Windows.

When you build your Delphi project, your RSM debug file is generated by default into the following folder:

  • In packages:
    • For 32-bit Windows: C:\Users\Public\Documents\Embarcadero\Studio\22.0\Bpl
    • For other platforms: C:\Users\Public\Documents\Embarcadero\Studio\22.0\Bpl\<platform>
Note: You do not need a package RSM debug file to debug packages.
  • For other projects: C:\Users\<user>\Documents\Embarcadero\Studio\Projects\<project>\<platform>\<build configuration>
Note: RSM file must be in the same directory as the application you are debugging, or in the debug symbols search path; if not, the debugger will not find it. This is only applicable to Win32 platform (remote debugging) and Win64 platform (local and remote debugging). To change the package output directory, and output directory, go to Project > Options > Delphi Compiler. To change the debug symbols search path, go to Project > Options > Debugger > Symbol Tables.

See Also