Command Reference Guide

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
c
cpp(1) cpp(1)
NAME
cpp - the C language preprocessor
SYNOPSIS
/usr/ccs/lbin/cpp [option ...] [ifile [ofile]]
DESCRIPTION
cpp is the C language preprocessor which is invoked as the first pass of any C compilation using the cc
command (see cc(1)). Its purpose is to process #include and conditional compilation instructions and
macros. Thus the output of cpp is designed to be in a form acceptable as input to the next pass of the C
compiler. As the C language evolves, cpp and the rest of the C compilation package will be modified to fol-
low these changes. Therefore, the use of cpp in other than this framework is not suggested. The pre-
ferred way to invoke cpp is through the cc command, since the functionality of cpp may someday be
moved elsewhere. See m4(1) for a general macro processor.
cpp optionally accepts two file names as arguments. ifile and ofile are respectively the input and output
for the preprocessor. They default to standard input and standard output if not specified.
Options
The following options are recognized by cpp:
-A Remove all predefined symbols that begin with a letter and _HPUX_SOURCE. The user is
expected to define
_POSIX_SOURCE
or _XOPEN_SOURCE when using this option.
-C By default, cpp strips C-style comments. If the -C option is specified, all comments
(except those found on cpp directive lines) are passed along.
-Dname
-Dname=def Define name as if by a #define directive. If no =def is given, name is defined as
1. The
-D option has lower precedence than the -U option. Thus, if the same name is used in
both a -U option and a -D option, the name is undefined regardless of the order of the
options.
-Hnnn Change the internal macro definition table to be nnn bytes in size. The default buffer size
is at least 8188 bytes. This option serves to eliminate ‘‘Macro param too large’’, ‘‘Macro
invocation too large’’, ‘‘Macro param too large after substitution’’, ‘‘Quoted macro param too
large’’, ‘‘Macro buffer too small’’, ‘‘Input line too long’’, and ‘‘Catenated input line too long’’
errors.
-h[inclfile] Generates included files and sents the results to the file inclfile. If the argument inclfile is
omitted, the result is sent to the standard error.
-Idir Change the algorithm for searching for #include files whose names do not begin with
/
to look in dir before looking in the directories on the standard list. Thus, #include files
whose names are enclosed in double quotes ("") are searched for first in the directory of
the file containing the
#include line, then in directories named in -I options in left-to-
right order, and last in directories on a standard list. For #include files whose names
are enclosed in angle brackets (<>), the directory of the file containing the #include line
is not searched. However, directory dir is still searched.
-M[makefile] Generates makefile dependencies and sends the results to the file makefile. If the argu-
ment makefile is omitted, the result is sent to the standard error.
-P Preprocess the input without producing the line-control information used by the next pass
of the C compiler.
-T HP-UX no longer restricts preprocessor symbols to eight characters. The -T option forces
cpp to use only the first eight characters for distinguishing different preprocessor names.
This behavior is the same as preprocessors on some other systems with respect to the
length of names, and is included for backward compatibility.
-Uname Remove any initial definition of name, where name is a reserved symbol that is predefined
by the particular preprocessor. The current list of these symbols includes:
Operating system: unix _ _unix
Hardware: hp9000s200 hp9000s300 _ _hp9000s300
hp9000s500 hp9000s800 _ _hp9000s800
hp9000ipc hppa _ _hppa
HP-UX Release 11i: December 2000 − 1 − Section 1−−121
___
___