Index

Symbols

: , xvii
: !DIR$ in directives, 141
: !MIC$ in directives, 144
: .M file, module file, 149

A

abort on exceptions, 53

abrupt_underflow, 52

addenda for manuals, README file, xvi

align

: structures as in VMS Fortran, 92
: See also data

alignment, See data

analyzer compile option, -xF, 90

ANSI

: FORTRAN 77 standard, 2
: X3.198-1992 Fortran standard, 125

arithmetic See floating-point, 53

array bounds checking, 42

asa, Fortran print utility, 3

assembly code, 78

automatic variables, 79

auto-read, dbx, disable, 99

B

backward compatibilty, options, 32

basic block, profile by, -a, 39

binding

: dynamic, 47

blank space, xvii

Boolean

: constant, alternate forms, 129
: type, constants, 128

browser, 78

BS 6832 standard, 2

C

C$PAR DOALL directive, 18

C$PAR DOSERIAL directive, 18

C$PRAGMA C(..) directive, 16

C$PRAGMA directives, 15

C$PRAGMA SUN UNROLL, 16

C$PRAGMA WEAK directive, 17

C(...) directive, 16

cache

: padding for, 71
: specify hardware cache, 87

CALL

: preserving arguments over ENTRY statements, 40

CALL in a loop, parallelize, 79

case

: conventions, xvii
: with Fortran 90, 145

case preserving, 81

CDIR$ in directives, 141

CDIR$DOALL directive, 143

CDIR$FREE directive, 142

characters

: 8-bit, 151

CIF (Compiler Information File), 45

CMIC$ in directives, 144

code size, 100

command line

: f77, f90 syntax, 10
: unrecognized options, 13

command-line help, xv

comments

: as directives, 140
: debug, VMS, 92
: to Sun, xvi, 58

COMMON

: padding, 71

compatibility

: between compiler releases, 123
: C, 149
: Fortran 90 vs. Fortran 77, 145

compile and link, 10, 12

: and -B, 42
: build a dynamic shared library, 57
: compile only, 43
: consistent, 13
: dynamic (shared) libraries, 47
: suppress, 43

compiler

: command line, 10
: driver, show commands with -dryrun, 47
: error messages in local language, 152
: features, 2
: frequently used options, 27
: show version, 82
: timing, 81
: verbose messages, 83

constant arguments, -copyargs, 43

continuation lines, 47, 126

conventions

: file name suffixes, 11

conventions in text, xvii

copy restore, 40

cpp, C preprocessor, 12, 44, 49

Cray

: character pointer, 137
: pointer, 132
: pointer and Fortran 90 pointer, 133
: pointer and optimization, 136

cross reference table, -Xlist, 94

D

D in column one (VMS Fortran), 92

data

: alignment with -dalign, 45
: alignment with -dbl_align_all, 46
: alignment with -f, 50
: allow misaligned data, -misalign, 64
: default sizes and -dbl, 45
: default sizes and -r8, 76
: interpret REAL as DOUBLE PRECISION, 76
: mappings with -xtypemap, 106

data dependency

: -depend, 47

dbx

: f77 -g, 57
: faster initialization, 99

debugging

: check array subscripts with -C, 42
: comments, VMS, 92
: cross-reference table, 94
: -g option, 57
: global program checking with -Xlist, 94
: sbrowser, 4
: show compiler commands with -dryrun, 47
: utilities, 4
: with optimization, 57
: without object files, 99
: -Xlist, 4

default

: include file paths, 59

define symbol for cpp, -Dname, 44

differences

: Sun Fortran 90, 125

directives

: DOALL, 143
: explicit parallelization, 143
: Fortran 77, 15
: Fortran 90, 140
: loop unrolling, 16
: parallelization (f77), 17
: parallelization (f90), 143
: parallelization, Cray or Sun, 64
: weak linking, 17

E

: send feedback comments to Sun, xvi

environment, 1

: program terminations by STOP, 80

environment variables

: usage, 20

errata and addenda for manuals, README file, xvi

error

messages

: in the local language, 152

error messages

: I/O, 110
: message tags, 48
: suppress with -erroff, 48
: with error, 4

error, error message display, 4

exceptions, floating-point, 53, 55

: disable, 53
: trapping, 56

executable file

: built-in path to dynamic libraries, 75
: name, 70
: strip symbol table from, 78

explicit

: typing, 82

explicit parallelization directives, 17

extensions

: non-ANSI, -ansi flag, 40
: VAX VMS Fortran features with -xl, 92

external

: C functions, 16

external names, 49

F

f77, f90 command line, 10, 25

f90browse, code-browsing utility, 4, 45

features, 2

: Fortran 90, 125
: release history, 121

feedback file for email to Sun, xvi

feedback to Sun, -help, 58

FFLAGS environment variable, 20

file

: .M, See module files
: executable, 10
: object, 10
: size too big, 21

file names

: recognized by the compiler, 11
: recognized by the compiler (f90), 127

FIPS 69-1 standard, 2

fixed-format source, 52

: directives, 141
: tabs, 126

flags See options

floating-point

: exception trapping, 53
: fpversion, shows hardware, 19
: non-standard, 53
: precision (Intel), 56
: precision mode, 54
: preferences, -fsimple, 55
: rounding, 54
: trapping mode, 56
: See also SunSoft Numerical Computation Guide

font

: boldface, xvii
: conventions, xvii
: Courier, xvii
: italic, xvii

Fortran

documentation, xiii

mixing f77 and f90 compilations, 13

preprocessor, 44

: invoking with -F, 49

README file, bugs, new and changed features, xvi

standards, 2

utilities, 3

Fortran 90

: case, 128
: case insensitivity, 145
: modules, 149
: Sun features, 125

fpp, Fortran preprocessor, 12, 44, 49

fpversion, show floating-point version, 19

free-format source, xvii, 54

: directives, 141
: tabs, 126

function

: external C, 16

function-level reordering, 90

G

gencat, 153

global offset table, 73

global program checking, -Xlist, 94

global symbols

: weak, 17

gprof

: -pg, profile by procedure, 73
: profile by procedure utility, 3

GSA validation standard, 2

H

hardware

: floating-point fpversion, 19

hardware architecture, 85, 89, 100

help

: README information, 91

help, command-line, xv

hexadecimal, 129

Hollerith, 130

I

IEEE arithmetic

: 754 standard, 2, 125

ild, incremental linker, 91

impatient user's guide, 8

INCLUDE files, 58

information files, xvi

inline, 51

: templates, -libmil, 62

inlining

: automatic with -O4, 69

input/output

: compatibility, f77/f90, 147
: error messages, 110

installation, xvi

installation path, 59

integer, size four and eight bytes, 59

Intel x86, xii

internationalization, 151

intrinsic procedures, extensions, 139

invalid, floating-point, 56

ISO/IEC 1539 Fortran 90 standard, 2

L

language

: localization, 152

large files, 21

LC_MESSAGES, 154

legacy compiler options, 32

libm

: optimized, 62
: searched by default, 61

libraries

: SunSoft Performance Library, 5

library

: build, -G, 57
: disable system libraries, 66
: dynamic search path in executable, 75
: licensed, 93
: linking with -l, 62
: multithread-save, 65
: name a shared library, 58
: path to shared library in executable, 68
: position-independent and pure, 107

license information, 93

licensing, 2

limit

: command, 22
: stack size, 80

linking

: consistent with compilation, 13
: disable incremental linker, 91
: disable system libraries, 66
: enable dynamic linking, shared libraries, 47
: enable incremental linker, 91
: linker -Mmapfile option, 91
: mixed Fortran 77 and Fortran 90 compilations, 13
: separate from compilation, 12
: specifying libraries with -l, 62
: weak names, 17
: with automatic parallelization, -autopar, 41
: with compilation, 10
: with licensed libraries, 93

list of options, 58

local variables

: allocate on memory stack, 79

localization, 152

loop

: automatic parallelization, 41
: dependence analysis, -depend, 47
: executed once, -onetrip, 70
: explicit parallelization, 48
: parallelization messages, 63
: parallelizing a CALL in a loop, 79
: profiling, 107
: unrolling with -unroll, 82

loop unrolling

: directive, 16

looptool, loop profiler for MP, 107

lowercase, do not convert to, 81

M

man pages, xiv

manuals, xiii

math library

: and -Ldir option, 61
: optimized version, 93

memory

: actual real memory, display, 22
: limit virtual memory, 22
: optimizer out of memory, 21

messages

: catalogs, 152
: I/O error, 110
: local language versions, 152
: parallelization, 63, 84
: runtime, 109
: signal handler, 110
: suppress with -silent, 78
: verbose, 83

MIL-STD-1753 standard, 2

module file (.M file), 149

modules

: creating and using, 14
: search path, 63

multiplatform release, xii, 1

multithreading

: See parallelization

multithread-safe libraries, 65

N

name

: argument, do not append underscore, 16
: object, executable file, 70

native language characters, 151

NBS validation standard, 2

network licensing, 2

NIST validation standard, 2

nonstandard_arithmetic(), 52

O

object files

: compile only, 43
: name, 70

object library search directories, 61

obsolescent options, 32

octal, 129

one-trip DO loops, 70

on-line documentation, xiii

optimization

: across source files, 90
: Cray pointers, 136
: floating-point, 55
: inline user-written routines, 60
: levels, 68
: libm, 62
: loop profiling, 107
: loop unrolling, 82
: loop unrolling by directive, 16
: math library, 93
: specify cache, 87
: specify hardware architecture, 85
: specify processor, 89
: target hardware, 65, 100
: with debugging, 57
: with -fast, 50

optimizer out of memory, 21

options

grouped by function, 27

legacy, 32

library and linking, 28

licensing, 29

obsolete, 32

order of processing, 26

parallelization, 30

pass option to compilation phase, 75

performance, 29

profiling, 31

requiring consistent compile and link, 13

show list of, -help, 58

silent, 33

summary, 33 to 38

syntax on command line, 26

unrecognized, 13

Reference to all option flags, 39 to 108

-386, 39

-486, 39

-a, 39

-ansi extensions, 40

-arg=local, preserve ENTRY arguments, 40

-autopar, parallelize automatically, 41

-Bdynamic, 42

-Bstatic, 42

-C, check subscripts, 42

-c, compile only, 43

-cg89, 43

-cg92, 43

-copyargs, allow stores to literal arguments, 43

-dalign, 45

: with -fast, 51

-db, generate CIF file (f90), 45

-dbl

: and -xtypemap, 46
: double default data sizes, 45

-dbl_align_all, force data alignment, 46

-depend

: data dependency analysis, 47
: with -fast, 51

-dn, 47

-Dname, define symbol, 44

-dryrun, 47

-dy, 47

-e, extended source lines, 47

-erroff, suppress warnings, 48

-errtags, display message tag with warnings, 48

-explicitpar, parallelize explicitly, 48

-ext_names, externals without underscore, 49

-F, 49

-f, align on 8-byte boundaries, 50

-fast

: fast execution, 50

-fixed, 52

-flags, 52

-fnonstd, 52

-fnonstop, 53

-fns, 53

: with -fast, 51

-fprecision=p, 54

-free, 54

-fround=r, 54

-fsimple

: simple floating-point model, 55
: with -fast, 51

-fstore, 56

-ftrap, 56

: with -fast, 51

-G, 57

-g, 57

-help, 58

-hname, 58

-i2, short integers, 59

-i4, 59

-Idir, 58

-inline, 60

-KPIC, 61

-Kpic, 61

-Ldir, 61

-libmil, 62

: with -fast, 51

-llibrary, 62

-loopinfo, show parallelization, 63

-Mdir, f90 modules, 149

-Mdir, f90 modules, 63

-misalign, 64

-mp=cray, Cray MP directives, 65

-mp=sun, Sun MP directives, 65

-mt, multithread safe libraries, 65

-native, 65

-native

: with -fast, 50

-noautopar, 66

-nodepend, 66

-noexplicitpar, 66

-nofstore, 66

: with -fast, 51

-nolib, 66

-nolibmil, 67

-noqueue, 67

-noreduction, 68

-norunpath, 68

-O, 68, 69

: with -g, 57, 68

-o, output file, 70

-O4, 69

: with -fast, 51

-O5, 70

-oldldo, 70

-onetrip, 70

-p, profile by procedure, 71

-pad=p, 71

-parallel, parallelize loops, 72

-pentium, 73

-pg, profile by procedure, 73

-PIC, 74

-pic, 73

-Qoption, 75

-R list, 75

-r8

: and -xtypemap, 76

-r8, 76

-reduction, 77

-s, 78

-sbfast, 78

-silent, 78

-stop_status=yes, 80

-temp, 81

-time, 81

-u, 82

-U do not convert to lowercase, 81

-unroll, unroll loops, 82

-V, 82

-v, 83

-vax=v, 92

-vax=v, 83

-vpara, 84

-w, 84

-xa, 84

-xarch=a, 85

-xautopar, 87

-xcache=c, 87

-xcg[89|92], 88

-xchip=c, 89

-xcrossfile, 90

-xdepend, 90

-xexplicitpar, 90

-xF, 90

-xhelp=h, 91

-xildoff, 91

-xildon, 91

-xinline, 92

-xld, 92

-xlibmil, 93

-xlibmopt, 93

: with -fast, 51

-xlic_lib=libs, 93

-xlicinfo, 93

-Xlist

: suboptions, 95

-Xlist, global program checking, 94

-xloopinfo, 95

-xnolib, 96

-xnolibmopt, 96

-xOn, 96

-xparallel, 96

-xpg, 96

-xpp=p, 96

-xprofile=p, 97

-xreduction, 98

-xregs=r, 98

-xs, 99

-xsafe=mem, 99

-xsb, 100

-xsbfast, 100

-xspace, 100

-xtarget=t, 100 to 105

-xtime, 105

-xtypemap

: and -dbl, 46

-xtypemap=spec, 106

-xunroll, 107

-xvpara, 107

-Zlp, loop profiler, MP, 107

-ztext, 107

-Ztha, prepare for Thread Analyzer, 108

OPTIONS environment variable, 20

order of

: functions, 90

order of processing, options, 26

overflow, 56

: stack, 79

P

padding, 71

parallelization

: and -stackvar, 79
: automatic, 41
: automatic and explicit, -parallel, 72
: directives (f77), 17
: directives (f90), 143
: explicit, 48
: loop information, 63
: messages, 84
: reduction operations, 77
: select Cray or Sun directives, 64
: with multithreaded libraries, 65
: See also SunSoft Fortran:Programmer's Guide

passes of the compiler, 83

path

: #include, 58
: dynamic libraries in executable, 75
: library search, 61
: modules search, 63
: to standard include files, 59

Pentium, xii, 73, 105

performance

: optimization, 50
: SunSoft performance library, 4

pointee, 132

pointer, 132

position-independent code, 73, 74

PowerPC, xii

pragma, See directives

preprocessor, source file

: define symbol, 44
: fpp, cpp, 12

preserve case, 81

: asa, 3

PRIVATE parameter of DOALL, 144

processor

: specify target processor, 89, 100

prof, -p, 71

profile

: gprof, 3
: tcov, 4
: threads, 108

profile by

: basic block, 39
: loop for MP, -Zlp, looptool, 107
: procedure, -pg, gprof, 73

profiling, -xprofile, 97

Q

: quick start, 8

R

: range of subscripts, 42
: README file, xvi, 91
: register usage, 98
: release history, 121
: reorder functions, 90
: rounding, 54, 55

S

-S, 78

-sb, SourceBrowser, 78

sbrowser, code-browsing utility, 4

: modules, 63
: object library directories, 61

set

: #include path, 58

shared libraries

: global offset table, 73

shared library

: build, -G, 57
: disallow linking, -dn, 47
: name a shared library, 58
: position-independent code, 73
: pure, no relocations, 107

SHARED parameter of DOALL, 144

shell

: limits, 22

SIGFPE, floating-point exception, 53

signal handler, 110

silent options, 33

size of compiled code, 100

source code browser, 4

source file

: preprocessing, 12

source format

: directives (f90), 127
: mixing format of source lines (f90), 127
: options (f90), 127
: suffixes (f90), 127

source lines

: extended, 47
: fixed-format, 52
: free-format, 54
: line length, 126
: preprocessor, 96
: preserve case, 81
: tab character, 126

SourceBrowser, 78

SPARC, xii

stack

: increase stack size, 80
: overflow, 79

-stackvar, 79

standard

: include files, 59

standards, xiii

: conformance to standards, 2
: Fortran 90, 125
: identify non-ANSI extensions, -ansi flag, 40

statement

: profile by, -a and tcov, 39

static

: binding, 47

STOP statement, return status, 80

strip executable of symbol table, -s, 78

subnormal number, 53

suffix

: of file names recognized by compiler, 11
: of file names recognized by compiler (f90), 127

Sun WorkShop, 4

Sun Workshop, 2

Sun, sending feedback to, xvi

suppress

: auto-read for dbx, 99
: blank in listed-directed output, 70
: converting uppercase letters to lowercase, 81
: implicit typing, 82
: license queue, 67
: linking, 43
: warnings, 84
: warnings by tag name, -erroff, 48

swap command, 21

swap space

: display actual swap space, 21
: increasing, 22
: limit amount of disk swap space, 21

symbol table

: for dbx, 57, 99

syntax

: compiler command line, 25
: f77, f90 commands, 25
: f77, f90 commands, 10
: options on compiler command line, 26

T

tab character in source, 126

tab format, xvii

tcov

: -a, profile by statement, 39
: new style with -xprofile, 97
: profile utility, 4

templates inline, 62

temporary files, directory for, 81

Thread Analyzer, 108

thread stack, 79

trapping

: floating-point exceptions, 56
: on memory, 99

triangle as blank space, xvii

type declaration alternate form, 131

U

ulimit command, 22

underflow, 56

: forced to zero, 54

underscore, 49

: do not append to external names, 16

unrecognized options, 13

UNROLL directive, 16

uppercase, xvii

usage

: compiler, 10

utilities, 3

V

variables

: undeclared, 82

VAX VMS Fortran

: extensions, 3
: features with -vax, 83
: features with -xl, 92

version

: id of each compiler pass, 82

W

warnings

: message tags, 48
: suppress messages, 84
: suppress with -erroff, 48
: undeclared variables, 82
: use of non-standard extensions, 40

weak linker symbols, 17

Workshop, 2

X

: X3.9-1978 ANSI standard, 2