Compaq Fortran
User Manual for
Tru64 UNIX and Linux Alpha Systems

Contents

Preface
Preface	Preface
Chapter 1
1	Getting Started
1.1	The Compaq Fortran Programming Environment
1.2	Commands to Create and Run an Executable Program
1.3	Creating and Running a Program Using a Module and Separate Function
1.3.1	Commands to Create the Executable Program
1.3.2	Running the Sample Program
1.3.3	Debugging the Sample Program
1.4	The f90 or fort Command and Related Software Components
1.4.1	The f90 or fort Command Driver Program
1.4.2	cpp and Other Preprocessors
1.4.3	Compaq Fortran Compiler
1.4.4	Other Compilers
1.4.5	Linker (ld)
1.5	Program Development Stages and Tools
Chapter 2
2	Compiling and Linking Compaq Fortran Programs
2.1	The f90 Command: Files and Options
2.1.1	File Suffixes and Source Forms
2.1.2	Format of the f90 and fort Commands
2.1.3	Specifying Files and Options
2.1.4	Creating and Using Module Files
2.1.4.1	Creating Module Files
2.1.4.2	Using Module Files
2.1.5	The INCLUDE Statement and Using Include Files
2.1.6	Output Files: Executable, Object, and Temporary
2.1.6.1	Naming Output Files
2.1.6.2	Temporary Files
2.1.7	Using Multiple Input Files: Effect on Output Files
2.1.8	Examples of the f90 and fort Commands
2.1.8.1	Compiling and Linking Multiple Files
2.1.8.2	Retaining an Object File and Preventing Linking
2.1.8.3	Compiling Fortran 95/90 and C Source Files and Linking an Object File
2.1.8.4	Renaming the Output File
2.1.8.5	Specifying an Additional Linker Library
2.1.8.6	Requesting Additional Optimizations
2.1.9	Using Listing Files
2.2	Passing Options to cc or ccc and ld
2.2.1	f90 Driver Program Interaction with cc and ccc, and ld
2.2.2	make Facility
2.2.3	Options Passed to the cc and ccc Driver or ld Linker
2.3	Compiler Limits, Compiler Messages, and Linker Messages
2.3.1	Compiler Limits
2.3.2	Compiler Diagnostic Messages and Error Conditions
2.3.3	Linker Diagnostic Messages and Error Conditions
2.4	Compilation Control: Statements and Directives
2.5	Specifying Object Libraries for Linking
2.5.1	Specifying Additional Object Libraries
2.5.2	Specifying Types of Object Libraries
2.5.3	Specifying Shared Object Libraries
2.6	Creating Shared Libraries
2.6.1	Creating a Shared Library with a Single f90 Command
2.6.2	Creating a Shared Library with f90 and ld Commands
2.6.3	Choosing How to Create a Shared Library
2.6.4	Shared Library Restrictions
2.6.5	Installing Shared Libraries (TU*X ONLY)
Chapter 3
3	f90 or fort Command Options
3.1	f90 and fort Command Options and Categories
3.2	-align keyword --- Data Alignment
3.3	-altparam --- Alternative PARAMETER Syntax
3.4	-arch keyword --- Specify Type of Code Instructions Generated
3.5	-assume buffered_io --- Buffered Output
3.6	-assume byterecl --- Units for Unformatted File Record Length
3.7	-assume dummy_aliases --- Dummy Variable Aliasing
3.8	-assume gfullpath --- Source File Path for Debugging
3.9	-assume minus0 --- Standard Semantics for Minus Zero
3.10	-assume pthreads_lock --- Thread Lock Selection for Parallel Execution
3.11	-assume source_include --- INCLUDE file search
3.12	-assume noaccuracy_sensitive, -fp_reorder --- Reorder Floating-Point Calculations
3.13	-assume nounderscore --- Underscore on External Names
3.14	-automatic, -static --- Type of Data Storage
3.15	-c --- Inhibit Linking and Retain Object File
3.16	-call_shared, -non_shared, -shared --- Shared Library Use
3.17	-ccdefault keyword --- Specifies Carriage Control for Terminals
3.18	-check bounds, -C, -check_bounds --- Boundary Run-Time Checking
3.19	-check noformat --- Ignore Certain Format Mismatches at Run Time
3.20	-check nooutput_conversion --- Ignore Truncated Format Mismatches at Run Time
3.21	-check nopower --- Allow Special Floating-Point Expressions
3.22	-check omp_bindings --- OpenMPtm Fortran API Binding Rules Checking
3.23	-check overflow --- Integer Overflow Run-Time Checking
3.24	-check underflow --- Floating-Point Underflow Run-Time Checking
3.25	-convert keyword --- Unformatted Numeric Data Conversion
3.26	-cpp and Related Options --- Run C Preprocessor
3.26.1	-Dname and -Dname=def --- Define cpp Names
3.26.2	-I --- Remove Directory from cpp Include Search Path
3.26.3	-Idir --- Add Directory to cpp Include Search Path
3.26.4	-K --- Keep Temporary Files
3.26.5	-M --- Request cpp Dependency Lists for make
3.26.6	-P --- Retain cpp Intermediate Files
3.26.7	-Uname --- Undefine cpp Name
3.26.8	-Wp,-xxx --- Pass Specified Option to cpp
3.27	-Dname and -Dname=def and -Dname="string" --- Define Symbol Names
3.28	-d_lines --- Debugging Statement Indicator, Column 1
3.29	-double_size 128, -double_size 64 --- Double Precision Data Size
3.30	-error_limit num, -noerror_limit --- Limit Error Messages
3.31	-extend_source --- Line Length for Fixed-Format Source
3.32	-f66, -66, -nof77, -onetrip, -1 --- FORTRAN IV Compatibility
3.32.1	-f77rtl --- Use Fortran 77 Run-time Behavior
3.33	-fast --- Set Options to Improve Run-Time Performance
3.34	-feedback file, -gen_feedback, -cord --- Create and Use Feedback Files
3.35	-fixed, -free --- Fortran 95/90 Source Form
3.36	-fpconstant --- Handling of Floating-Point Constants
3.37	-fpen --- Control Arithmetic Exception Handling and Reporting
3.38	-fpp --- Run Fortran Preprocessor
3.39	-fprm keyword --- Control Floating-Point Rounding Mode
3.40	-fuse_xref --- Cross-Reference Information for DEC FUSE
3.41	-g0, -g1, -g2 or -g, -g3, -ladebug --- Symbol Table Information
3.42	-granularity keyword --- Control Shared Memory Access to Data
3.43	-hpf_matmul --- Use Prior Version of MATMUL Intrinsic
3.44	-I --- Remove Directory from Include Search Path
3.45	-Idir --- Add Directory for Module and Include File Search
3.46	-i2, -i4, -i8, -integer_size num --- Integer and Logical Data Size
3.47	-inline keyword, -noinline --- Control Procedure Inlining
3.48	-intconstant --- Handling of Integer Constants
3.49	-K --- Keep Temporary Files
3.50	-L --- Remove ld Directory Search Path
3.51	-Ldir --- Add Directory to ld Search Path
3.52	-lstring --- Add Library Name to ld Search
3.53	-math_library accurate or -math_library fast --- Fast or Accurate Math Library Routines
3.54	-mixed_str_len_arg --- Specify Length of Character Arguments
3.55	-module directory --- Specify Directory for Creating Modules Files
3.56	-mp --- Enable Parallel Processing Using Directed Decomposition
3.57	-names keyword --- Case Control of Source and External Names
3.58	-nofor_main --- Allow Non-Fortran Main Program
3.59	-noinclude --- Omit Standard Directory Search for INCLUDE Files
3.60	-nowsf_main --- Compile HPF Global Routine for Nonparallel Main Program
3.61	-o output --- Name Output File
3.62	-O0, -O1, -O2, -O3, -O4 or -O, -O5 --- Specify Optimization Level
3.63	-om --- Request Nonshared Object Optimizations
3.64	-omp --- Enable OpenMP Parallel Processing Using Directed Decomposition
3.65	-pad_source --- Pad Short Source Records with Spaces
3.66	-pipeline --- Activate Software Pipelining Optimization
3.67	-p0, -p1 or -p, -pg, and -pprof --- Profiling Support
3.68	-pthread --- Link Using Threaded Run-Time Library
3.69	-r8 or -real_size 64, -r16 or -real_size 128, -real_size 32 --- Floating-Point Data Size
3.70	-recursive --- Request Recursive Execution
3.71	-reentrancy keyword --- Control Use of Threaded Run-Time Library
3.72	-S --- Create Assembler File
3.73	-show keyword, -machine_code --- Control Listing File Content
3.73.1	-source_listing --- Create a Source Listing File
3.74	-speculate keyword --- Speculative Execution Optimization
3.75	-std or -std90, -std95 --- Perform Fortran 90/95 Standards Checking
3.76	-synchronous_exceptions --- Report Exceptions More Precisely
3.77	-syntax_only --- Do Not Create Object File
3.78	-threads --- Link Using Threaded Run-Time Library
3.79	-transform_loops --- Activate Loop Transformation Optimizations
3.80	-tune keyword --- Specify Alpha Processor Implementation
3.81	-U --- Activates Case Sensitivity
3.82	-Uname --- Undefine Preprocessor Symbol Name
3.83	-unroll num --- Specify Number for Loop Unroll Optimization
3.84	-V --- Create Listing File
3.85	-v --- Verbose Command Processing Display
3.86	-version --- Show Compaq Fortran Version Information
3.87	-vms --- OpenVMS Fortran Compatibility
3.88	-Wl,-xxx --- Pass Specified Option to ld
3.89	-warn keyword, -u, -nowarn, -w, -w1 --- Warning Messages and Compiler Checking
3.90	-warning_severity keyword --- Elevate Severity of Warning Messages
3.91	-what --- Print Version Strings
3.92	-wsf, -wsf num, and Related Options --- Compile HPF Programs for Parallel Execution
3.92.1	-assume bigarrays --- Run-time Checking for Distributed Small Array Dimensions
3.92.2	-assume nozsize --- Omit Zero-Sized Array Checking
3.92.3	-nearest_neighbor, -nearest_neighbor num, or -nonearest_neighbor --- Nearest Neighbor Optimization
3.92.4	-pprof method --- Prepare for Parallel Profiling
3.92.5	-show hpf --- Show HPF Parallelization Information