Building an MPI program with Managed Build

Topics include:

• Creating an MPI project
• Include paths
• Specifying the mpicc toolchain

Creating an MPI Project

1. To create a new MPI project in C using the managed build facility, Select File -> New -> Project ... The New Project dialog opens.
2. Select C -> Managed Make C Project.

3. Click Next.
4. Type the name of your project, e.g. MyCProject
   

5. Click Finish.
   • A dialog prompts you to switch to the C/C++ Perspective.
   • Hit OK. The C/C++ Perspective appears.
   • Your new project is shown in the C/C++ Projects view.

6. Now create a source file. Click File -> New -> Source File.
7. Type a name for the source file, e.g. "test.c"

8. Click Finish.
   • A new editor appears, in which you can enter your program.

9. Since this is a managed build project, Eclipse creates a makefile and tries to build with the new file.
   • As the file is empty, you will see errors in the Problems view, and in the Console view. Ignore these.

10. Enter a program in the editor. (If you have the PTP MPI Tools installed, a sample program is available in the PTP MPI tools help, available as: testMPI.c
11. Save your program. The program will be compiled automatically by the managed build system.
    • You will probably see several errors. The first error may be that an include file isn't found.

• (If you hover the mouse cursor over the red "X" you will see the reason for the error)

Include Paths

1. In order to locate needed include files, bring up the Project Properties on this C/C++ project.
2. To bring up the Project Properties dialog, activate the context menu on the Project, and select "Properties."
   
   

3. The project properties window is displayed for this C project.
4. Select "C/C++ Build" on the left, and under "Configuration settings" on the "Tool Settings" tab, select "Directories" under "GCC Compiler."
   • This lists the Include paths used to build the project, which are now empty.

5. To add an include path, click the add button for Include Paths.

6. Then enter or browse to find the location of the MPI includes, and select "OK."

7. Now you also need to add the path to the library: Under GCC Linker, Libraries, select the add button for "Libraries (-l)"

8. For the library value, enter 'mpi' and select 'OK'

9. Then select the add button for "Library Search Path (-L)" and enter the path to the lib directory. Select 'OK'

10. Now select "OK" in the project properties dialog to close this dialog. Now your project should rebuild without errors relating to finding the include files.

Specifying the mpicc toolchain

1. Now specify the build/link command.
2. Again in Project properties, C/C++ build page, Tool Settings tab, click on "GCC C compiler" and change the default "gcc" value to "mpicc" (or whatever the build command is for your MPI environment).

3. Then do the same for the "GCC C Linker."

4. Now proceed to launch the parallel program.

Back to Top | Back to Table of Contents