cc_bundled(1) General Commands Manual 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 corre-
sponding base name, but suffixed with instead of However, 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 assembled, 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 correspond-
ing name, but suffixed with instead of the suffix.
Arguments of the form
cause the linker to search the library (Itanium-based systems) 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 systems) 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 environment 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 vertical bar is not present, all options are placed before the com-
mand-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 produced from C
programs must be linked before being executed.
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 following
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 searching 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 corresponding 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 result-
ing 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 identifiers,
name represents a prefix to which the standard suffixes are concatenated to construct the full path names of the new subpro-
cesses.
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 preprocessing 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 sub-
processes). 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 output 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 constructs; using the option, the compiler will not compile code containing
anachronistic constructs. (Itanium-based systems only).
Generate separate timing information for compilation subprocesses.
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 unquali-
fied (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
interfaces) 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 message numbers. (Itanium-based systems only).
Selectively interpret any specified warning or future error messages as errors.
arg1 through argn are valid compiler message numbers. (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 compiler 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 compati-
ble routines. These files, together with the results of any compilations specified, are linked (in the order given) to produce an exe-
cutable 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 initialized 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 vari-
able. If is not specified or is set to the empty string, a default of (see lang(5)) is used instead of If any internationalization vari-
able 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 compiler 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 Installation 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)