Blame SOURCES/cdtdebug.man

5c4483
.\" Manpage for cdtdebug.
5c4483
.\" Contact jjohnstn@redhat.com to correct errors or typos.
5c4483
.TH man 1 "07 July 2014" "1.0" "cdtdebug man page"
5c4483
.SH NAME
5c4483
cdtdebug \- The Eclipse C/C++ Stand-alone Debugger
5c4483
.SH SYNOPSIS
5c4483
cdtdebug [
5c4483
.I "ECLIPSE-OPTIONS"
5c4483
] [
5c4483
.B -h, --help
5c4483
] [
5c4483
.B -b 
5c4483
.I build-log
5c4483
] [
5c4483
.B -a
5c4483
] | [
5c4483
.B -c
5c4483
.I core
5c4483
] 
5c4483
.B -e
5c4483
.I executable...
5c4483
]
5c4483
.SH DESCRIPTION
5c4483
cdtdebug is a graphical C/C++ debugger using Eclipse and gdb.  The debugger uses Eclipse plug-ins and features found in the eclipse-cdt package
5c4483
and invokes an Eclipse application specialized to bring up just the C/C++ debugging elements.  The debugger can be used to debug executables,
5c4483
core files, and can also attach to existing processes.  Internally, gdb is used to perform the debugging tasks via the gdb/mi interface.  For more info, see the upstream
5c4483
.UR https://wiki.eclipse.org/CDT/StandaloneDebugger
5c4483
wiki page
5c4483
.UE .
5c4483
.SH OPTIONS
5c4483
.PP
5c4483
Operation modes:
5c4483
.IP "\fB-h, --help\fR"
5c4483
.PD
5c4483
print help, then exit.
5c4483
.PD
5c4483
.PP
5c4483
Indexing assist options:
5c4483
.IP "\fB-b \fIbuild-log\fR"
5c4483
.PD
5c4483
specify build log to use for compiler includes/flags.
5c4483
.PP
5c4483
Target options:
5c4483
.IP "\fB-a\fR"
5c4483
.PD
5c4483
attach to an existing process (list will be shown).
5c4483
.PD
5c4483
.IP "\fB-c \fIcore\fR"
5c4483
.PD
5c4483
debug core file (need to also specify corresponding executable).
5c4483
.PD
5c4483
.IP "\fB-e \fIexecutable\fR [ \fIargs...\fR ]
5c4483
.PD
5c4483
debug given executable (passing
5c4483
.I args
5c4483
to main).
5c4483
.PD
5c4483
.PP
5c4483
The 
5c4483
.B -e
5c4483
option must be used last as subsequent options are passed to main.
5c4483
5c4483
Specifying insufficient arguments for a particular target will result in a
5c4483
dialog displayed to enter the required values for that target.  Specifying
5c4483
no target option brings up a dialog for debugging an executable with the
5c4483
executable path, program arguments, and build log filled in from the last
5c4483
.B -e
5c4483
invocation, if one exists.
5c4483
5c4483
For details on options that can be passed to Eclipse, see:
5c4483
.UR http://help.eclipse.org/luna/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Frunning_eclipse.htm
5c4483
.UE .
5c4483
.SH SEE ALSO
5c4483
.I gdb(1)
5c4483
.SH BUGS
5c4483
No known bugs.
5c4483
.SH AUTHOR
5c4483
Jeff Johnston (jjohnstn@redhat.com)
5c4483
.SH COPYRIGHT
5c4483
Copyright (c) 2014 Red Hat Inc.
5c4483
5c4483
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with the Invariant Sections being "Free Software" and "Free Software Needs Free Documentation", with the Front-Cover Texts being "A GNU Manual," and with the Back-Cover Texts as in (a) below.
5c4483
5c4483
(a) The FSF's Back-Cover Text is: "You are free to copy and modify this GNU Manual.  Buying copies from GNU Press supports the FSF in developing GNU and promoting software freedom."
5c4483