<< " border=0>

> " border=0>

1 Getting Started

• 1.1 Overview
• 1.2 Invoking PGHPF
  • 1.2.1 PGHPF Command-line Syntax
  • 1.2.2 Compiler Command-line Options
• 1.3 Filename Conventions
  • 1.3.1 Input Files
  • 1.3.2 Output Files

This chapter describes how to use PGHPF to control the translation process for a program written in High Performance Fortran (HPF). The PGHPF command is called the compilation driver. The compilation driver controls several phases of compilation: HPF compiling, Fortran preprocessing and compiling, assembling and linking (linking includes the correct PGHPF runtime routines for the target communications protocol). Since PGHPF runs on a variety of host systems and generates output for several target systems, the commands that allow you to run (execute) a program will vary from system to system.

1.1 Overview

In general, using PGHPF, the compilation process involves three steps:

1. Produce an HPF program and give your file a .hpf, .f90, .for , .F or .f file extension. The HPF program may be a program that you have written or a program that you are modifying for parallel execution.
2. Compile the HPF program using PGHPF and supply appropriate compiler command line options. This produces a ready to run binary file and by default links the HPF runtime libraries.
3. Execute the binary file on the target system (the target system may be your local system). The execution behavior of your program can be controlled with runtime command line options or environment variables.

The PGHPF compiler allows many variations on these general program development steps. These variations include the following:

• Stop the compilation after HPF compilation, after Fortran compilation or after assembling to save and examine intermediate results.
• Provide options to the driver that control compiler optimization, that specify an alternate communications protocol, or to enable various compiler features.
• Include as input intermediate files such as preprocessor output, compiler output or assembler output.

The PGHPF compiler targets an SPMD (Single Program Multiple Data) programming model. Each processor executes the same program, but operates on different data. This is implemented by loading the same program image into each processor. Each processor then allocates and operates on its own local portion of distributed arrays, according to the distributions, array sizes and number of processors as determined at runtime by HPF directives or using command line arguments. Special attention is required to address the unique communication characteristics of many parallel systems. The PGHPF runtime libraries take into account the communications to be performed and are optimized at two levels, the transport independent level, where efficient communications are generated based on the type and pattern of data access performed in the computation, and at the transport dependent level where the runtime library's communication is performed using a standard communications protocol or a custom data transfer mechanism.

1.2 Invoking PGHPF

To translate and link an HPF program, PGHPF does the following:

• Preprocesses the HPF source text file.
• Checks the syntax of the HPF source text.
• Generates a Fortran program including calls to the PGHPF runtime library.
• Generates an assembly language file from the Fortran file.
• Passes control to the subsequent assembly and link steps.

The driver sets the HPF compiler and Fortran compiler switches and assembles and links the program. It lets you pass command-line options to any of the various driver stages. Chapter 2, PGHPF Compiler Options, covers the compiler's command-line options. The executable output from PGHPF is an SPMD program that can execute on a target parallel system. Chapter 3, PGHPF Runtime Options, describes some of the command-line options and environment variables available for the PGHPF runtime, the PGHPF executable and the PGHPF environment.

For more information on the Fortran compiler, the assembler and linker, refer to the documentation listed in the Preface or to the appropriate manuals supplied with your system.

The following examples show several driver options that should be available on most systems. The command-lines and output may differ on your system. You can compile the HPF program hello.hpf using the default PGHPF driver options.

$ pghpf hello.hpf 

By default, the executable output is placed in the file a.out. You can use the -o option to specify the output file.

$ pghpf -o hello hello.hpf

To see the command lines that PGHPF will run, without actually executing them, use the driver's -dryrun option. For example:

$ pghpf -dryrun -o hello hello.hpf

1.2.1 PGHPF Command-line Syntax

The PGHPF command-line syntax is:

pghpf  [options] filename [...]

Where:

options

is one or more command-line options. Case is significant for options and their arguments. For a complete description of the options, refer to Chapter 2, PGHPF Compiler Options.

The driver recognizes characters preceded by a hyphen (-) as a command-line option. For example, the -Mextend option specifies that the compiler accepts extended 132 column lines.

The order of options and the filename is not fixed. That is, you can place options both before and after the filename argument on the driver command line. However, the placement of some options is significant, for example the -l option.

If two or more options contradict each other, the last one in the command line takes precedence.

filename

is the name of a source file, assembly-language file, object file, or library to be processed by the compilation system. You can specify more than one filename.

1.2.2 Compiler Command-line Options

The compiler command-line options control various aspects of the compilation process. For a listing and a description of the PGHPF specific compiler command-line options, refer to Chapter 2, PGHPF Compiler Options. There are many additional options that apply to the node compiler for your system (PGI's pgf77 Fortran is one possible node compiler), refer to the PGI Workstation User's Guide for details on the pgf77 compiler command-line options and to the user manual for your node compiler for other systems (you can also use the PGHPF driver option -help to list the available options).

Several options provide for optimization of the HPF program. These compiler command line options, -O1, and -O2, provide varying levels of optimization to the HPF code, and also set optimization flags for the Fortran node compiler. For details on the optimization transformations applied, refer to the Release Notes supplied with the PGHPF Software or to sections in this manual describing optimizations.

1.3 Filename Conventions

The PGHPF driver uses the filenames that you specify on the command line to find and to create input and output files. This section describes the input and output filename conventions for the phases of the compilation process.

1.3.1 Input Files

You can specify HPF source files, preprocessed HPF source files, assembly-language files, object files and libraries as inputs on the PGHPF command line. The driver determines the type of each input file by examining the filename extension. The driver uses the following conventions:

filename.a

indicates a library of object files.filename.f

indicates an HPF source file. filename.F

indicates an HPF source file with preprocessing.filename.for

indicates an HPF source file.

filename.f90

indicates an HPF source file using freeform formatting (use either the option -Mnofree or -Mnofreeform if the file uses fixed form).

filename.hpf

indicates an HPF source file.

filename.o

indicates an object file.filename.s

indicates an assembly-language file.

The driver passes files with .o and .a extensions to the linker and .s files to the assembler. Input files with unrecognized extensions, or no extensions, are also passed to the linker.

Any input files not needed for a particular phase of processing are not processed. For example, if on the command line you use an assembly-language file (filename.s) and the -S option to stop before the assembly phase, the compiler takes no action on the assembly-language file. Processing stops after compilation and the assembler does not run (in this case compilation must have been completed in a previous pass which created the .s file). Refer to the following section, "Output Files," for a description of the -S option.In addition to specifying primary input files, files with extensions indicating an HPF source file on the command line, you can insert text from include files using the INCLUDE statement or the preprocessor #include directive from within HPF source files (includes and preprocessing is only available if you use a .F extension or the -Mpreprocess command line argument).When linking a program object file with a library, the linker extracts only those objects from the library that the program needs. The PGHPF driver includes several libraries by default. For more information about libraries, refer to Chapter 4, PGHPF Libraries.

1.3.2 Output Files

By default, the PGHPF executable output is placed in the file a.out. In addition, on the command line you can use the -o option to specify the output file.

If you use one of the options: -Mftn, -F, -S or -c, the compiler produces a file containing the output of the last phase that completes for each input file, as specified by the option supplied[*]. The output file will be a Fortran file with PGHPF runtime library calls, an HPF preprocessed source file, an assembly-language file or an unlinked object file respectively. Similarly, the -E option does not produce a file, but displays the preprocessed HPF source file on the standard output. Using any of these options, the -o option is valid only if you specify a single input file. If no errors occur during processing, you can use the files created by these options as input to a future invocation of PGHPF. Table 1-1 lists the stop after options and the output files that PGHPF creates when you use these options.

If you specify multiple input files or do not specify an object filename, the compiler uses the input filenames to derive corresponding default output filenames of the following form, where filename is the input filename without its extension:

filename.o

indicates an object file from the -c option.filename.s

indicates an assembly-language file from the -S option.

filename.f

indicates a Fortran file with PGHPF runtime library calls.

Table 1-1 Stop after Options and Outputs

When running PGHPF you can continue the compilation and save the intermediate Fortran file generated from the first stage of PGHPF using the -Mkeepftn option. This option continues the compilation after HPF compiling, but does not remove the intermediate Fortran file. Use of the -Mnohpfc option will skip the HPF compilation step and compile using the Fortran node compiler if a file with a .f or a .F extension is supplied.

The -Mipa interprocedural analysis processing, module processing, and the static initialization and prelinking phases of the compiler generate additional intermediate files. For further information, refer to Section 5 of this manual or to the PGHPF release notes.

<< " border=0>

> " border=0>