xref: /original-bsd/usr.bin/f77/f77.vax/f77.1 (revision 18f6d767)
Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)f77.1 6.1 (Berkeley) 04/29/85

F77 1 ""
C 4
NAME
f77 - Fortran 77 compiler
SYNOPSIS
f77 [ option ] ... 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 on the file in the current directory whose name is that of the source with `.o' substituted for '.f'.

Arguments whose names end with `.F' are also taken to be Fortran 77 source programs; these are first processed by the C preprocessor before being compiled by f77.

Arguments whose names end with `.r' or `.e' are taken to be Ratfor or EFL source programs respectively; these are first transformed by the appropriate preprocessor, then compiled by f77.

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.

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 compiler produce additional symbol table information for dbx (1). Also pass the -lg flag to ld (1).

-o " output" Name the final output file output instead of `a.out'.

-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).

-w Suppress all warning messages. If the option is `-w66', only Fortran 66 compatibility warnings are suppressed.

-D name=def

-D name 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).

-I dir `#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).

-O Invoke an object-code optimizer.

-S Compile the named programs, and leave the assembler-language output on corresponding files suffixed `.s'. (No `.o' is created.).

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.

-q Suppress printing of file names and program unit names during compilation.

-m Apply the M4 preprocessor to each `.r' file before transforming it with the Ratfor or EFL 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, EFL, or Ratfor preprocessors to relevant files, put the result in the file with the suffix changed to `.f', but do not compile.

-E x Use the string x as an EFL option in processing `.e' files.

-R x 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.[fFresc] input file
file.o object file
a.out loaded output
./fort[pid].? temporary
/usr/lib/f77pass1 compiler
/lib/f1 pass 2
/lib/c2 optional optimizer
/lib/cpp C preprocessor
/usr/lib/libF77.a intrinsic function library
/usr/lib/libI77.a Fortran I/O library
/usr/lib/libU77.a UNIX interface library
/usr/lib/libF77_p.a profiling intrinsic function library
/usr/lib/libI77_p.a profiling Fortran I/O library
/usr/lib/libU77_p.a profiling UNIX interface library
/lib/libc.a C library, see section 3
mon.out file produced for analysis by prof(1).
gmon.out file produced for analysis by gprof(1).
"SEE ALSO"
S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler

D. L. Wasley, Introduction to the f77 I/O Library

prof(1), gprof(1), cc(1), ld(1), efl(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
Formats in format statements are translated by the compiler; formats in I/O statements are translated during execution by the I/O library.