API (*.rsm)

From RAD Studio
Jump to: navigation, search

Go Up to File Types Index

When you build a Delphi project for 32-bit Windows, 64-bit Windows, or macOS, 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, iOS Simulator, 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.
  • <project>.dylib.rsm for macOS.

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>

To change the output directory, use the Package output directory or Output directory option in Project > Options > Delphi Compiler.

See Also