NAME

f77 − FORTRAN-77 compiler

SYNOPSIS

f77 [ −c ] [ −g ] [ −w ] [ −p ] [ −pg ] [ −O ] [ −S ] [ −R ] [ −fsky ] [ −o output ] [ −onetrip ]

[ −u ] [ −C ] [ −F ] [ −m ] [ −Rx ] [ −N[qxscn]nnn ] file ...

DESCRIPTION

F77 is the UNIX FORTRAN-77 compiler for translating programs written in the FORTRAN-77 programming language into executable load modules or relocatable binary programs for subsequent loading via the ld(1) linker.  In addition to the many flag arguments (options), f77 accepts several types of files:

Filenames ending in .f are taken to be FORTRAN-77 source programs; they are compiled, and each object program is left in the file in the current directory whose name is that of the source with .o substituted for .f.  Filenames ending in .F are also taken to be FORTRAN-77 source programs, but they are preprocessed by the C preprocessor (equivalent to a cc −E) before they are compiled by the f77 compiler. 

Filenames ending in .r are taken to be Ratfor source programs; these are first transformed by the appropriate preprocessor, then compiled by f77.

In the same way, filenames ending in .c or .s are taken to be C or assembly source programs and are compiled or assembled, producing a .o file. 

OPTIONS

The following options have the same meaning as in cc(1). See ld(1) for load-time options.

−c Suppress loading and produce .o files for each source file. 

−g Produce additional symbol table information for dbx(1). Also pass the −lg flag to ld(1).

−w Suppress all warning messages.  If the option is −w66, only FORTRAN-66 compatibility warnings are suppressed. 

−Dname=def

−Dname
Define the name to the C preprocessor, as if by ‘#define’.  If no definition is given, the name is defined as "1". ( .F suffix files only). 

−Idir ‘#include’ files whose names do not begin with ‘/’ are always sought first in the directory of the file argument, then in directories named in −I options, then in directories on a standard list. ( .F suffix files only). 

−p Prepare object files for profiling, see prof(1).

−pg Produce counting code in the manner of −p, but invoke a run-time recording mechanism that keeps more extensive statistics and produces a gmon.out file at normal termination.  An execution profile can then be generated by use of gprof(1).

−O Optimize the object-code. 

−S Compile the named programs, and leave the assembler-language output on corresponding files suffixed .s (no .o file is created). 

−o output
Name the final output file output instead of a.out. 

−fsky Generate code which assumes the presence of a SKY floating-point processor board.  Programs compiled with this option can only be run in systems that have a SKY board installed.  Programs compiled without the −fsky option will use the SKY board, but won’t run as fast as they would if the −fsky option were used.  If any part of a program is compiled using the −fsky option, you must also use this option when linking with the f77 command, since a different set of startup routines is used. 

The following options are peculiar to f77:

−i2 On machines which support short integers, make the default integer constants and variables short.  (−i4 is the standard value of this option).  All logical quantities will be short. 

−m Apply the M4 preprocessor to each .r file before transforming it with the Ratfor preprocessor. 

−onetrip
Compile DO loops that are performed at least once if reached. FORTRAN-77 DO loops are not performed at all if the upper limit is smaller than the lower limit. 

−u Make the default type of a variable ‘undefined’ rather than using the default FORTRAN rules. 

−v Print the version number of the compiler, and the name of each pass as it executes. 

−C Compile code to check that subscripts are within declared array bounds. 

−F Apply the C or Ratfor preprocessor to relevant files, put the result in the file with the suffix changed to .f, but do not compile. 

−Rx Use the string x as a Ratfor option in processing .r files. 

−N[qxscn]nnn
Make static tables in the compiler bigger. F77 complains if tables overflow and suggests you apply one or more of these flags.  These flags have the following meanings:

q Maximum number of equivalenced variables.  Default is 150. 

x Maximum number of external names (common block names, subroutine and function names).  Default is 200. 

s Maximum number of statement numbers.  Default is 401. 

c Maximum depth of nesting for control statements (for example, DO loops).  Default is 20. 

n Maximum number of identifiers.  Default is 1009. 

−U Do not convert upper case letters to lower case.  The default is to convert FORTRAN programs to lower case except within character string constants. 

Other arguments are taken to be either loader option arguments, or F77-compatible object programs, typically produced by an earlier run, or perhaps libraries of F77-compatible routines.  These programs, together with the results of any compilations specified, are loaded (in the order given) to produce an executable program called a.out.

FILES

file.[fFrsc]input file
file.oobject file
a.outloaded output
./fort[pid].?temporary
/usr/lib/f77pass1compiler
/lib/f1pass 2
/lib/c2optional optimizer
/lib/cppC preprocessor
/usr/lib/libf77.aFortran library
/lib/libc.aC library, see section 3
mon.outfile produced for analysis by prof(1).
gmon.outfile produced for analysis by gprof(1).

SEE ALSO

FORTRAN Programmer’s Guide for the Sun Workstation.
prof(1), gprof(1), cc(1), ld(1), ratfor(1)

DIAGNOSTICS

The diagnostics produced by f77 itself are intended to be self-explanatory.  Occasional messages may be produced by the loader. 

BUGS

The FORTRAN-66 subset of the language has been exercised extensively; the newer features have not. 

Sun Release 1.1  —  Last change: 6 March 1984