Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "CDT/User/FAQ"

< CDT
m (/* How can I add another extension to CDT so that files other than c/cpp/cc/h files are recognized as source files? My compiler needs the file extension to be "xyz", and when I open xyz files there is)
(Replaced content with "{{warning|Note: The contents of this page is obsolete, but it may still contain some interesting tid-bits. Please see the [https://github.com/eclipse-cdt/cdt/tree/main/FAQ...")
 
(258 intermediate revisions by 63 users not shown)
Line 1: Line 1:
== Introduction ==
+
{{warning|Note: The contents of this page is obsolete, but it may still contain some interesting tid-bits. Please see the [https://github.com/eclipse-cdt/cdt/tree/main/FAQ#readme FAQ in the GitHub site] for current information or the page history for historical information }}
  
==== How do I contribute to this FAQ? ====
+
[[Category:CDT]] [[Category:FAQ]]
 
+
Simply edit this page and add content. You can now use your bugzilla username and password to gain access.
+
 
+
==== Is it really that easy? ====
+
 
+
Yes!
+
 
+
== General ==
+
 
+
==== What is the CDT? ====
+
 
+
The CDT (C/C++ Development Tools) Project is working towards providing a fully functional C and C++ Integrated Development Environment (IDE) for the Eclipse platform.
+
 
+
There are a number of groups contributing to the CDT; We strongly encourage interested parties to extend our work, thereby making the Eclipse CDT project a richer set of freely available resources. We are looking for contributions from the open source community in the areas of test, development, documentation, and general users who can help us ensure that the C/C++ tools work well on all the Eclipse platforms. 
+
 
+
Our current release function includes:
+
 
+
:* C/C++ Editor (basic functionality, syntax highlighting, code completion etc.)
+
:* C/C++ Debugger (APIs & Default implementation, using GDB)
+
:* C/C++ Launcher (APIs & Default implementation, launches and external application)
+
:* Parser
+
:* Search Engine
+
:* Content Assist Provider
+
:* Makefile generator
+
 
+
Default implementations of all interfaces and extension points will be supplied for various platforms.
+
 
+
The CDT is fully open-source and implemented purely in java as a set of plugins to the [http://www.eclipse.org/ Eclipse] platform. To learn more visit the [http://www.eclipse.org/cdt CDT Home Page].
+
 
+
==== How is the CDT licensed? ====
+
 
+
The CDT consists of software produced by the CDT team combined with third party software developed from other Open Source Projects. The software produced by the CDT team is licensed under the [http://www.eclipse.org/legal/cpl-v05.html Common Public License]. The software designed by third parties is made available under their respective licenses. Refer to the about.html file in the root directory of every CDT plugin for specific licensing information.
+
 
+
==== How is the CDT Project organized? ====
+
 
+
Visit [http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/cdt-home/developer/Project%20Structure.html?cvsroot=Tools_Project CDT Project Structure] to find out more about the organization of CDT (History, participants, and project structure).
+
 
+
==== How do I find out about future releases of the CDT? ====
+
 
+
See the [[CDT/planning]] section.
+
 
+
If you wish to contribute to the development of the CDT, we welcome the opportunity to work with you. The plans will be updated to reflect the commitments made by contributors to this projects.  See Working on the CDT for information on how to get started.
+
 
+
Release Milestones (which represent planned availability dates for Stable CDT builds) are noted in the CDT Plan Documents which can be found on the [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/overview.html?cvsroot=Tools_Project CDT Overview Page]. To see the currently available CDT builds, choose from either the [http://www.eclipse.org/cdt/downloads.php current official release] or from the [http://download.eclipse.org/tools/cdt/builds/ nightly builds].
+
 
+
==== What is the default configuration supported by the CDT? ====
+
 
+
This is a bit of a moving target, but currently the compiler supported (from an error parsing point of view) is gcc, the debugger interface will work with gdb 5.2.1 (or higher) and the default build command is GNU "make".
+
 
+
==== Which operating systems does the CDT support? ====
+
 
+
The CDT Framework is platform independent. It will run where Eclipse will run. However, the default implementations may depend on external applications. To follow in the Eclipse spirit of open source, the default implementations rely upon freely available open source tools, such as the GNU Tools: GDB and Make. Therefore, the dependencies on GDB for debugging, or Make for building, will require that these applications are available for the platform that the user wishes to use. References to some of the known implementations for each platform will be indicated in the sections of this FAQ that include instructions for installation, project creation and building the CDT on the various platforms.
+
 
+
==== Which platforms are fully supported will ultimately depend on the needs of the community, as expressed by the participation in developing, and testing for each platform? ====
+
 
+
The core plugins are written in Java with no native code and thus may be ported to any platform supported by Eclipse. However, some default implementations may require that other software or tools, licensed under GNU, may be required.
+
 
+
In general there is some version of Linux and some version of windows used by the developers on the CDT.  For an exact list of supported platforms see the [http://download.eclipse.org/tools/cdt/releases/callisto/dist/3.1.0/ Downloads page].
+
 
+
==== Why isn't the XXX operating system supported by CDT? ====
+
 
+
"Supported" has a particular meaning to us. It means that on that platform we have a good level of confidence that CDT works correctly and that its function is appropriate and complete. That means
+
 
+
:* someone has ensured that the function addresses the important use cases
+
:* the function is exercised by regular execution of a test plan
+
:* identified problems are tracked to resolution
+
:* there is a recipient for user feedback
+
:* code patches are developed as necessary to correct or extend CDT on that platform
+
 
+
To make this all happen a platform has an Owner - someone who accepts the responsibility to make sure those things all happen.
+
 
+
The Framework supports all the platforms that Eclipse does. The CDT team is responsible for ensuring that this remains true for the framework. Specific default implementations will work only on platforms where the required applications are available. The following list is derived from the initial CDT meeting in July 2002. The following companies have agreed to provide support for the associated platforms:
+
{| class="wikitable" style="border: 1px solid #dddddd;"
+
! style="border: 1px solid #aaaaaa;"| Platform
+
! style="border: 1px solid #aaaaaa;"| Company
+
|-
+
| style="border: 1px solid #aaaaaa;"|QNX Neutrino
+
| style="border: 1px solid #aaaaaa;"| QNX Software Systems Ltd.
+
|-
+
| style="border: 1px solid #aaaaaa;"| Linux
+
| style="border: 1px solid #aaaaaa;"| IBM, Red Hat
+
|-
+
| style="border: 1px solid #aaaaaa;"| Windows
+
| style="border: 1px solid #aaaaaa;"|IBM, MontaVista with initial support from QNX
+
|}
+
If you have a favorite platform we highly encourage you to get involved and volunteer to own a feature that does not currently have an implementation that works on your platform of choice.  See [[#Working on the CDT]] for more information.
+
 
+
==== How do I ask questions? ====
+
 
+
CDT related questions that are not answered in this FAQ or the documentation should be posted to the [news://www.eclipse.org/eclipse.tools.cdt CDT newsgroup]. You will need a [http://dev.eclipse.org/newsManager/newsRequestForm.html password]. You can also use this simple web interface to browse the newsgroup.
+
General Questions about the Eclipse SDK which includes the [http://www.eclipse.org/platform Eclipse Platform], [http://www.eclipse.org/jdt JDT] (Java Development Tools), or http://www.eclipse.org/pde PDE] (Plugin Development Environment) should be posted to the [news://eclipse.org/eclipse.tools Eclipse newsgroup].
+
 
+
Keep in mind that these newsgroups are public, so do not include any confidential information in your questions. You should also read [http://www.catb.org/~esr/faqs/smart-questions.html "How to ask questions the smart way"] by Eric Raymond before participating in the newsgroups. NOTE: Please submit bugs to [http://dev.eclipse.org/bugs bugzilla], not to the newsgroups. See the [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/faq.html?cvsroot=Tools_Project#general_70 How do I report a bug or request a feature?] section of this document.
+
 
+
People will still come into a newsgroup asking questions that have been answered before and often will not provide any information about what versions they have installed, and what the problem is.  You will be much more likely to get help if you provide enough information to reproduce the problem.  The section on [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/faq.html?cvsroot=Tools_Project#general_90 how to report a bug] gives a list of some information which could be useful.
+
 
+
==== How do I report a bug or request a feature? ====
+
 
+
The CDT Project (like the Eclipse Project) uses [http://www.bugzilla.org/ bugzilla] as its bug and feature tracking system. Entering a bug\feature report is as simple as filling in a web form on the [http://dev.eclipse.org/bugs/ eclipse bugzilla page]. The first time you enter a bug you will need to [http://dev.eclipse.org/bugs/createaccount.cgi create a new bugzilla account] for yourself by providing an email address and choosing a password.
+
 
+
Before entering a bug report, you should [http://dev.eclipse.org/bugs/query.cgi search bugzilla] to see if someone else has already entered a bug report similar to yours. If you find a bug report that outlines the problem you are seeing, you can simply annotate it with your comments to let the developers know that you have also hit the bug. Also you can add yourself to the CC list of the bug so that you will notified when the status of the bug changes or someone adds comments.
+
 
+
Once you have searched bugzilla and not found anything, you can go ahead and enter a new bug report. Please read the bug writing guidelines located on the [http://dev.eclipse.org/bugzilla.html eclipse bug reporting page].
+
 
+
To make your bug report more helpful include the following in your bug reports:
+
 
+
Environmental settings:
+
 
+
:  1. The build level of Eclipse that you are using. For example, "Eclipse 3.0M6"
+
:  2. The build level of CDT that you are using. For example, "CDT build 2.0.0.0026"
+
:  3. Your computer's specifications (OS version + patch level, memory, other pertinent info)
+
:  4. The contents of your .log file (or lack thereof). This is especially important if you get a dialog that reports an internal error. See What is this .log file I hear so much about? for information on finding your .log file.
+
:  5. The Java runtime or development kit you are using to run eclipse (use java -version or java -fullversion)
+
 
+
Problem Description:
+
 
+
:  1. A description of what you were doing,
+
:  2. A description of what behavior that you observed, and
+
:  3. An explanation of how the observed behavior differs from the expected behavior
+
 
+
==== Where is this .log file that I hear so much about? ====
+
 
+
The .log file is located in the workspace/.metadata directory.
+
 
+
The .log file is used by the Eclipse Platform to log runtime errors. It is useful to include it in bug reports because it contains stack traces that occur in plug-ins. When you report a bug, make sure to include your .log file!
+
 
+
== Download and Installation ==
+
 
+
==== Which CDT build should I download? ====
+
 
+
The latest stable release version is available from the [http://www.eclipse.org/cdt/downloads.php CDT downloads page].
+
 
+
==== I can't find the CDT download for the XXX operating system? ====
+
 
+
The CDT is supported on the platforms specified on the download page. The downloads are structured and named to indicate, which OS and windowing system it runs on. If you do not see your OS/windowing system combination please contact us. We are always looking for volunteers to test and support platforms.
+
 
+
Much of the CDT default functionality uses applications that are available on most operating systems. The CDT leverages some default system tools such as gdb (debugging), make (building). These tools are available for many platforms and if they exist on your system, there is a good chance that the default functionality will work.  See Compilers and other 3rd party tools for more information
+
 
+
The caveat is that the operation of the CDT on some operating systems has not been fully tested and we cannot commit time to fixing platform specific problems found on these platforms. However, code submissions from developers wanting to improve the CDT will always be gratefully accepted.  See Working ON the CDT for more information.
+
 
+
==== How do I uninstall CDT? ====
+
 
+
We do not currently ship an uninstaller. You can uninstall the CDT manually:
+
: 1. Shutdown the eclipse shell that is running CDT
+
: 2. Remove the CDT plugins
+
::*  Navigate to the directory where the CDT plugins are installed (typically eclipse/plugins)
+
::*  Remove the following plugins:
+
:::*  org.eclipse.cdt.*
+
: 3.  Remove the CDT metadata
+
::*  Navigate to the workspace/.metadata/.plugins directory
+
::*  Remove the following directories (if they exist):
+
:::*  org.eclipse.cdt.*
+
: 4. Restart Eclipse
+
 
+
==== How do I convince Eclipse to "re-read" the configuration files? ====
+
 
+
Delete the following:
+
:* /configuration/org.eclipse.osgi/manifests
+
:* /configuration/org.eclipse.osgi/.bundledata
+
:* /configuration/org.eclipse.osgi/.state
+
and restart eclipse.
+
 
+
== C/C++ Project Creation ==
+
 
+
==== Creating a simple Managed C++ Project -- "Hello World on a Windows Platform" ====
+
 
+
This section will use an example to create the familiar "Hello World!" C++ program. First, ensure that you have the CDT installed within Eclipse, as described above. Open a C/C++ Perspective and complete the following steps:
+
 
+
: 1. For C/C++ projects Build Automatically should be turned off (Bugzilla Bug 71443), otherwise builds will be performed whenever a file is saved, including makefiles and header files. As well the explicit build menus will not be accessable.
+
 
+
:  Click 'Projects' from the menubar and ensure there is no checkmark beside 'Build Automatically' if there is one click 'Build Automatically' to deselect it.
+
: 2. In the C/C++ Projects View right click and select "New Project ..."
+
: 3. Select "C++" in the left pane and the select "Managed Make C++ Project"
+
: 4. Enter a name for the new project and select Finish. Note: you can determine the "Build Settings" from this dialog, but we will do so later, in the build section.
+
: 5. In the C/C++ Projects View right click and select "New" > "Simple" > "File". Name your file hello.cpp
+
: 6. Copy the following text into the "hello.cpp" file:
+
                 
+
      #include <stdio.h>
+
      int main()
+
      {
+
          printf("Hello World\n");
+
                         
+
          //block until user types something
+
          fgetc(stdin);
+
          return 0;
+
      }
+
                   
+
 
+
:  Now, save the file.
+
       
+
 
+
==== Creating a simple Standard C++ Project -- "Hello World on a Windows Platform" ====
+
 
+
This section will use an example to create the familiar "Hello World!" C++ program. First, ensure that you have the CDT installed within Eclipse, as described above. Open a C/C++ Perspective and complete the following steps:
+
 
+
: 1. In the C/C++ Projects View right click and select "New Project ..."
+
: 2. Select "C++" in the left pane and the select "Standard Make C++ Project"
+
: 3. Enter a name for the new project and select Finish. Note: you can determine the "Build Settings" from this dialog, but we will do so later, in the build section.
+
: 4. In the C/C++ Projects View right click and select "New" > "Simple" > "File". Name your file hello.cpp
+
: 5. Repeat the previous step and name the second new file "makefile".
+
: 6. Copy the following text into the "hello.cpp" file:
+
 
+
      #include <stdio.h>
+
      int main()
+
      {
+
          printf("Hello World\n");
+
                         
+
          //block until user types something
+
          fgetc(stdin);
+
          return 0;
+
      }
+
 
+
:      Now, save the file.
+
:  7. Copy the following text into the "makefile" file:
+
:    Remember that makefile requires that indented lines use a <tab> character and not spaces
+
 
+
      hello.exe : hello.o
+
      g++ -o hello.exe hello.o
+
 
+
      hello.o : hello.cpp
+
      g++ -c hello.cpp
+
     
+
      all : hello.exe
+
      clean :
+
      -rm hello.exe hello.o
+
             
+
 
+
:    Now, save the file.
+
 
+
==== How do I create a new project using a directory full of existing source? ====
+
 
+
If the source is accessible to the user from their desktop using the command line then it is possible to simply make the root directories containing that source as Eclipse projects. This is accomplished by invoking the New Project Wizard, selecting C or C++ and then Standard Make Project as the project type. On the next page, enter a name for the project, the deselect the "Use Default Location" checkbox. This will let you Browse to the root folder of the source tree. After setting other information and clicking on Finish, the project will be created in the root of the source folder you have selected.
+
 
+
The resource for the project are maintained in the remote location specified, not in the workspace folder for eclipse. Meta data for the project, such as the index for the project and the "link" to the project, is stored in the metadata directory in the workspace folder.
+
 
+
==== How do I create a new project using CVS? ====
+
 
+
If the existing source tree is managed in CVS, it is possible to use the CVS Repository perspective to "Checkout As Project" any folder in the repository. The first time this is done, a Simple Project is created for the folder. To access the features of the CDT for this project, the project must be converted to a C or C++ project using the "Convert to a C or C++ Project" project type in the New Wizard.
+
 
+
This does a CVS checkout of the project into the project's location (usually in the workspace).
+
 
+
==== How do I Import existing code into an existing project? ====
+
 
+
Another approach would be to create the C/C++ Project and then do an "Import"->"File System". This will make a copy of the files from the selected location into the selected folder in the project. With the copy, this approach is more wasteful and detaches the source from any control mechanism that existed in the originally file location (e.g. a ClearCase view)
+
 
+
== Editing C/C++ Projects ==
+
 
+
====  I'd like to use the code assist functionality, but it doesn't seem to work for me. I don't get anything showing up when I select CTRL+SPACE in a C/C++ source file. ====
+
 
+
Content Assist is a work in Progress. For CDT 2.0 you should be able to ask for code completion anywhere in your source file. If you fail to find a completion you expect to find, most probably this is because of a failure in parsing your source file. In this case, check that you have added the correct set of include paths to the project containing your source file.
+
 
+
      For example in the following code:
+
 
+
      int main() {
+
          pr
+
      }
+
 
+
You should not expect "pr" to provide "printf" as a completion unless:
+
:* You have an #include <stdio.h>  in the file
+
:* the include path to stdio.h is available in the project
+
:* any macro's necessary to read stdio.h are set (often a missing macro will cause a system header to encounter a #error in the header file -- for example on windows using cygwin, the defining the symbol __i386__ will allow stdio.h to be understood)
+
 
+
As we improve and further develop the CDT, this function will get better and better.
+
 
+
==== Search is broken! ====
+
 
+
Often when search is not behaving as expected, it is due to the CDT not having enough information available to parse the source files.  For example, if you include a header file, but do not tell CDT about the directory where that header file exists, then it is unlikely that CDT will understand the contents of your source file.
+
 
+
==== I am having problems with the outline view ====
+
 
+
The outline view does not respect macros and header contents.  It is simply a file view.  This may not be what you desire.
+
 
+
==== I am using a non gun compiler and I get the following messages: "Error launching external scanner info generator (gcc -E -P -v -dD" and "File not indexed because it was not built ". How do I get rid of them? ====
+
 
+
In general the parser needs to know the include paths and macro definitions for each source file and the compiler built-ins before it can be parsed(the indexer is one client that will parse the files).
+
 
+
In CDT there is a scanner config feature that will invoke the compiler "gcc -E -P -v -dD" to ask it for the default values.  This feature will also look at the output of running "make" and try to determine which includes (-I) and which defines (-D) have bee set on the command line.
+
 
+
Your project has been setup to use the defaults for gnu to get this info.  Since you are using a non-gnu compiler, you should disable all of the discovery feature.  Got to the Properties on your project and open the section "C/C++ Make project" and select the "Discovery Options" tab.  Deselect the "Automate discovery of paths and symbols" and these errors will go away.
+
 
+
Note that you will then need to manually add the paths and symbols to the project (or you will get a lot of other parser errors).  This can be done from the same dialog under "C/C++ Include paths and symbols".
+
 
+
==== How can I add another extension to CDT so that files other than c/cpp/cc/h files are recognized as source files? My compiler needs the file extension to be "xyz", and when I open xyz files there is no syntax highlighting. ====
+
 
+
Go to
+
:  Preferences -> Workbench -> Editors -> File Associations
+
and add a new File Association xyz
+
 
+
== Building C/C++ Projects ==
+
Not yet available, in the meantime see [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/faq.html?cvsroot=Tools_Project#toc old FAQ].
+
== Debugging C/C++ Projects ==
+
Not yet available, in the meantime see [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/faq.html?cvsroot=Tools_Project#toc old FAQ].
+
== Miscellaneous Troubleshooting ==
+
 
+
Under construction. In the meantime see [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/faq.html?cvsroot=Tools_Project#toc old FAQ].
+
 
+
==== When I attempt to run my application, I get the following error ====
+
      Entry Point Not Found - The procedure entry point __getreent could not be located in the dynamic link library cygwin1.dll.
+
 
+
Cause: a different cigwin1.dll is picked up from your PATH first.
+
Solution: make sure that only the cygwin1.dll that comes with your active installation of Cygwin is available in the PATH environment variable.
+
 
+
== Compilers and other 3rd party tools ==
+
 
+
==== Does CDT include a compiler? ====
+
 
+
CDT does not come with a compiler, so if you do not have one you will need to install one. Follows
+
are options available to you:
+
 
+
: * MacOS X: Install the developer tools DVD that came with your computer or with you MacOS X DVD.
+
: * Linux: If not already installed, it should be available on your installation CDs.
+
: * Windows: You have a choice of compilers available:
+
:: * [http://www.cygwin.com/ Cygwin]: Cygwin is a Linux-like environment for Windows, includes GCC.
+
:: * [http://www.mingw.org/ MinGW]: Environment that includes development toolsets
+
:: * [http://www.delorie.com/djgpp/ DJGPP]: DJGPP is a complete 32-bit C/C++ development system for Intel 80386 (and higher) PCs running DOS.
+
 
+
== Working on the CDT ==
+
 
+
==== How do I build CDT from CVS if I want a more recent build than is on the downloads page? ====
+
 
+
# Switch to the CVS Perspective: Window > Open Perspective > Others ... and select "CVS Repository Exploring"
+
# Context menu in "CVS Repositories" View, New > Repository Location
+
# Location - Host: dev.eclipse.org  Repository Path:  /cvsroot/tools
+
# Authentication -  User: anonymous (no password required)
+
# Connection - type: pserver 
+
# Click 'Finish'
+
# Open up the resulting /cvsroot/tools tree.. find org.eclipse.cdt-releng/all
+
# On each of the projects under 'all', click context menu > Check Out
+
 
+
==== How do I export it so that it can be used with an external Eclipse installation? ====
+
 
+
: You can either:
+
 
+
: a) Export the CDT feature via File->Export->Plugin Development->Deployable Features.  This will automatically export all the required plugins.
+
 
+
: b) Export all the plugins etc. individually or all at once via File->Export->Plugin Development->Deployable Plugins and Fragments. However, this is more error prone and you're better off doing a).
+
 
+
: c) Use the ANT stuff in org.eclipse.cdt.releng to build CDT the way the nightly build does.
+
 
+
* I want to differntiate between the "Debug" and "Release" modes in my project. Is there any preprocessors in use already (some #define like "#define DEBUG" for Debug mode) or should I have to define them manually in my project. I find verbose in project options, but I am not sure how to use it ?
+
 
+
Back to [[CDT]] wiki page.
+

Latest revision as of 11:08, 9 November 2022

Warning2.png
Note: The contents of this page is obsolete, but it may still contain some interesting tid-bits. Please see the FAQ in the GitHub site for current information or the page history for historical information

Back to the top