NAME

f77 − Fortran 77 compiler

SYNOPSIS

f77 [ −c ] [ −g ] [ −w ] [ −p ] [ −pg ] [ −O ] [ −S ] [ −o output ] [ −onetrip ] [ −u ] [ −C ]

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

DESCRIPTION

F77 is the UNIX Fortran 77 compiler.  It accepts several types of arguments:

Arguments whose names end with ‘.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’. 

Arguments whose names end with ‘.r’ are taken to be Ratfor source programs; these are first transformed by the appropriate preprocessor, then compiled by f77. 

In the same way, arguments whose names end with ‘.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 Have the compler 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 Causes the compiler to produce counting code in the manner of −p, but invokes 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.  Not yet avaiable on Sun. 

−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’. 

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 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. The compiler will complain if it overflows its tables and suggest 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 (e.g. 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 with name ‘a.out’. 

FILES

file.[fFrsc]input file
file.oobject file
a.outloaded output
/usr/lib/f77pass1compiler
/lib/f1pass 2
/lib/c2optional optimizer
/lib/cppC preprocessor
/usr/lib/libF77.aintrinsic function library
/usr/lib/libI77.aFortran I/O library
/usr/lib/libU77.aUNIX interface library
/usr/lib/libF77_p.a profiling intrinsic function library
/usr/lib/libI77_p.aprofiling Fortran I/O library
/usr/lib/libU77_p.a profiling UNIX interface 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

S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler
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 System Release 1.0  —  1 November 1983