mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-23 14:42:11 +02:00
58330519ae
Change-Id: I45c1c184c2b79b9bb463b6217fdbf6104e0c5abd Signed-off-by: Marc Khouzam <marc.khouzam@ericsson.com> Reviewed-on: https://git.eclipse.org/r/30659 Tested-by: Hudson CI Reviewed-by: Jeff Johnston <jjohnstn@redhat.com> Tested-by: Jeff Johnston <jjohnstn@redhat.com>
46 lines
2.4 KiB
Text
46 lines
2.4 KiB
Text
The CDT Stand-alone Debugger brings up an minimal Eclipse instance which has all that
|
|
is needed of the CDT plug-ins to debug a C/C++ executable. Build is not supported.
|
|
Editing is allowed, but you will need to rebuild outside the Stand-alone Debugger for
|
|
those changes to manifest in your debugging session.
|
|
|
|
To install the Stand-alone debugger locally in your $HOME directory, run the install.sh
|
|
script found in the scripts sub-directory of the plugins directory in your Eclipse installation:
|
|
|
|
./install.sh
|
|
|
|
The install script will create a cdtdebugger directory in your $HOME directory. This
|
|
directory will contain a config.ini file, a dev.properties file, and a cdtdebug.sh script.
|
|
The cdtdebug.sh script will start the debugger from the command-line. The cdtdebug.sh script
|
|
does not have to be located in the cdtdebugger directory and can be moved if you prefer.
|
|
|
|
The script takes a few options which are mentioned below:
|
|
|
|
-data : workspace to use for your Eclipse session if you do not want the default
|
|
$HOME/workspace-cdtdebug
|
|
|
|
-consoleLog : if you want error messages reported directly to the command console
|
|
|
|
-a : specify attaching to an existing executable on system. A dialog will
|
|
be brought up to allow you to select which one.
|
|
|
|
-b $PATH : path to build log for an executable. This will be used to figure out
|
|
include paths and compilation flags. This option assumes you will
|
|
be using the -e option described below.
|
|
|
|
-c $CPATH : path to core-file. This option must precede a -e option to specify an
|
|
executable.
|
|
|
|
-e $PATH [args...] : path to your executable to debug plus any optional command line
|
|
arguments to pass to main(). This option must be last and should
|
|
not precede any other arguments as they will be treated as arguments
|
|
to main.
|
|
|
|
If no -a or -e option is specified, the last executable debugged via -e will be offered for
|
|
debugging. Otherwise, if this is the first time, a dialog will be presented to enter
|
|
an executable, build log, and program arguments.
|
|
|
|
e.g. ~/cdtdebugger/cdtdebug.sh -b ~/build.log ~/myproject/bin/a.out arg1 arg2
|
|
|
|
The cdtdebug.sh script that is found in the plug-in can also be run directly, but cannot
|
|
be moved. The one installed in the cdtdebugger directory on the other hand, can be moved.
|
|
|