intro(3) [v7 man page]

INTRO(3)						     Library Functions Manual							  INTRO(3)

NAME

       intro - introduction to library functions

SYNOPSIS

       #include <stdio.h>

       #include <math.h>

DESCRIPTION

       This section describes functions that may be found in various libraries, other than those functions that directly invoke UNIX system primi-
       tives, which are described in section 2.  Functions are divided into various libraries distinguished by the section number at  the  top	of
       the page:

       (3)   These  functions,	together  with those of section 2 and those marked (3S), constitute library libc, which is automatically loaded by
	     the C compiler cc(1) and the Fortran compiler f77(1).  The link editor ld(1) searches this library under the `-lc' option.   Declara-
	     tions for some of these functions may be obtained from include files indicated on the appropriate pages.

       (3M)  These functions constitute the math library, libm.  They are automatically loaded as needed by the Fortran compiler f77(1).  The link
	     editor searches this library under the `-lm' option.  Declarations for  these  functions  may  be	obtained  from	the  include  file
	     <math.h>.

       (3S)  These  functions  constitute  the	`standard  I/O package', see stdio(3).	These functions are in the library libc already mentioned.
	     Declarations for these functions may be obtained from the include file <stdio.h>.

       (3X)  Various specialized libraries have not been given distinctive captions.  The files in which these libraries are found  are  named	on
	     the appropriate pages.

FILES

       /lib/libc.a
       /lib/libm.a, /usr/lib/libm.a (one or the other)

SEE ALSO

       stdio(3), nm(1), ld(1), cc(1), f77(1), intro(2)

DIAGNOSTICS

       Functions  in the math library (3M) may return conventional values when the function is undefined for the given arguments or when the value
       is not representable.  In these cases the external variable errno (see intro(2)) is set to the value EDOM or ERANGE.  The  values  of  EDOM
       and ERANGE are defined in the include file <math.h>.

ASSEMBLER

       In assembly language these functions may be accessed by simulating the C calling sequence.  For example, ecvt(3) might be called this way:

	      setd
	      mov  $sign,-(sp)
	      mov  $decpt,-(sp)
	      mov  ndigit,-(sp)
	      movf value,-(sp)
	      jsr  pc,_ecvt
	      add  $14.,sp

																	  INTRO(3)

F77(1)							      General Commands Manual							    F77(1)

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

       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.

       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.

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

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

       -f     Use a floating point interpreter (for PDP11's that lack 11/70-style floating point).

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

       The following options are peculiar to f77.

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

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

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

       -F     Apply EFL and Ratfor preprocessor to relevant files, put the result in the file with the suffix changed to `.f', but do not compile.

       -m     Apply the M4 preprocessor to each `.r' or `.e' file before transforming it with the Ratfor or EFL preprocessor.

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

       -Rx    Use the string x as a Ratfor option in processing `.r' files.

       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.[fresc]	 input file
       file.o		 object file
       a.out		 loaded output
       /usr/lib/f77pass1 compiler
       /lib/c1		 pass 2
       /lib/c2		 optional optimizer
       /usr/lib/libF77.a intrinsic function library
       /usr/lib/libI77.a Fortran I/O library
       /lib/libc.a	 C library, see section 3

SEE ALSO

       S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler
       prof(1), cc(1), ld(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.

																	    F77(1)