Index

Numbers and Symbols

!DIR$ in directives, 190

A

abrupt_underflow, 70 address space, 103 aliasing, 104

-xalias, 104 align, 64

See also data

-dalign, 60

data in COMMON with -aligncommon, 54 alignment of data types, 173

ALLOCATABLE extensions, 183

analyzer compile option, xF, 121 arithmetic See floating-point array bounds checking, 57 assembly code, 95

ASSUME directive, 34

B

backward compatibility, command-line options, 52 binary I/O, 188

binding, dynamic/shared libraries, 61 Boolean

constant, alternate forms, 170 type, constants, 170

C

C(..) directive, 31 cache

padding for, 89

specify hardware cache, 111

CALL

inlining subprogram calls with -inline, 79

cccommand-line options -xcompress, 118, 118

-xdebuginfo, 119 -xinline_param, 126

-xinline_report, 128

CDIR$ in directives, 190 code size, 159 command-line

help, 20 command-line options

-aligncommon, 54 -ansi, 55

-arg=local, 55

-autopar, parallelize automatically, 56

-Bdynamic, 57 -Bstatic, 57

-C, check subscripts, 57 -c, compile only, 58

-copyargs, allow stores to literal arguments, 58

-dalign, 60, 67

-dbl_align_all, force data alignment, 61

-depend, 66

data dependency analysis, 61

-dn, 61

-Dname, define symbol, 59

-use, 193

-V, 100 -v, 100

-vax, 101 -vpara, 101

-W, 102 -w, 103

-xaddr32, 103 -xalias=list, 104

-xannotate[={yes|no}], 105 -xarch=isa, 106 -xassume_control, 35, 110 -xautopar, 111

-xcache=c, 111 -xchip=c, 114 -xcode=c, 116

-xcommoncheck, 117

-xdebugformat, 119 -xdepend, 121

-xF, 121

-xglobalize, 123

-xhasc, Hollerith as character, 124

-xhelp=h, 124 -xhwcprof, 125 -xinline, 126

-xinstrument, 129

-xipo, interprocedural optimizations, 129

-xipo_archive, 132 -xipo_build, 132 -xivdep, 133

-xjobs, multiprocessor compilation, 134 -xkeepframe, prohibit stack-related optimizations, 135

-xknown_lib, optimize library calls, 136 -xl, (obsolete), 137

-xlang=f77, link with Fortran 77 libraries, 137 -xld, (obsolete), 137

-xlibmil, 137 -xlibmopt, 67, 137 -Xlinker, 103 -xlinkopt, 138

-xlinkopt, link-time optimizations, 138

-xloopinfo, 140

-xM, 140

-xmaxopt, 141 -xmemalign, 141

-xnolib, 143, 143

-xnolibmopt, 143

-xOn, 143

-xopenmp, 144 -xpagesize, 145

-xpagesize_heap, 146 -xpagesize_stack, 146

-xpatchpadding, 147 -xpec, 147

-xpg, 147 -xpp=p, 147

-xprefetch, 34, 34

-xprefetch_auto_type, 150 -xprofile=p, 151

-xprofile_ircache, 154 -xprofile_pathmap=param, 154 -xrecursive, 155 -xreduction, 155

-xregs=r, 156

-xs, 157

-xsafe=mem, 158 -xsecure_code_analysis, 158

-xsegment_align, 158 -xspace, 159

-xtarget=native, 66 -xtarget=t, 159 -xtemp, 162

-xthroughput, 162 -xtime, 163 -xtypemap, 163

-xunboundsym, 164 -xunroll, 164 -xvector, 67, 164 -ztext, 166

Reference to all option flags, 54 grouped by function, 47

summary, 47 commonly used, 51 default options file, 42 legacy, 52

macros, 52 obsolete, 53

obsolete f77 flags not supported, 203 order of processing, 46

pass option to compilation phase, 92 syntax, 45

unrecognized options, 28 comments

as directives, 190

COMMON alignment, 54 padding, 89

TASKCOMMON consistency checking, 117 compatibility

Fortran 77, 64, 197 forward, 194

with C, 195

compile and link, 25, 27 and -B, 57

build a dynamic shared library, 76 compile only, 58

dynamic (shared) libraries, 62 compiler

command line, 24

driver, show commands with -dryrun, 61, 61 show version, 100

timing, 98

verbose messages, 101 constant arguments, -copyargs, 58 continuation lines, 62, 167 conventions

file name suffixes, 25 coverage analysis (tcov), 153 cpp compiler option

-gz, 77

cpp, C preprocessor, 26, 59, 64 Cray

pointer, 175

pointer and Fortran pointer, 176

D data

alignment with -dbl_align_all, 61 alignment with -f, 64

alignment with -xmemalign, 141 COMMON, alignment with aligncommon, 54 mappings with -xtypemap, 163

promote constants to REAL*8, 93 size and alignment, 173

data dependence

-depend, 61

dbx

compile with -g option, 76, 76 debug compress, 118

debugging

-g option, 76, 76

check array subscripts with -C, 58

link debug information from object files into executable, 157

show compiler commands with -dryrun, 61, 61 utilities, 19

with optimization, 76 default

data sizes and alignment, 173 include file paths, 79

define symbol for cpp, Dname, 59 directives

ASSUME, 34

FIXED, 191 Fortran 77, 29

FREE, 191

IGNORE_TKR, 31 loop unrolling, 32

OpenMP (Fortran), 36, 225 optimization level, 33 parallelization, 36, 191 special Fortran, 190 summary of all directives, 223 weak linking, 32

directory

temporary files, 97 dynamic library

build, -G, 76

name a dynamic library, 77

E

F

f95 command line, 24, 45

fdumpmod for viewing module contents, 29, 194 features

Fortran 95, 167 release history, 215

features and extensions, 18 file

executable, 25

object, 25

size too big, 40 file names

recognized by the compiler, 25, 169 FIXED directive, 191, 191 fixed-format source, 68

flags See command-line options floating-point

non-standard, 70 preferences, -fsimple, 73 rounding, 72

trapping mode, 75

G

global symbols

weak, 32

gprof

-pg, profile by procedure, 91

H

hardware architecture, 106, 114 heap page size, 145, 146, 146 help

command-line, 20 hexadecimal, 171 Hollerith, 171

I

I/O extensions, 188

#ifdef, 26

IGNORE_TKR directive, 31 IMPORT statement, 184

#include, 26 #include path, 78

INCLUDE files, 78 floatingpoint.h, 205

system.inc, 38

incompatibilities, FORTRAN 77, 202 initialization of local variables, 113 inline

templates, -libmil, 82 with -fast, 66

inlining

automatic with -O4, 88 with -inline, 79

installation path, 79

interfaces library, 38

intrinsics extensions, 194 interfaces, 38

legacy Fortran, 204 invalid, floating-point, 75

ISA, instruction set architecture, 106

IVDEP directive, 37, 133

L

large files, 40

legacy compiler options, 52

libm

searched by default, 81 libraries

building shared libraries, 117

Oracle Developer Studio Performance Library, 19 library

automatic parallelization, 56 dependence analysis, -depend, 61 executed once, -onetrip, 89 parallelization messages, 83 unrolling with -unroll, 100 unrolling with directive, 32

M

.mod file, module file , 192 macro command-line options, 52 man pages, 19

math library

and -L dir option, 81 optimized version, 137

memory

actual real memory, display, 40 limit virtual memory, 41 optimizer out of memory, 40

messages

parallelization, 83, 101 runtime, 207

suppress with -silent, 95 verbose, 101

misaligned data, specifying behavior, 141 MODDIR environment variable, 84 modules, 192

-use, 193

.mod file , 192 creating and using, 28 default path, 84

fdumpmod for displaying module files, 194 fdumpmod for viewing module contents, 29

multithreading, 85 See parallelization

N name

object, executable file, 88

nonstandard_arithmetic(), 70 numeric sequence type, 54

O

object files

compile only, 58 name, 88

object library search directories, 81 object-oriented Fortran, 185 obsolete command-line options, 53 octal, 170

OMP_NUM_THREADS, number of threads, 56 one-trip DO loops, 89

OpenMP, 36

directives summary, 225 OPT directive, 33

-xmaxopt option, 141 optimization

across source files, 129 aliasing, 104 floating-point, 73

inline user-written routines, 79 interprocedural, 129

levels, 87 link-time, 138 loop unrolling, 100

loop unrolling by directive, 32 math library, 137

OPT directive, 33, 141 PIPELOOP directive, 33 PREFETCH directive, 34 specify cache, 111

specify instruction set architecture, 106 specify processor, 114

target hardware, 85 with -fast, 66 with debugging, 76

options See command-line options order of

functions, 121

order of processing, options, 46 overflow

stack, 96

trap on floating-point, 75 overindexing

aliasing, 104

P

PIPELOOP directive, 33 pointee, 175

pointer, 175 aliasing, 104

position-independent code, 91, 92 POSIX library, not supported, 203 POSIX threads, 85

pragma See directives precision on x86

-fprecision, 72 -fstore, 74

PREFETCH directive, 34, 34, 34 preprocessor, source file

define symbol, 59 force -fpp, 71 fpp, cpp, 26

specify with -xpp=p, 147 undefine symbol, 99

processor

specify target processor, 114 profile data path map, 154 profiling

-pg, -gprof, 91 -xprofile, 151

R

range of subscripts, 57 recursive subprograms, 155 release history, 215 reorder functions, 121 rounding, 72, 74

S

-shared, 95 search

object library directories, 81 shared library

build, -G, 76

disallow linking, -dn, 61 name a shared library, 77 pure, no relocations, 166

shell

limits, 41

SIGFPE, floating-point exception, 70

instruction set architecture, 107 stack

increase stack size, 97 overflow, 96

setting page size, 145, 146, 146 standard

include files, 79

standard numeric sequence type, 54 standards

conformance, 17

identify non-ANSI extensions, -ansi flag, 55 static

binding, 61

T tab

form source tab, 167 tape I/O, not supported, 203

tcov

-xprofile, 153 templates, inline, 82

temporary files, directory for, 97 traceback, 98

trapping

floating-point exceptions, 75 on memory, 158

type declaration alternate form, 172

U

V variables

alignment, 173 local, 96 undeclared, 99

VAX VMS Fortran extensions, 101, 178 version

id of each compiler pass, 100

W warnings

message tags, 62 suppress messages, 103 suppress with -erroff, 62 undeclared variables, 99

use of non-standard extensions, 55 WEAK directive, 32

weak linker symbols, 32

X

-xcode, 116