4 KAP Command Switches

This chapter describes KAP for C command switches that allow you to alter KAP defaults.

You will frequently be satisfied with the default switch settings of KAP for C. However, you can alter default settings to customize optimizations for a given application program and machine. These include limiting the search space for loop optimization, adjusting the parameters that describe cache memory, and enabling or disabling classes of transformations.

Command switches are switches requested on the command line when submitting a KAP job, rather than in the source file.

To specify a command switch, you can use the long name or short name. If a command switch appears more than once on the command line, the last value given is used. Multiple occurrences of an input /output file selection switch are not allowed.

Note

The short names for switches are provided as a convenience, especially for interactive users. However, they may not remain unique from one version of KAP to another. Use the long names in situations that require long-term compatibility, for example, a canned shell script.

Table 4-1 lists the command switches. The first column lists the long name of each switch. This column also lists the functional categories of switches: general optimization, parallel processing, inlining and Interprocedural Analysis, advanced optimization control, input/output files, and listing. The next two columns list the short name and default value of each switch. Switches that have different argument syntax in their regular and negative (no) forms are shown on two lines.

Note

File names are case sensitive on Digital UNIX systems, so file-name parameters must match the names of the files wanted. A hyphen (-) is required before each switch listed in the following table, but the hyphen is not shown in the table.

Table 4-1 Command-Line Switches

KAP is run after the standard C preprocessor. The code examples in this chapter show the original code before the preprocessor and the KAP transformed code with some of the C preprocessor additions stripped off for Digital UNIX clarity.