This manual describes the capabllities of Sun Performance WorkShop Fortran and guides you to the documentation you need for further information. Some of these products you already use, but others you may not use or even know about.
This document addresses application developers who are new users of Sun Performance WorkShop Fortran. It assumes that you have a working knowledge of the Solaris(TM) operating environment and UNIX\256 commands.
This overview is organized as follows:
Chapter 1, "Welcome to Sun Performance WorkShop Fortran," is an overview of the products included in Sun Performance WorkShop Fortran and how they fit together.
Chapter 2, "Building and Compiling," discusses building and compiling processes.
Chapter 3, "Editing and Browsing," describes editors and benefits of the source browser.
Chapter 4, "Debugging and Tuning," reviews debugging and performance tools.
Chapter 5, "Managing Source Code," sketches the benefits of Sun(TM) WorkShop(TM) TeamWare code management tools.
Glossary is a list of words and phrases found in this book and their definitions.
The name of the latest Solaris operating environment release is Solaris 7 but code and path or package path names may use Solaris 2.7 or SunOS 5.7.
The Sun(TM) WorkShop(TM) documentation applies to Solaris 2.5.1, Solaris 2.6, and Solaris 7 operating environments on:
The SPARC(TM) platform
The x86 platform, where x86 refers to the Intel implementation of one of the following: Intel 80386, Intel 80486, Pentium, or the equivalent
The term "x86" refers to the Intel 8086 family of microprocessor chips, including the Pentium, Pentium Pro, and Pentium II processors and compatible microprocessor chips made by AMD and Cyrix. In this document, the term "x86" refers to the overall platform architecture. Features described in this book that are particular to a specific platform are differentiated by the terms "SPARC" and "x86" in the text.
This overview briefly describes the components of the Sun Performance WorkShop Fortran. The Fortran programming books present information specific to the FORTRAN 77 and Fortran 90 compilers and language. Other Sun WorkShop books give instructions for installation and detailed information about the remaining Sun Performance WorkShop elements. The Solaris books provide information on linking, libraries, and SunOS programming tools.
Fortran User's Guide provides information on command-line options and how to use the compilers.
Fortran Programming Guide discusses issues relating to input/output, libraries, program analysis, debugging, and performance.
Fortran Library Reference gives detail on the language and routines.
FORTRAN 77 Language Reference Manual provides a complete language reference.
Numerical Computation Guide details floating-point computation numerical accuracy issues.
Sun WorkShop Quick Install provides installation instructions.
Sun WorkShop Installation and Licensing Reference provides supporting installation and licensing information.
Using Sun WorkShop gives information on performing development operations through Sun WorkShop.
Debugging a Program With dbx provides information on using the debugger and dbx commands.
Analyzing Program Performance With Sun WorkShop describes the profiling tools; the LoopTool, LoopReport, and LockLint utilities; and use of the Sampling Analyzer to enhance program performance.
Sun WorkShop TeamWare User's Guide describes how to use the Sun WorkShop TeamWare code management tools.
Sun WorkShop Performance Library Reference Manual discusses the library of subroutines and functions to perform useful operations in computational linear algebra and Fourier transforms.
The following Solaris manuals and guides provide additional useful information:
The Solaris Linker and Libraries Guide gives information on linking and libraries.
The Solaris Programming Utilities Guide provides information for developers about the special built-in programming tools available in the SunOS(TM) system.
The SunDocsSM program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.
For a list of documents and how to order them, see the catalog section of the SunExpress(TM) Internet site at http://www.sun.com/sunexpress.
Sun WorkShop documentation is available online from several sources:
The docs.sun.com Web site
AnswerBook2TM collections
HTML documents
Online help and release notes
The docs.sun.com Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.
The Sun WorkShop documentation is also available using AnswerBook2 software. To access the AnswerBook2 collections, your system administrator must have installed the AnswerBook2 documents during the installation process (if the documents are not installed, see your system administrator or Chapter 3 of Sun WorkShop Quick Install for installation instructions). For information about accessing AnswerBook2 documents, see Chapter 6 of Sun WorkShop Quick Install, Solaris installation documentation, or your system administrator.
To access AnswerBook2 documents, Solaris 2.5.1 users must first download AnswerBook2 documentation server software from a Sun Web page. For more information, see Chapter 6 of Sun WorkShop Quick Install.
The following Sun Workshop documents are available online only in HTML format:
Tools.h++ Class Library Reference
Tools.h++ User's Guide
Numerical Computation Guide
Standard C++ Library User's Guide
Standard C++ Class Library Reference
Sun WorkShop Performance Library Reference Manual
Sun WorkShop Visual User's Guide
Sun WorkShop Memory Monitor User's Manual
To access these HTML documents:
Open the following file through your HTML browser:
install-directory/SUNWspro/DOC5.0/lib/locale/C/html/index.html
Replace install-directory with the name of the directory where your Sun WorkShop software is installed (the default is /opt).
The browser displays an index of the HTML documents for the Sun WorkShop products that are installed.
Open a document in the index by clicking the document's title.
This release of Sun WorkShop includes an online help system as well as online manuals. To find out more see:
Online Help. A help system containing extensive task-oriented, context-sensitive help. To access the help, choose Help Help Contents. Help menus are available in all Sun WorkShop windows.
Release Notes. The Release Notes contain general information about Sun WorkShop and specific information about software limitations and bugs. To access the Release Notes, choose Help Release Notes.
The following table describes the typographic changes used in this book.
Table P-1 Typographic Conventions
Typeface or Symbol |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories; on-screen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% You have mail.
|
AaBbCc123 |
What you type, contrasted with on-screen computer output |
machine_name% su Password: |
AaBbCc123 |
Command-line placeholder: replace with a real name or value |
To delete a file, type rm filename. |
AaBbCc123 |
Book titles, new words or terms, or words to be emphasized |
Read Chapter 6 in User's Guide. These are called class options. You must be root to do this. |
The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P-2 Shell Prompts
Shell |
Prompt |
---|---|
C shell prompt |
machine_name% |
C shell superuser prompt |
machine_name# |
Bourne shell and Korn shell prompt |
$ |
Bourne shell and Korn shell superuser prompt |
# |