KAI C++ Man Page for Generic KCC

Man Page for Generic KCC

User's Guide

	Man Page for Generic KCC
User's Guide

Rating Option Summary

--diag_suppress <n1,n2,...>

Suppress diagnostic messages with numbers n1,n2,... Use --display_error_number to find out the value of n1,n2,...

--display_error_number

Display the number for a message along with diagnostic messages. Useful in conjunction with the --diag_suppress option.

--link_command_prefix foo

Prefix link command with foo. This is useful for memory checkers such as Purify and Sentinel that must control the link step.

--output_dependencies file

Cause dependencies suitable for make(1) to be written to file. Unlike -M, compilation also occurs.

--parallel_build n

Fork up to n processes to handle compilation. Parallel compilation occurs only when there is more than one source file on the command line. In some earlier versions, this flag also controlled recompilations requested by the automatic template instantiation process. This is no longer true, but expect shorter automatic template instantiation delays anyway because of an improved algorithm.

--pch_create file

Specify precompiled header to create for use by --use_pch option.

--pch_dir directory

Specifies directory for precompiled headers.

--use_pch file

Specify precompiled header to use when manually creating such with --pch_create.

-Bstatic

Cause linker to prefer archive over shared library if it finds both.

-o file

Name the output file or the executable file. The output file may be an object file (.o), archive (.a), shared library (.so or .sl), or executable. DO NOT use other UNIX commands (such as mv) to rename object files that need template instantiations.

--[no_]abstract_float

Treat floating-point numbers as abstract types. This may improve optimization.

- -[no_]abstract_pointer

Treat pointers as abstract types. This may improve optimization.

-Bdynamic

Cause linker to prefer shared library over archive if it finds both.

--backend option

Pass option to backend C compiler. This is for advanced users who want to pass obscure options to the backend C compiler.

-c

Suppress the loading phase of the compilation process and force an object file with the .o extension to be produced.

--c

Treat input file as ANSI C.

--c++

Treat input file as C++. This is the default.

cfront_2.1

cfront_3.0

Use antiquated Cfront rules. This option may break some KAI C++ header files, as the modern ISO draft library depends upon draft-ISO rules.

--no_code_gen

Check syntax, but do not generate an object file (or intermediate .int.c file).

--component_time

Issue a summary of the seconds of CPU time required for the major compilation steps. Some of the steps may always take zero time on some platforms. Below are the steps timed:

Front end Parsing, optimization and lowering to C

Code generation Generating an object file from intermediate C

Prelink Template instantiation

Link Creation of an executable or library

Static init Handling of static initialized objects

--cpfe_only

Run the front-end of the compiler only, producing an intermediate C source file which has the .int.c extension. Suppress the back-end and the linker phases of the compilation process.

-E

Preprocess the input file and stop. The output is written to stdout.

--[no_]exceptions

Enable or disable exception handling. The default is enabled.

--[no_]explicit

Enable or disable support for the C++ keyword explicit.

-g*

Set -g option for backend C compiler. Use +K0 instead for generating debug-able executables, as just setting -g does not turn off front-end optimizations.

--[no_]implicit_include

Enable or disable implicit inclusion for templates. The default is --no_implicit_include.

--inline_auto_space_time=r

--inline_generated_space_time=r

--inline_implicit_space_time=r

--inline_keyword_space_time=r

Control the increase in code size resulting from inlining functions.

+K[0123]

Set high-level optimization level. The high-level optimizer performs platform-independent object-level optimizations. The levels are:

+K0 Turn off all high-level optimizations and set -g. Use this level for debugging.

+K1 Enable inlining.

+K2 Enable lightweight object optimizations (and +K1 features).

+K3 Enable branch simplification (and +K2 features).

--keep_gen_c

Retain intermediate C source file after compilation. The file has the .int.c extension.

-Lpath

Add path to search path for libraries.

-M

Generate dependence information for make. Unlike --output_dependencies, compilation does not occur.

--max_pending_instantiations n

Set limits on the number of pending instantiations to n. The default is 17, which is the limit specified by standard. Some programming techniques such as "template expressions" require a higher limit. The error message, "error: excessive recursion at instantiation of " and you have ascertained that the recursion is not infinite, you should set a higher pending instantiation limit.

-On

-O

Set low-level optimization level. The levels are whatever are supported by the platform's C compiler. The default is a level appropriate for the +K[0123] setting.

--old_c

Treat the input file as K&R C.

-G

--one_instantiation_per_object

--one_per

Cause each template instance to be assigned to a separate .o file. This option should be used when compiling .o files that might be put in archives. The form --one_per is simply an abbreviated spelling.

--pch

Create and/or use precompiled headers.

--[no_]pch_messages

Enable or disable messages concerning precompiled headers. The default is to enable the messages.

-PG

--restrict

Allow keyword restrict. This may improve optimization.

--signed_chars

--unsigned_chars

Select whether a variable of type char is treated as signed char or unsigned char. The default is unsigned char.

--soname identifier

Causes identifier to be used for the library name when LD_LIBRARY_PATH is searched.

--no_standard_includes

Do not add the standard include directories to the include search path.

--strict

Enforce strict adherence to approximation of ISO draft language implemented by KAI C++. This option affects only chapters 1-16 of the draft. To enforce strict adherence to the ISO draft library (chapters 17-27) use -D__KAI_STRICT.

--suppress_c_to_obj_diagnostics

Suppress diagnostics from the C compiler used for code generation.

--thread_safe

Make resulting code thread-safe. To guarantee thread safety, this option must be used when compiling .o files and linking.

-v

Show compilation steps as they occur.

--version

Print compilation component version information.

-w

Disables compilation warning messages generated by the KAI C++ front-end

Technical Support