pathscale_intro

NAME

pathscale_intro - Introductory page for the PathScale Compiler Suite

DESCRIPTION

This man page describes the resources available for use with the PathScale C, C++, and Fortran compilers.

MAN PAGES

The following man pages are available for use with the PathScale Compiler Suite. They are intended for use as complete references; for guides describing how to use the compilers or tools, see the following section.

Compiler man pages:

pathcc(1)

The flags available for use with the PathScale C compiler, which is named pathcc.

pathCC(1)

The flags available for use with the PathScale C++ compiler, which is named pathCC.

pathf95(1)

The flags available for use with the PathScale Fortran compiler, which is named pathf95. This compiler is also available under the name pathf90, for backwards compatibility.

Utility man pages:

assign(1)

Utility to change or display the I/O processing directives for a Fortran unit or file.

explain(1)

Utility that displays detailed explanations of error messages from the PathScale Fortran compiler and runtime library.

fsymlist(1)

Utility to print out the list of Fortran symbols found in the libraries passed to the compiler on the command line; one symbol per line.

pathcov(1)

Code coverage testing tool. This is the version of GNU gcov(1) that is supported for use with the PathScale compilers. Other versions of gcov, including those installed by default with your Linux distribution, may not work correctly when run on code generated by the PathScale compilers.

pathdb(1)

The PathScale debugger. This debugger supports a subset of GDB commands, provides superior Fortran debugging support, C and C++ support, multiple process support, and support for debugging the Standard Template Libraries.

pathprof(1)

Call graph profiling display tool. This is the version of GNU gprof(1) that is supported for use with the PathScale compilers. Other versions of gprof, including those installed by default with your Linux distribution, may not work correctly when run on code generated by the PathScale compilers.

pathopt2(1)

Optimal flags and options for specific codes. The pathopt2 tool will run the supplied command using a set of options in a supplied configuration file to find the best set of flags and options for a particular code.

Flags and options for all PathScale compilers:

compiler.defaults(5)

Default options to be used by all compilers.

eko(7)

All supported flags, including feedback, code generation, and optimization.

ONLINE DOCUMENTS

The following online documents provide guides for installing, using, and receiving support for the PathScale compilers. They are provided in Adobe Acrobat format; you can read them with a tool such as evince(1), xpdf(1), acroread or gv(1).

The PathScale Compiler Suite and Subscription Manager Install Guide

How to install and configure the PathScale Compiler Suite. This file is named Install.pdf.

The PathScale Compiler Suite User Guide

How to use the compilers, tune your code, and troubleshoot problems. This file is named UserGuide.pdf.

The PathScale Compiler Suite Support Guide

How to get support from PathScale, Inc.; how to file a bug. This file is named Support.pdf.

The PathScale Debugger User Guide

How to install and use the PathScale debugger pathdb. Contains command list and sample debugging session. This file is named PathDB_UserGuide.pdf.

After installation, you can find these documents in <install_dir>/share/doc/pathscale-compilers-<version>.

SUPPORT

Visit http://www.pathscale.com/support.html for more information about releases and additional support from PathScale.

TOOLS AND UTILITIES

You can use pathprof to profile programs built with the PathScale Compiler Suite, and pathcov to test code coverage. See the PathScale Compiler Suite User Guide for more details.

DIRECTORY STRUCTURE

After you have installed your PathScale Compiler Suite, your directory structure will look like this:

<install_dir>/bin

Compiler binaries.

<install_dir>/etc

Configuration files for the compilers and related tools.

<install_dir>/lib/<version>

Compiler phases and 64-bit static and runtime libraries.

<install_dir>/lib/<version>/32

32-bit static and runtime libraries.

<install_dir>/compat-gcc/bin

GCC compatibility wrapper scripts.

<install_dir>/man

Man pages.

<install_dir>/share/doc/pathscale-compilers-<version>

Documentation and SPEC CPU2000 benchmark configuration files.

The default installation directory is /opt/pathscale.