Cray Fortran Reference Manual (S-3901) 8.6 Contents Contents 1 About the Cray Fortran Reference Manual.............................................................................................................4 2 Fortran Compiler Introduction.................................................................................................................................5 3 Invoke the Cray Fortran Compiler...........................................................................................................................7 4 Compiler Command Line Options...........................................................................................................................9 4.1 Cache Management Options.....................................................................................................................9 4.2 Debug Options.........................................................................................................................................10 4.3 List and Compiler Info Options................................................................................................................11 4.4 General Optimization Options.................................................................................................................12 4.5 Interprocedural Analysis (IPA) Optimization Options...............................................................................20 4.6 Linker Options.........................................................................................................................................22 4.7 Math Options...........................................................................................................................................23 4.8 Message Options.....................................................................................................................................25 4.9 Miscellaneous Options............................................................................................................................27 4.10 Miscellaneous Fortran Specific Options................................................................................................31 4.11 Performance Tool Options.....................................................................................................................48 4.12 Preprocess Options...............................................................................................................................49 4.13 Program Model Specific Options...........................................................................................................51 4.14 Scalar Optimization Options..................................................................................................................52 4.15 Target Options.......................................................................................................................................52 4.16 Vector Optimization Options..................................................................................................................53 5 Set Environment Variables to the Cray Fortran Compiler.....................................................................................55 6 Cray Fortran Directive Use...................................................................................................................................60 6.1 Inline and Clone Directives......................................................................................................................61 6.2 Local Control Directives...........................................................................................................................63 6.3 Miscellaneous Directives.........................................................................................................................66 6.4 PGAS Directive........................................................................................................................................72 6.5 Scalar Optimization Directives.................................................................................................................73 6.6 Storage Directives...................................................................................................................................75 6.7 Vectorization Directives...........................................................................................................................77 7 Source Preprocessing..........................................................................................................................................89 8 OpenMP Overview................................................................................................................................................96 9 OpenACC Use....................................................................................................................................................105 10 Conformance Checks.......................................................................................................................................110 11 Cray Fortran Language Extensions..................................................................................................................112 11.1 Characters, Lexical Tokens, and Source Form....................................................................................112 2 Contents 11.2 Types...................................................................................................................................................113 11.3 Data Object Declarations and Specifications......................................................................................118 11.4 Expressions and Assignment..............................................................................................................120 11.5 Execution Control................................................................................................................................124 11.6 Input/Output Statements......................................................................................................................125 11.7 Error, End-of-record, and End-of-file Conditions.................................................................................125 11.8 Input/Output Editing.............................................................................................................................126 11.9 Program Units......................................................................................................................................130 11.10 Procedures........................................................................................................................................131 11.11 Intrinsic Procedures and Modules.....................................................................................................131 11.12 Exceptions and IEEE Arithmetic........................................................................................................133 11.13 Coarrays............................................................................................................................................134 11.14 Compile and Execute Programs Containing Coarrays......................................................................135 11.15 Submodules.......................................................................................................................................136 12 Cray Fortran Deferred Implementation and Optional Features........................................................................137 13 Cray Fortran Implementation Specifics.............................................................................................................138 14 Enhanced I/O: Using the assign Environment..................................................................................................146 14.1 Understand the assign Environment.................................................................................................146 14.2 Tune File Connection Behavior...........................................................................................................150 14.3 Define the Assign Environment File....................................................................................................161 14.4 Use Local Assign Mode.......................................................................................................................162 15 Interlanguage Communication..........................................................................................................................163 3 About the Cray Fortran Reference Manual 1 About the Cray Fortran Reference Manual The Cray® Fortran Reference Manual includes reference information for the Cray Fortran compiler. Cray Fortran Reference Manual (S-3901) 8.6 This version includes updated Fortran reference information to support CCE software release 8.6, released June 29, 2017. Scope and Audience This guide is intended as a general overview of the Cray Fortran compiler for users and application programmers. Typographic Conventions Monospace Indicates program code, reserved words, library functions, command-line prompts, screen output, file/path names, and other software constructs. Monospaced Bold Indicates commands that must be entered on a command line or in response to an interactive prompt. Oblique or Italics Indicates user-supplied values in commands or syntax definitions. Proportional Bold Indicates a GUI Window, GUI element, cascading menu