IDE Command Line Switches and Options
Go Up to IDE Reference and Utilities
Describes available options when starting the IDE from the command line.
Contents
IDE command line switches
The following options are available when starting the IDE from the command line.
You must precede all options (unless otherwise noted) with either a dash (-) or a slash (/). The options are not case-sensitive. Therefore, the following options are all identical:
-d /d -D /D
Use the IDE command line switches with the startup command for the IDE:
bds.exe
Examples Using BDS.EXE
Code | Does this |
---|---|
bds.exe -ns |
Starts the RAD Studio IDE with no splash screen. |
bds.exe -sd c:\test\source -d c:\test\myprog.exe \mbox{-}td |
The |
bds.exe /ProductInfo: |
Allows you to query installed SKUs, platforms, personalities, and trials. Type the following commands:
Note: Use the ToolsAPI.IOTAPersonalityServices for details of each personality.
|
General options for BDS.EXE
Option | Description |
---|---|
? |
Launches the IDE and displays online help for IDE command-line options. |
-- (two hyphens) |
Ignore rest of command-line. |
ns |
No splash screen. Suppresses display of the splash screen during IDE startup. |
np |
No welcome page. Does not display the welcome page after starting the IDE. |
p personality |
Starts the specified personality of the RAD Studio IDE. The possible values for personality are:
|
r regkey |
Alternate registry key. Allows you to specify an alternate base registry key so you can run two copies of the IDE using different configurations. This allows component developers to debug a component at design time by using the IDE as the hosting application, without the debugging IDE interfering by trying to load the component package being developed. |
cleanregistryide |
Clean the registry entries for the IDE. Deletes the BDS current user registry key and files under appdata in the BDS directory. Caution: You will lose all your projects from the BDS directory, so back them up before starting BDS with this option. This is the last resort, not the first thing you should try when troubleshooting the IDE. |
highdpi:VALUE |
High-DPI awareness. By default, the IDE runs as DPI-aware using perMonitorv2 support. To force the IDE to run DPI-unaware set the Note: The IDE runs high-DPI by default
Possible values for this parameter are:
|
Debugger options
Option | Description |
---|---|
attach:%1;%2 |
Performs a debug attach. Uses %1 as the process ID to attach to and %2 as the event ID for that process. The |
d exename |
Loads the specified executable (exename) into the debugger. Any parameters specified after the exename are used as parameters to the program being debugged and are ignored by the IDE. A space is allowed between the |
The following options can only be used with the -d
option:
Option | Description |
---|---|
debugger=borwin32 debugger=embwin32 debugger=embwin64 debugger=embmacosx debugger=embios debugger=embandroid |
Indicates the debugger to use. If this option is omitted, the debugger that was first registered in the IDE is used.
|
l |
(Lowercase L) Assembler startup. Do not execute startup code. Must be used with the -d option. Normally, when you specify the |
sd directories |
Source Directories. Must be used with the |
h hostname |
Remote debugger host name. Must be used with the |
t workingdirectory |
Working directory for your debug session. Corresponds to "Working directory" setting on the Load Process dialog box. No space is allowed between |
Project options
Option | Description |
---|---|
filename |
(No preceding dash) Loads the specified filename in the IDE. It can be a project, project group, or a single file. |
b |
AutoBuild. Must be used with the |
m |
AutoMake. Same as AutoBuild, but a make is performed rather than a full build. |
ooutputfile |
Output file. Must be used with the |