Preface

This manual describes the Sun trademark Scalable Scientific Subroutine Library (Sun S3L). It is directed to anyone developing message-passing C, C++, F77, or F90 programs.

Acknowledgments

The Sun S3L dense linear algebra routines make use of the ScaLAPACK library described in "ScaLAPACK: Linear Algebra Software for Distributed Memory Architectures," J. Demmel, J. Dongarra, R. van de Geijn, and D. Walker in Parallel Computers: Theory and Practice, Ed. by T. Casavant, P. Tvrdik, and F. Plasil. (IEEE Press, 1995, pp. 267-282.)

ScaLAPACK routines access the Sun MPI library through calls to the BLACS library described in "Two-dimensional Basic Linear Algebra Communications Subprograms," J. Dongarra and R. van de Geijn, in Environments and Tools for Parallel Scientific Computing, Ed. by J. Dongarra and B. Tourancheau (Elsevier Science Publisher B.V., 1993, pp. 31-40), in "Basic Linear Algebra Communication Subprograms: Analysis and Implementation Across Multiple Parallel Architectures," R.C. Whaley.

How This Book Is Organized

Chapter 1 contains a list of the routines in Sun S3L, organized into general classes, such as Dense Matrix Operations, Sparse Matrix Operations, and so forth.

Chapter 2 contains individual descriptions of the Sun S3L routines, presented in alphabetical order.

Appendix A describes the error codes that are returned when an array handle error is encountered.

Using UNIX Commands

This document may not contain information on basic UNIX^® commands and procedures.

See one or both of the following for such information:

AnswerBook online documentation for the Solaris software 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 software documentation	Read Me First: Guide to Sun HPC ClusterTools 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 Administrator's Guide Sun HPC ClusterTools 5 Software User's Guide	817-0081-10 817-0082-10 817-0090-10 817-0083-10 817-0084-10
Sun MPI software programming	Sun MPI 6.0 Software Programming and Reference Guide	817-0085-10
Sun S3L software	Sun S3L 4.0 Software Programming Guide	817-0086-10
Prism graphical programming environment	Prism 7.0 Software User's Guide Prism 7.0 Software Reference Manual	817-0088-10 817-0089-10

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-0087-10) of your document in the subject line of your email.

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