Index (Sun Studio 12: Fortran Programming Guide)

Sun Studio 12: Fortran Programming Guide


Numbers and Symbols

	`!$OMP` ( )

	`!$OMP PARALLEL` ( )

	`%VAL()`, pass by value ( )


A

	abrupt underflow ( )

	`ACCESS=’STREAM’` ( )

	accessible documentation ( )

	agreement across routines, `Xlist` ( )

	aliasing ( )

	align
		data types, Fortran 95 vs. C ( )
		errors across routines, `Xlist` ( )
		numeric sequence types ( )

	analyzing performance ( )

	`ar` to create static library ( ) ( )

	arguments, reference versus value, ( )

	array, differences between C and Fortran ( )

	`asa`, Fortran print utility ( )

	ASCII characters, maximum characters in data types ( )

	assertions ( )

	ASSUME pragma ( )


B

	`-Bdynamic, -Bstatic` options ( )

	binary I/O ( )

	BIND ( )

	bindings, static or dynamic (`-B, -d`) ( )


C

	C directive ( )

	C-Fortran interface, function compared to subroutine ( )

	`C` option ( )

	C–Fortran interface
		array indexing ( )
		by reference or value ( )
		call arguments and ordering ( )
		case sensitivity ( )
		comparing I/O ( )
		compatibility issues ( )
		data type compatibility ( )
		function names ( ) ( )
		passing data by value ( ) ( ) ( )
		sharing I/O ( )

	call
		in parallelized loops ( )
		inhibiting optimization ( )
		passing arguments by reference or value ( )

	call graphs, with `Xlistc` option ( )

	carriage-control ( )

	case sensitivity ( )

	`catch FPE` ( )

	Collector, defined ( )

	command-line, help ( )

	command line
		passing runtime arguments ( )
		redirection and piping ( )

	common block, maps, `Xlist` ( )

	compiler commentary ( )


D

	`-dalign` option ( )

	data
		Hollerith ( )
		inspection, `dbx` ( )
		maximum characters in data types ( )
		representation ( )

	data dependency
		apparent ( )
		parallelization ( )
		restructuring to eliminate ( )

	`date`, VMS ( )

	debug ( )
		arguments, agree in number and type ( )
		common blocks, agree in size and type ( )
		compiler options ( )
		`dbx` ( )
		exceptions ( )
		index check of arrays ( )
		linker debugging aids ( )
		parameters, agree globally ( )
		segmentation fault ( )
		subscript array bounds checking ( )

	debugging
		utilities ( )
		`-Xlist` ( )

	declared but unused, checking, `Xlist` ( )

	denormalized number ( )

	`-depend` option ( )

	direct I/O ( )
		to internal files ( )

	directives
		`C()` C interface ( )
		OpenMP parallelization ( )
		`OPT=``n` optimization levels ( )

	display to terminal, `Xlist` ( )

	division by zero ( )

	`-dn, -dy` options ( )

	documentation, accessing ( )

	documentation index ( )

	dynamic libraries, See libraries, dynamic


E

	environment variables
		for parallelization ( )
		`LD_LIBRARY_PATH` ( )
		`OMP_NUM_THREADS` ( )
		`PARALLEL` ( )
		passed to program ( )
		`STACKSIZE` ( )

	environment variables`$SUN_PROFDATA` ( )

	equivalence block maps, `Xlist` ( )

	error
		messages
			suppress with `Xlist` ( )
		standard error
			accrued exceptions ( )

	error messages, listing with `XlistE` ( )

	establish a signal handler ( )

	event management, `dbx` ( )

	exceptions
		accrued ( )
		debugging ( )
		detecting ( )
		IEEE ( )
		`ieee_handler` ( )
		suppressing warnings with `ieee_flags` ( ) ( )
		trapping
			with `-ftrap=``mode` option ( )

	extensions and features ( )

	external
		C functions ( )
		names ( )


F

	`f90_init` ( )

	`-fast` option ( )

	features and extensions ( )

	feedback, performance profiling ( )

	file names, passing to programs ( )

	files
		internal ( )
		opening scratch files ( )
		passing file names to programs ( ) ( )
		preconnected ( )
		standard error ( )
		standard input ( )
		standard output ( )

	fix and continue, `dbx` ( )

	floating-point arithmetic ( )
		See also IEEE arithmetic
		considerations ( )
		denormalized number ( )
		exceptions ( )
		IEEE ( )
		underflow ( )

	`-fns`, disable underflow ( )

	`FORM=’BINARY’` ( )

	Forte Developer Performance Analyzer ( )

	Fortran
		features and extensions ( )
		libraries ( )
		utilities ( )

	Fortran 2003
		interoperability with C ( )
		stream I/O ( )

	`FPE` catch in `dbx` ( )

	`-fsimple` option ( )

	`fsplit`, Fortran utility ( )

	`-ftrap=``mode` option ( )

	function
		compared to subroutine ( )
		data type of, checking, `Xlist` ( )
		names, Fortran vs. C ( )
		unused, checking, `Xlist` ( )
		used as a subroutine, checking, `Xlist` ( )


G

	`G` option ( )

	`GETARG` library routine ( ) ( )

	`GETENV` library routine ( ) ( )

	global program checking, See `-Xlist` option


H

	help, command-line ( )

	Hollerith data ( )


I

	IEEE (Institute of Electronic and Electrical Engineers) ( )

	IEEE arithmetic
		754 standard ( )
		continue with wrong answer ( )
		exception handling ( )
		exceptions ( )
		excessive overflow ( )
		gradual underflow ( ) ( )
		interfaces ( )
		signal handler ( )
		underflow handling ( )

	`ieee_flags` ( ) ( ) ( )

	`ieee_functions` ( )

	`ieee_handler` ( ) ( )

	`ieee_retrospective` ( ) ( )

	`ieee_values` ( )

	include files, list and cross checking with `XlistI` ( )

	inconsistency
		arguments, checking, `Xlist` ( )
		named common blocks, checking, `Xlist` ( )

	indirect addressing, data dependency ( )

	inexact, floating-point arithmetic ( )

	initialization ( )

	inlining calls with `-O4` ( )

	input/output ( )
		accessing files ( )
		comparing Fortran and C I/O ( )
		direct I/O ( ) ( )
		extensions
			binary I/O ( )
			stream I/O ( )
		Fortran 95 considerations ( )
		in parallelized loops ( )
		inhibiting optimization ( )
		inhibiting parallelization ( )
		internal I/O ( )
		logical unit ( )
		opening files ( )
		preconnected units ( )
		random I/O ( )
		redirection and piping ( )
		scratch files ( )

	interface, problems, checking for, `Xlist` ( )

	internal files ( )

	interval arithmetic ( )

	`INTERVAL` declaration ( )

	ISO_C_BINDING ( )


L

	labels, unused, `Xlist` ( )

	`-L``dir` option ( )

	`libF77` ( )

	`libM77` ( )

	libraries ( )
		dynamic
			creating ( )
			naming ( )
			position-independent code ( )
			specifying ( ) ( )
			tradeoffs ( )
		in general ( )
		linking ( )
		load map ( )
		optimized ( )
		provided with Sun WorkShop Fortran ( )
		redistributable ( )
		search order
			command line options ( )
			`LD_LIBRARY_PATH` ( )
			paths ( )
		shared
			See dynamic
		static
			64–bit SPARC ( )
			creating ( )
			ordering routines ( )
			recompile and replace module ( )
			tradeoffs ( )
		Sun Performance Library ( ) ( )

	line-numbered listing, `Xlist` ( )

	linking
		binding options (`-B, -d`) ( )
		consistent compile and link ( )
		libraries ( )
			specifying static or dynamic ( )
		mixing C and Fortran ( )
		search order ( )
			`-l`x, `-L`dir ( )
		troubleshooting errors ( )

	lint-like checking across routines, `Xlist` ( )

	listing
		cross-references with `Xlist` ( )
		line numbered with diagnostics, `Xlist` ( )
		`XlistL` ( )

	logical unit ( )

	loop unrolling
		and portability ( )
		with `-unroll` ( )

	`-l``x` option ( )


M

	`-m` linker option for load map ( )

	macros, with `make` ( )

	`make` ( )
		command ( )
		macros ( )
		makefile ( )
		suffix rules ( )

	`makefile` ( )

	man pages ( )

	maps
		common blocks, `Xlist` ( )
		equivalence blocks, `Xlist` ( )

	measuring program performance, See performance, profiling

	memory, usage ( )

	multithreading, See parallelization


N

	`nonstandard_arithmetic()` ( )

	number of
		reads and writes ( )
		swapouts ( )

	number of threads ( )

	numeric sequence type ( )


O

	`OMP_NUM_THREADS` environment variable ( )

	OpenMP parallelization ( )
		check directives with `-XlistMP` ( )
		See also the OpenMP API User’s Guide ( )

	optimization
		See also performance
		with `-fast` ( )

	options
		debugging, useful ( )
		for optimization ( )

	order of
		linker libraries search ( )
		linker search ( )
		`-l`x, `-L`dir options ( )

	output
		to terminal, `Xlist` ( )
		`Xlist` report file ( )

	overflow
		excessive ( )
		floating-point arithmetic ( )
		locating, example ( )
		with reduction operations ( )


P

	`PARALLEL` environment variable ( )

	parallelization ( )
		automatic ( ) ( ) ( )
		`CALL`, loops with ( )
		chunk distribution ( )
		data dependency ( )
		debugging ( )
		default thread stack size ( )
		definitions ( )
		directives ( ) ( )
		environment variables ( )
		explicit
			criteria ( )
			OpenMP ( )
			scoping rules ( )
		inhibitors
			to automatic parallelization ( )
			to explicit parallelization ( )
		nested loops ( )
		private and shared variables ( )
		reduction operations ( )
		specifying number of threads ( )
		specifying stack sizes ( )
		`-stackvar` option ( )
		steps to ( )
		what to expect ( )

	performance
		optimization ( )
			choosing options ( )
			further reading ( )
			hand restructurings and portability ( )
			inhibitors ( )
			inlining calls ( )
			interprocedural ( )
			libraries ( )
			loop unrolling ( )
			`-O``n` options ( )
			`OPT=``n` directive ( )
			specifying target hardware ( )
			with runtime profile ( )
		profiling
			`tcov` ( )
			`time` ( )
		Sun Performance Library ( )

	performance analyzer ( )
		compiler commentary ( )

	performance library ( )

	platforms, supported ( )

	porting ( )
		accessing files ( )
		aliasing ( )
		carriage-control ( )
		data representation issues ( )
		Hollerith data ( )
		initializing with Hollerith ( )
		nonstandard coding ( )
		obscure optimizations ( )
		precision considerations ( )
		strip-mining ( )
		time functions ( )
		troubleshooting guidelines ( )
		uninitialized variables ( )
		unrolled loops ( )

	position-independent code, `xcode` ( )

	preconnected units ( )

	preserve case ( )

	preserving precision ( )

	print, `asa` ( )

	process control, `dbx` ( )

	program analysis ( )

	program development tools ( )
		`make` ( )
		SCCS ( )

	program performance analysis tools ( )

	`psrinfo` SunOS command ( )

	pure scalar variable, defined ( )


R

	random I/O ( )

	`README` file ( )

	reads, number of ( )

	recurrence, data dependency ( )

	redistributable libraries ( )

	reduction operations
		data dependency ( )
		numerical accuracy ( )
		recognized by the compiler ( )

	referenced but not declared, checking, `Xlist` ( )

	retrospective summary of exceptions ( )

	roundoff, with reduction operations ( )

	runtime, arguments to program ( )


S

	sampling collector ( )

	scalar, defined ( )

	SCCS
		checking in files ( )
		checking out files ( )
		creating files ( )
		creating SCCS directory ( )
		inserting keywords ( )
		putting files under SCCS ( )

	segmentation fault, due to out-of-bounds subscripts ( )

	shared library, See libraries, dynamic

	sharing I/O ( )

	shell prompts ( )

	shippable libraries ( )

	`SIGFPE` signal
		definition ( ) ( )
		when generated ( )

	signal, with explicit parallelization ( )

	source code control, See SCCS

	SPARC 64-bit environments ( )

	stack size and parallelization ( )

	`STACKSIZE` environment variable ( )

	`-stackvar` option ( )

	`standard_arithmetic()` ( )

	standard files
		error ( )
		input ( )
		output ( )
		redirection and piping ( )

	standards, conformance ( )

	statement checking, `Xlist` ( )

	static libraries, See libraries, static

	`stdio`, C-Fortran interface ( )

	stream I/O ( )

	strip-mining, degrades portability ( )

	subroutine
		compared to function ( )
		names ( )
		unused, checking, `Xlist` ( )
		used as a function, checking, `Xlist` ( )

	summing and reduction, automatic parallelization ( )

	Sun Performance Library ( )

	supported platforms ( )

	swapouts, number of ( )

	system time ( )


T

	target, specifying hardware ( )

	`tcov` ( )
		and inlining ( )
		new style, `-xprofile=tcov` option ( )

	thread stack size ( )

	`time` command ( )
		multiprocessor interpretation ( )

	time functions ( )
		summarized ( )
		VMS routines ( )

	timing program execution ( )

	trapping, exceptions with `-ftrap=`mode ( )

	troubleshooting
		program fails ( )
		results not close enough ( )

	type checking across routines, `Xlist` ( )

	typographic conventions ( )


U

	`U` option, upper/lower case ( )

	UltraSPARC-III ( )

	undeclared variables, `-u` option ( )

	underflow
		abrupt ( )
		floating-point arithmetic ( )
		gradual (IEEE) ( ) ( )
		simple ( )
		with reduction operations ( )

	underscore, in external names ( )

	uninitialized variables ( )

	unit, preconnected units ( )

	`-unroll` option ( )

	unused functions, subroutines, variables, labels, `Xlist` ( )

	uppercase, external names ( )

	user time ( )

	utilities ( )


V

	`V` option ( )

	variables
		aliased ( )
		private and shared ( )
		undeclared, checking for with `-u` ( )
		uninitialized ( )
		unused, checking, `Xlist` ( )
		used but unset, checking, `Xlist` ( )

	version checking ( )

	VMS Fortran, time functions ( )


W

	watchpoints, `dbx` ( )

	writes, number of ( )


X

	`-xalias` option ( )

	`xcode` option ( )

	`-xipo` option ( )

	`Xlist` option, global program checking ( )
		call graph, `Xlistc` ( )
		cross reference, `XlistX` ( )
		defaults ( )
		examples ( )
		suboptions ( )

	`-xmaxopt` option ( )

	`-xprofile` option ( )

	`-xtarget` option ( )


Y

	Y2K (year 2000) considerations ( )


Z

	`ztext` option ( )