Printed 11/19/92                   Page 1

CFE(1)              RISC/os Reference Manual               CFE(1)



NAME
     cfe - MIPS Preprocessor and C Front-end

SYNOPSIS
     cfe [ option ] ... file ...

DESCRIPTION
     cfe, the MIPS ANSI compliant Preprocessor and C Front-end.

OPTIONS
     -std0
          The compiler enforces traditional mode, also called K&R
          mode with a few ANSI extensions. This mode is backward
          compatible with the MIPS C compiler prior to upgrading
          it to comply with ANSI C standard. This mode is similar
          to, but not the same as AT&T's -Xt mode and GNU's
          -traditional mode. -Xt mode sets __STDC__=0 and allows
          '##' operator.

     -std1
          The compiler enforces strict ANSI mode, where only ANSI
          compliant code is acceptable. This mode is similar to,
          but not the same as,  AT&T's -Xc mode and GNU's -pedan-
          tic mode.  -std The compiler enforces ANSI mode, but
          allows popular extensions. This mode is similar to
          AT&T's -Xa mode and GNU's -ansi mode. This is the
          default.

     -Xdpn
          Display parse tree if n is >0, otherwise don't display
          tree.

     -Xdsn
          display semantic tree if n is >0, otherwise don't
          display tree.  -Xdsn and -Xdcn are mutually exclusive.

     -Xdcn
          display code generation tree if n is >0, otherwise
          don't display tree.  -Xdsn and -Xdcn are mutually
          exclusive.

     -Xdyn
          Yacc debugging, where n is the debug level number.

     -Xdmn
          Memory handler debugging, where n is the debug level
          number.

     -Xden
          Error handler debugging, where n is the debug level
          number.




                        Printed 11/19/92                   Page 1

CFE(1)              RISC/os Reference Manual               CFE(1)



     -Xdhn
          Display hash table statistics if n is >0, otherwise
          don't.

     -XdPn
          Parser symbol debugging, where n is >0.

     -XdSn
          Syntax Analysis only, where n is >0.

     -Tn  Increase(larger n) or decrease tree size treshhold.
          Default 50.

     -XdUn
          disable or debug code generation.  If n==1 or n is
          missing (-XdU), it disables code generation.  With
          -XdU3, it turns on some debugging output.  Code genera-
          tion is enabled by default.

     -Xdln
          do layout if n > 0  (temporary)

     -Xdmn
          do mips_st if n > 0 (temporary)

     -XdEn
          debug declaration semantics if n > 0

     -XdTn
          debug instance table if n > 0

     -Xfloat
          Cause the compiler to never promote expressions of type
          float to type double ,including within function calls.

     -nestlevel=n
          Set the limit of nesting levels for #included files,
          default 50.

     -oldcomment
          Treat comment in old way by preprocessor, replace with
          nothing.

     -verbose
          Print long form of error message.

     -signed
          Cause all char declarations to be signed char declara-
          tions, the default is to treat them as unsigned char
          declarations.

     -checkbounds



 Page 2                 Printed 11/19/92

CFE(1)              RISC/os Reference Manual               CFE(1)



          Generate code for runtime subscript range checking.
          The default suppresses range checking.

     -checkstack <size>
          The purpose of stack checking is to make sure that one
          thread does not randomly go outside its allocated stack
          area. -checkstack checks that stack allocations, either
          stack frames or alloca's, greater than <size> do not
          exceed their stack limits. <size> is usually a page
          size.

     -cplus
          Puts the front-end in C++ mode.

     -Zpn align structure members on alignment specified by the
          integer n.

     -saveargs
          causes argument registers to saved upon function entry.
          By default they are not saved.

     -proto[is]
          extract prototype declarations for function definitions
          into a .H suffixed file. The option i is to include
          identifiers in the prototype, and the option s is to
          generate prototypes for static functions as well.

DIAGNOSTICS
EXIT VALUES
     0 for normal exit

     1 for CPP error exit

     2 reserved for LINT error exit

     3 for cfe error exit

FILES
SEE ALSO
     cc(1), cpp(1)

BUGS










                        Printed 11/19/92                   Page 3