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 System

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	`#`

Application	Title	Part Number
Sun HPC ClusterTools Documentation	Read Me First: Guide to Sun HPC ClusterTools 6 Software Documentation	819-4136-10
Sun HPC ClusterTools Software	Sun HPC ClusterTools 6 Software Release Notes Sun HPC ClusterTools 6 Software Installation Guide Sun HPC ClusterTools 6 Software Performance Guide Sun HPC ClusterTools 6 Software User's Guide Sun HPC ClusterTools 6 Software Administrator's Guide	819-4129-10 819-4130-10 819-4134-10 819-4131-10 819-4132-10

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.

Table listing other documents that are related to this book or product.

Documentation, Support, and Training

Sun Function	URL
Documentation	`http://www.sun.com/documentation/`
Support	`http://www.sun.com/support/`
Training	`http://www.sun.com/training/`

Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can submit your comments by going to:

http://www.sun.com/hwdocs/feedback

Please include the title and part number of your document with your feedback:

Sun MPI 7.0 Software Programming and Reference Manual, part number 819-4133-10

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