Preface

The Sun MPI Software Programming and Reference Manual describes the Sun trademark MPI library of message-passing routines and explains how to develop an MPI program on a Sun HPC system.

For the most part, this guide does not repeat information that is available in detail in the MPI Standard; it focuses instead on what is specific to the Sun MPI implementation.

You should be familiar with programming in C or Fortran, with parallel programming, and with the message-passing model.

Before You Read This Book

For general information about writing MPI programs, see Related Documentation. Sun MPI is part of the Sun HPC ClusterTools trademark suite of software. For more information about running Sun MPI jobs, see the Sun HPC ClusterTools Software User's Guide. Product notes for Sun MPI are included in Sun HPC ClusterTools Software Release Notes.

Using UNIX Commands

This document does not describe how to use basic UNIX® commands. For that type of information, see:

Solaris Handbook for Sun Peripherals

Online documentation for the Solaris operating environment

Other software documentation that you received with your system

Typographic Conventions

Typeface`^[1]`	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your`.login` file. Use `ls` `-a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.	Read Chapter 6 in the User's Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` filename.

Typeface^[1]

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123

What you type, when contrasted with on-screen computer output

% su

Password:

AaBbCc123

Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.

Read Chapter 6 in the User's Guide.

These are called class options.

You must be superuser to do this.

To delete a file, type rm filename.

Shell Prompts

Shell	Prompt
C shell	machine-name`%`
C shell superuser	machine-name`#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Related Documentation

Application	Title	Part Number
Sun HPC ClusterTools Documentation	Read Me First: Guide to Sun HPC ClusterTools 5 Software Documentation	817-0096-10
Sun HPC ClusterTools Software	Sun HPC ClusterTools 5 Software Release Notes Sun HPC ClusterTools 5 Software Installation Guide Sun HPC ClusterTools 5 Software Performance Guide Sun HPC ClusterTools 5 Software User's Guide Sun HPC ClusterTools 5 Software Administrator's Guide	817-0081-10 817-0082-10 817-0090-10 817-0084-10 817-0083-10
Sun S3L	Sun S3L 4.0 Software Programming Guide Sun S3L 4.0 Software Reference Manual	817-0086-10 817-0087-10
Prism graphical programming environment	Prism 7.0 Software User's Guide Prism 7.0 Software Reference Manual	817-0088-10 817-0089-10

A wealth of documentation on MPI is available on the World Wide Web. It includes the following:

The MPI home page, with links to specifications for the MPI-2 Standard:

http://www.mpi-forum.org

Additional Web sites that provide links to papers, talks, the MPI Standard, implementations, information about MPI-2, tutorials, and pointers to many other sources:

http://www.erc.msstate.edu/mpi/

http://www.arc.unm.edu/

Man Pages

Man pages are also available online for all the Sun MPI and MPI I/O routines and are accessible by means of the Solaris man command. These man pages are usually installed in /opt/SUNWhpc/man. Ask your system administrator for their location at your site.

Accessing Sun Documentation

You can view, print, or purchase a broad selection of Sun documentation, including localized versions, at:

http://www.sun.com/documentation

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can email your comments to Sun at:

docfeedback@sun.com

Please include the part number (817-0085-10) of your document in the subject line of your email.

^{1 (TableFootnote) The settings on your browser might differ from these settings.}