cc_bundled(1)cc_bundled(1)NAME
cc_bundled: cc - bundled C compiler
SYNOPSIS
[options] files
DESCRIPTION
invokes the HP-UX bundled compiler. C source code is compiled directly
to object code.
The command uses the (Itanium(R)-based systems) or (PA-RISC, Precision
Architecture) compiler for preprocessing, syntax and type checking, as
well as for code generation.
accepts several types of arguments as files:
Arguments whose names end with
are understood to be C source files. Each file is compiled
and the resulting object file is left in a file having the
corresponding base name, but suffixed with instead of How‐
ever, if a single C source file is compiled and linked all
in one step, the file is deleted.
Arguments whose names end with
are understood to be assembly source files and are assem‐
bled, producing a file for each file.
Arguments whose names end with
are taken to be preprocessed source files. (See the option
below.) Each object file is left in a file having the cor‐
responding name, but suffixed with instead of the suffix.
Arguments of the form
cause the linker to search the library (Itanium-based sys‐
tems) or (PA-RISC) or in an attempt to resolve currently
unresolved external references. Because a library is
searched when its name is encountered, placement of a is
significant. If a file contains an unresolved external
reference, the library containing the definition must be
placed after the file on the command line. See ld(1) for
further details.
Arguments of the form
cause the linker to search the library (Itanium-based sys‐
tems) or (PA-RISC) or (depending on suffix) in an attempt
to resolve currently unresolved external references. It is
similar to the option except the current state of the
option is not important.
Other Suffixes
All other arguments, such as those names ending with or are
taken to be relocatable object files and are passed to (see
ld(1)) to be included in the link operation.
Arguments and options can be passed to the compiler through the envi‐
ronment variable as well as on the command line. The compiler reads
the value of and divides these options into two sets; those options
which appear before a vertical bar delimited by whitespace, and those
options which appear after the vertical bar. The first set of options
is placed before any of the command-line parameters to the second set
of options is placed after the command-line parameters to If the verti‐
cal bar is not present, all options are placed before the command-line
parameters. For example (in sh(1) notation),
is equivalent to
When set, the environment variable specifies a directory to be used by
the compiler for temporary files, overriding the default directory
Options
for more information about any option, see the To invoke the online
help, use your HTML browser to use the URL (Itanium-based systems) or
(PA-RISC).
The following options are recognized by
Suppress the link edit phase of the compilation,
and force an object file to be produced for each or file
even if only one program is compiled. Object files pro‐
duced from C programs must be linked before being exe‐
cuted.
Define name to the preprocessor pass, as if by
'#define'.
Preprocess named C files and send the result to standard output.
Change the algorithm used by the preprocessor pass for
finding include files to also search in directory
dir. See the HP C Online Help.
The directory of the including file is no longer used as
the starting point to look up files enclosed with
double quotes They start at the first Files
enclosed with are looked up with the paths fol‐
lowing
Refer to the and explanations (fourth and fifth items) in the
section.
Change the algorithm used by the linker to search for
(Itanium-based systems) or (PA-RISC) or The
option causes ld to search in dir before search‐
ing in the default locations. This option is
effective only if it precedes the option on the
command line. See ld(1) for details.
Specify outfile as the name for the linker output file.
The default name is Specifies the name of the
object file when used with
Preprocess named C files and leave the result in correspond‐
ing files suffixed with
Cause the output of the linker to be stripped of symbol table
information. See strip(1) for more details. The
use of this option prevents the use of a symbolic
debugger on the resulting program. Also see
ld(1) for additional details.
If is specified with any other option, the option
is ignored, regardless of the order in which the
options were specified.
Compile the named C files, and leave the
assembly language output in corresponding files
suffixed with
Substitute or insert subprocess
x with name where x is one or more of a set of
identifiers indicating the subprocess(es). This
option works in two modes: 1) if x is a single
identifier, name represents the full path name of
the new subprocess; 2) if x is a set of identi‐
fiers, name represents a prefix to which the
standard suffixes are concatenated to construct
the full path names of the new subprocesses.
The x can take one or more of the values:
Assembler; standard suffix is
Compiler body; standard suffix is:
(Itanium-based systems), or
(PA-RISC)
Linker; standard suffix is
C preprocessor; standard suffix is
All subprocesses.
Undefines any name that has been defined prior to the prepro‐
cessing stage of compilation.
Enable verbose mode, which produces a step-by-step description
of the compilation process on standard error.
Display the version numbers of the current compiler and linker
(if
the linker is executed).
Suppress warning messages.
Pass the comma-separated argument(s)
to subprocess x, where x can assume one of the
values listed under the option as well as (driver
program) but not (all subprocesses). The option
specification allows additional, implementation-
specific options to be recognized by the compiler
driver.
Itanium-based Systems Only Options
Instead of using standard output for the
option, place the output from each file into a
file with the corresponding .suffix.
Do not bind anything to address zero.
This ld(1) option allows run-time detection of
null pointers. See the note on pointers below.
(Itanium-based system only)
Generate subprocess information for a given command line without
running the subprocesses. (Itanium-based systems
only)
This option outputs the double quoted ("") enclosed include file
dependency
information in the format for make(1). With the
output goes to stdout. With the output goes to a
file with the suffix The directory and prefix of
this file is the same as the object file, which
can be affected by the option.
NOTE: Specify to suppress generation of the
object file. In this case, no preprocessor out‐
put is generated. (Itanium-based systems only).
Same as except both and enclosed include files are output
as dependencies. (Itanium-based systems only).
Disallow all anachronistic constructs. Ordinarily the
compiler gives warnings about anachronistic con‐
structs; using the option, the compiler will not
compile code containing anachronistic constructs.
(Itanium-based systems only).
Generate separate timing information for compilation subpro‐
cesses.
For each subprocess, estimated time is generated
in seconds for user processes, system calls, and
total processing time. (Itanium-based systems
only).
Treats "plain" char data type as unsigned char.
(Overloading and mangling are unchanged.) This
option is to help in porting applications from
environments where unqualified (plain) char type
is treated as unsigned char instead of the
default treatment as signed char. Since all
unqualified char types in the compilation unit
will be affected by this option (including those
headers that define external and system inter‐
faces) it is necessary to compile the interfaces
used in a single program uniformly.
Warn about all questionable constructs. Without the
option, the compiler issues warnings only about
constructs that are almost certainly problems
(Itanium-based systems only).
Selectively suppresses any specified warning messages, where
arg1 through argn are valid compiler warning mes‐
sage numbers. (Itanium-based systems only).
Selectively interpret any specified warning or future error mes‐
sages as errors.
arg1 through argn are valid compiler message num‐
bers. (Itanium-based systems only).
System Dependent Options
The compiler supports the following additional operating system
dependent options.
Generate code using either the
ILP32 or LP64 data model. Defined values for data_model
are:
Use the ILP32 data model. The sizes of the int, long and
pointer data
types are 32-bits.
Use the LP64 data model. The size of the int data type
is 32-bits, and
the sizes of the long and pointer data types are
64-bits. Defines __LP64__ to the preprocessor.
Use the instruction scheduler tuned to the
model specified. If this option is not used, the com‐
piler uses the instruction scheduler for the architecture
on which the program is compiled.
Options (other)
Any other options that are not defined will generate a warning
to standard error.
Other arguments are taken to be HP C compatible object files,
typically produced by an earlier run, or perhaps libraries of HP
cc compatible routines. These files, together with the results
of any compilations specified, are linked (in the order given)
to produce an executable program with the name
Pointers
Accessing the object of a NULL (zero) pointer is technically
illegal, but many systems have permitted it in the past. The
following is provided to maximize portability of code. If the
hardware is able to return zero for reads of location zero (when
accessing at least 8- and 16-bit quantities), it must do so
unless the flag is present. The flag requests that be generated
if an access to location zero is attempted. Writes of location
zero may be detected as errors even if reads are not. If the
hardware cannot assure that location zero acts as if it was ini‐
tialized to zero or is locked at zero, the hardware should act
as if the flag is always set.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If is not specified in the environment or is set to the empty
string, the value of is used as a default for each unspecified
or empty variable. If is not specified or is set to the empty
string, a default of (see lang(5)) is used instead of If any
internationalization variable contains an invalid setting,
behaves as if all internationalization variables are set to See
environ(5).
allows you to set the maximum number of errors you want the com‐
piler to report before it terminates compilation. (Itanium-
based systems only).
is used as a prefix for all references to tool set components
and must be set when you use a non-native development kit or a
toolset installed at an alternative location. Some of the
toolset components are compiler drivers, Compiler Applications,
Preprocessor, Linker, and object file tools.
is used as a prefix for all references to target set components
and must also be set when using a non-native development kit.
Some of the target set components are header files, archive
libraries, and shared libraries.
International Code Set Support
Single byte and multibyte character code sets are supported.
DIAGNOSTICS
The diagnostics produced by the compiler itself are intended to
be self-explanatory. Occasional messages may be produced by the
assembler or the link editor.
If any errors occur before is completed, a non-zero value is
returned. Otherwise, zero is returned.
DEPENDENCIES
If is specified along with any of the above options, the option
is ignored, regardless of the order in which the options were
specified.
Refer to the System Dependent Options subsection above for
information about operating system dependent options, for 32-bit
or 64-bit data models and for the instruction scheduler.
FILES
C input file
previously preprocessed cc input file
object file
shared library, created with
on Itanium-based systems
shared library, created with
on PA-RISC
linked executable output file
temporary files used by the compiler
(Itanium-based systems)
temporary files used by the compiler
(PA-RISC systems) C driver
C driver
C Compiler (Itanium-based systems)
C Compiler
(PA-RISC systems)
preprocessor, to assemble
files C compiler message catalog (Itanium-based systems)
C compiler message catalog
(PA-RISC systems) assembler, as(1)
link editor,
ld(1)
Runtime startup
(PA-RISC systems)
Standard directory for
files
Other Libraries
standard C library, see HP-UX Reference Section (3). (Itanium-
based systems)
standard C library, see
HP-UX Reference Section (3). (Itanium-based systems)
Standard C library (archive version), see
HP-UX Reference Section (3). (PA-RISC)
Standard C library (shared version), see
HP-UX Reference Section (3). (PA-RISC)
Math Library
(Itanium-based system)
Math Library
(Itanium-based systems)
Math Library
(PA-RISC systems)
Dynamic loader library
(Itanium-based systems)
Dynamic loader library
(Itanium-based systems)
Dynamic loader library
(PA-RISC systems)
Dynamic loader
(Itanium-based systems)
Dynamic loader
(Itanium-based systems)
Dynamic loader
(PA-RISC systems)
SEE ALSO
Online help
The online help can be displayed using a default HTML browser,
or you can invoke your own HTML browser with the URL (Itanium-
based systems) or (PA-RISC systems)
Other topics available are: Compiler Pragmas, Floating Installa‐
tion and Implementation Defined aspects of the compiler.
Information is also available on the web at:
Profiling and Debugging Tools
gprof(1) display call graph profile data
monitor(3C) prepare execution profile
wdb(1) C, C++ and Fortran symbolic debugger
gdb(1) C, C++ and Fortran symbolic debugger
adb(1) absolute debugger
System Tools
as(1) translate assembly code to machine code
cpp(1) invoke the C language preprocessor
cc(1) C compiler
ld(1) invoke the link editor
Miscellaneous
strip(1) strip symbol and line number information from an
object file
crt0(3) execution startup routine
end(3C) symbol of the last locations in program
exit(2) termination of a process
Tutorials and Standards Documents
American National Standard for Information Systems - Programming
language C, ANS X3.159-1989.
See the HP C Online help.
Bundled C Compiler - Limited Functionality cc_bundled(1)