man(1) Manual page archive


     CPP(8)                                                     CPP(8)

     NAME
          cpp - C language preprocessor

     SYNOPSIS
          /lib/cpp [ option ... ] [ ifile [ ofile ] ]

     DESCRIPTION
          Cpp interprets preprocessor directives and does macro sub-
          stitution for cc(1) and other compilers.  The input ifile
          and output ofile default to standard input and standard out-
          put respectively.

          The options are:

          -P   Do not place line number markings in output.

          -C   Do not remove comments.

          -Uname
          -Dname
          -Dname=def
          -Idir
               Same as in cc(1). -U overrides -D.

          -H   Report all included files on standard error file,.

          -M   Attach modification date to file names in line number
               directives thus: file@modtime, where modtime is the
               integer number of seconds since the epoch.

          -T   Truncate preprocessor symbols to eight characters.

          -Ydir
               Use dir instead of as the last resort in searching for
               include files.

          The output file contains processed text sprinkled with lines
          that show the original input line numbering:

               # linenumber "ifile"

          The input language is as described in the reference, with a
          few additions:

          The # linenumber marks placed in the output are accepted as
          an alternative to the official #line directive.

          These symbols are predefined in various implementations:

               ibm gcos os tss unix

     CPP(8)                                                     CPP(8)

               interdata pdp11 u370 u3b u3b5 vax
               RES RT
               lint

          Preprocessor formal parameters are recognized within quoted
          strings in the replacement text.

          When comments are removed they are replaced by null strings;
          this unofficial feature makes it possible to construct iden-
          tifiers by concatenation.

     FILES
          standard directory for include files

     SEE ALSO
          B. W. Kernighan and D. M. Ritchie, The C Programming
          Language, Prentice-Hall, 1988