Intel® Fortran Compiler for Linux* Systems User's Guide Volume I: Building Applications Document Number: 253259-002 Disclaimer and Legal Information Information in this document is provided in connection with Intel® products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, or life sustaining applications. This Intel® Fortran Compiler for Linux* Systems User's Guide Volume I: Building Applications as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The Intel Fortran Compiler product may contain software defects which may cause the product to deviate from published specifications. Current characterized software defects are available on request. Intel SpeedStep, Intel Thread Checker, Celeron, Dialogic, i386, i486, iCOMP, Intel, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetStructure, Intel Xeon, Intel XScale, Itanium, MMX, MMX logo, Pentium, Pentium II Xeon, Pentium III Xeon, Pentium M, and VTune are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. * Other names and brands may be claimed as the property of others. Copyright © Intel Corporation 2003 - 2004. Portions © Copyright 2001 Hewlett-Packard Development Company, L.P. Table Of Contents About the Intel® Fortran Compiler....................................................................13 What's New in This Release ............................................................................15 Improvements and New Features in Version 8.1...........................................15 Improvements and New Features in Version 8.0...........................................15 How to Use This Document .............................................................................17 Additional Documentation ............................................................................17 Notation Conventions...................................................................................17 Getting Started................................................................................................19 Getting Started Overview .............................................................................19 How You Can Use the Intel® Fortran Compiler.............................................19 Compilation Phases.....................................................................................20 Preprocess Phase .......................................................................................21 Assemblers and Linker.................................................................................22 Assemblers ..............................................................................................22 Linker.......................................................................................................23 Default Behavior of the Intel Fortran Compiler ..............................................23 Input Files and Filename Extensions ............................................................23 File Specifications........................................................................................24 Output Files.................................................................................................25 Temporary Files Created by the Compiler or Linker ......................................26 Building Applications .......................................................................................27 iii Table Of Contents Building Applications Overview.....................................................................27 Controlling the Compilation Process.............................................................27 Setting and Viewing Environment Variables..................................................28 Configuration File Environment Variables..................................................28 Running the Shell Script to Set Up the Environment Variables ......................28 Invoking the Intel® Fortran Compiler ............................................................29 Using the ifort Command ..........................................................................29 Using the make Command .......................................................................30 Examples of the ifort Command ...................................................................30 Compiling and Linking Multiple Files .........................................................30 Preventing Linking....................................................................................30 Renaming the Output File.........................................................................31 Specifying an Additional Linker Library......................................................31 Using Module (.mod) Files ...........................................................................31 Compiling Programs with Modules............................................................32 Parallel Invocation with a makefile ............................................................33 Searching for Include and .mod Files............................................................34 Specifying and Removing an Include File Path..........................................35 Configuration Files and Response Files........................................................35 Configuration Files ...................................................................................35 Response Files ........................................................................................36 Specifying Alternative Tool Locations and Options........................................37 Using -Qlocation to Specify an Alternative Location for a Tool ...................37 iv Table Of Contents Using -Qoption to Pass Options to Tools...................................................38 Predefined Preprocessor Symbols ...............................................................38 Defining Preprocessor Symbols................................................................40 Suppressing Preprocessor Symbols .........................................................40 Redirecting Command-Line Output to Files ..................................................40 Creating, Running, and Debugging an Executable Program..........................41 Commands to Create a Sample Program..................................................42 Running the Sample Program...................................................................43 Debugging the Sample Program...............................................................43 Creating Shared Libraries ............................................................................43 Creating a Shared Library with a Single ifort Command.............................44 Creating a Shared Library with ifort and ld Commands ..............................44 Shared Library Restrictions.......................................................................45 Installing Shared Libraries ........................................................................45 Allocating Common Blocks...........................................................................46 Guidelines for Using the -dyncom Option ..................................................46 Why Use a Dynamic Common Block?.......................................................46 Allocating Memory to Dynamic Common Blocks........................................47 Compiler Options ............................................................................................49 Compiler Options Overview..........................................................................49 Compiler Options Details..............................................................................49 Styles of Compiler Options .......................................................................49 Using Multiple ifort Commands .................................................................50 v Table Of Contents Using the OPTIONS Statement to Override Options..................................50 Getting Help on Options ...........................................................................50 Compiler Directives Related to Options ........................................................51 Code Generation Options.............................................................................51