About This Guide

This guide describes the components of MIPSPro compiler system, other programming tools and interfaces, and dynamic shared objects. It also explains ways to improve program performance.

The compiler system produces either new 32-bit (n32) object code, 64-bit object code, or old 32-bit (o32) object code. This guide describes the MIPSPro compilers that produce new 32-bit and 64-bit object code. For additional information about n32 and 64-bit compilation, see the MIPSPro N32 ABI Handbook and the MIPSPro Porting and Transition Guide, respectively. For information about compilers that produce old 32-bit objects, refer to the MIPS Compiling and Performance Tuning Guide.

What You Should Know Before Reading This Guide

This guide is for anyone who wants to program effectively using the MIPSPro compilers. It is written for a reader who is familiar with the IRIX (or UNIX) operating system and a programming language such as C or Fortran. This guide does not explain how to write and compile programs.

This guide does not cover all of the differences between n32, 64, and o32 compilation modes. Refer to MIPSPro Application Porting and Transition Guide and MIPSPro N32 ABI Handbook for information about the differences between these modes, language implementation differences, source code porting, compilation issues, and run-time execution.

Be sure to read the Release Notes for your compiler. They contain important information about this release of the MIPSPro compiler system.

Related Publications

The following documents contain additional information that may be helpful:

Table 1. Topics and Manuals

Topic

Document

Compiler information

Release Notes for your compiler

IRIX programming

Topics in IRIX Programming

Automatic parallelization

The apo(1) man page and documents referenced by it.

Debugging a program

dbx User's Guide or Developer Magic: Debugger User's Guide

MIPSPro ABI

See http://www.mipsabi.org/, the MIPSPro N32 ABI Handbook, the MIPSPro 64-Bit Porting and Transition Guide, and the mips_ext(5) man page.

Multiprocessing

Appropriate language manual, for example, MIPSPro Fortran 77 Programmer's Guide or C Language Reference Manual

prof, pixie, and ssrun

SpeedShop User's Guide

Performance analysis using a GUI

Developer Magic: Performance Analyzer User's Guide

Porting code

MIPSPro Porting and Transition Guide

Assembly language

MIPSPro Language Programmer's Guide

C language

C Language Reference Manual

C++ language

C++ Programming Guide

Fortran language

MIPSPro Fortran 77 Programmer's Guide and MIPSPro 7 Fortran 90 Commands and Directives Reference

Parallel programming

Appropriate language manual

Real-time programming

REACT Real-Time Programmer's Guide

Silicon Graphics also provides manuals online, on the Web or in IRIS InSight. To read an online manual after installing it, type insight or double-click the InSight icon. It is easy to print sections and chapters of the online manuals from InSight. You can also order printed manuals from Silicon Graphics by calling SGI Direct at 1-800-800-7441. Outside the U.S. and Canada, contact your local sales office or distributor.

To read an online manual on the Web, use this URL:

http://techpubs.sgi.com/library/lib/display.cgi?4097

Silicon Graphics offers software options to assist in your software development. The compiler options include languages such as Fortran 90, Fortran77, C, C++, and the automatic parallelizer (APO). CASEVision/Workshop provides the WorkShop toolset: the Debugger, Static Analyzer, and Performance Analyzer.

As a developer, you are eligible to become a member of the Silicon Graphics Developer Program at SGI. Call 1-800 -770-3033 for details. If you are developing a MIPSPro ABI-compliant application, you may want to consult the MIPSPro ABI Frequently Asked Questions.

You may also want to learn more about standard UNIX and ANSI C topics. For this information, consult a computer bookstore or manuals such as:

  • AT&T. UNIX System V Release 4 Programmer's Guide: ANSI C and Programming Support Tools. Englewood Cliffs, NJ: Prentice Hall, 1990.

  • Levine, Mason, and Brown. lex & yacc. Sebastopol. CA: O'Reilly & Associates, Inc., 1992.

  • Oram and Talbott. Managing Projects with make. Sebastopol. CA: O'Reilly & Associates, Inc., 1991.

  • American National Standards Institute, Inc. American National Standard, Programming Language--C, ANSI C Standard. ANSI X3.159-1989.

  • International Standard ISO/IEC. Programming languages--C, 9899. 1990(E).

Conventions

The following conventions are used throughout this document:

Convention 

Meaning

command 

This fixed-space font denotes literal items such as commands, files, routines, path names, signals, messages, and programming language structures.

variable 

Italic typeface denotes variable entries and words or concepts being defined.

user input 

This bold, fixed-space font denotes literal items that the user enters in interactive sessions. Output is shown in nonbold, fixed-space font.

[ ] 

Brackets enclose optional portions of a command or directive line.

... 

Ellipses indicate that a preceding element can be repeated.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this document, please tell us. Be sure to include the title and part number of the document with your comments.

You can contact us in any of the following ways:

  • Send electronic mail to the following address:

    techpubs@sgi.com

  • Send a facsimile to the attention of "Technical Publications" at fax number +1 650 932 0801.

  • Use the Suggestion Box form on the Technical Publications Library World Wide Web page:

    http://techpubs.sgi.com/library/

  • Call the Technical Publications Group, through the Technical Assistance Center, using one of the following numbers:

    For Silicon Graphics IRIX based operating systems: 1 800 800 4SGI

    For UNICOS or UNICOS/mk based operating systems or CRAY Origin2000 systems: 1 800 950 2729 (toll free from the United States and Canada) or +1 651 683 5600

  • Send mail to the following address:

    Technical Publications
    Silicon Graphics, Inc.
    1600 Amphitheatre Pkwy.
    Mountain View, California 94043-1351

We value your comments and will respond to them promptly.