Code::Blocks command line arguments

From Code::Blocks
Revision as of 13:18, 5 November 2024 by Mgimenez (talk | contribs) (→‎Command line arguments: Add missing arguments and remove duplicated ones)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Using command line arguments

Windows

  1. Find the Code::Blocks shortcut in the Desktop or Start menu.
  2. Right click on the icon and select Properties.
  3. Select the Shortcut tab.
  4. Append the command line arguments you want to use to the end of the Target text (behind the quote mark).
  5. Run Code::Blocks by using the shortcut you edited.

Example

"C:\Program Files\CodeBlocks\codeblocks.exe" /na /nd

*nix

  1. Launch a terminal client, such as XTerm, Gnome Terminal or Konsole.
  2. Type "codeblocks" and then append the command line arguments you want to use.

Note: Code::Blocks can not run on a real console, X11 must be running and you must use a graphical terminal emulator.

Example

codeblocks --no-splash-screen --debug-log

Command line arguments

Argument Function
Windows Windows(MSYS2, WSL)

Linux, Unix, MacOS

<filename> Specifies the project *.cbp filename or workspace *.workspace filename. For instance <filename> may be c:\some\where\a\project.cbp. Place this argument at end of command line, just before output redirection if any.
/h, /? --help, --? Shows a help message about the command line arguments.
--safe-mode Load in safe mode (all plugins will be disabled).
/na --no-check-associations Don't perform any file association checks (Windows only).
/nd --no-dde Don't start a DDE server (Windows only).
/ns --no-splash-screen Hides the splash screen when the application is loading.
--multiple-instance Allow running multiple instances.
/d --debug-log Display application's debug log.
/nc --no-crash-handler Do not use the crash handler (useful for debugging C::B).
/v --verbose Show more debugging messages.
--prefix=<str> Sets the shared data directory prefix.
--user-data-dir=<str> Specify an alternative directory for user settings and user installed plugins
/p str --personality=<str>, --profile=<str> Sets the personality to use. You can use ask as the parameter to list available personalities.
--no-log Turn off the application log.
--log-to-file Redirect application log to a file.
--debug-log-to-file Redirect application debug log to a file.
/S name --set=name Set ''name'' to current active set for global variables (after [r13245]).
/D str If str = "<set>.uservar.mem=val", set the member mem of uservariable uservar in set to value val. This overrides the current set value (after [r13245]).
--rebuild Clean and build the project / workspace.
--build Build the project / workspace.
--clean Clean the project/workspace
--target=<str> Sets target for batch build, for example --target="Release".
--no-batch-window-close Keeps the batch log window visible after the batch build has completed.
--batch-build-notify Shows a message after the batch build has completed.
--script=<str> specify a script file to run after loading
--file=<filename>[:line] Open file in Code::Blocks and optionally jump to a specific line.
--dbg-config=<str> Selects the debugger config used for attaching.
--dbg-attach=<str> str is passed to debugger plugin which is used for attaching to a process.
> <build log file> Placed in the very last position of command line, this may be used to redirect standard output to log file, this is not a codeblock option as such, but just a DOS/*nix shell usual standard output redirection