# Compaq KAP C/OpenMP
for Tru64 UNIX

# User Guide

Order Number: AA--PXEFL--TE

# February 2002

This guide describes how to use Compaq KAP C/OpenMP on Compaq Tru64 UNIX systems.

Revision/Update Information: This is a revised document.

Operating System and Version: Compaq Tru64 UNIX Versions 4.0F, 5.0, and 5.0A

Software Versions: Version 4.2
Compaq C Version 6.1

Compaq Computer Corporation
Houston, Texas

© 2002 Compaq Information Technologies Group, L.P.

© 2002 Intel Corporation.

Compaq, the Compaq logo, and Tru64 are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. KAP is a trademark of Intel Corporation in the U.S. and/or other countries. UNIX is a trademark of The Open Group in the U.S. and/or other countries. All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. This document is available on CD-ROM.

Contents | Index

# Preface

This guide describes how to use Compaq KAP C/OpenMP software on Compaq Tru64 UNIX systems.

# Intended Audience

This guide is for KAP users working with Compaq C on Compaq Tru64 UNIX systems.

# Structure of This Guide

This guide is organized into the following chapters and appendixes:

- Chapter 1 provides an overview of KAP C software.
- Chapter 2 presents general information on how to run KAP C on Tru64 UNIX systems. The sections describing how to compile and run programs with KAP C are specific to single-processor systems.
- Chapter 3 presents information on how to compile and run programs with KAP C on symmetric multiprocessor (SMP) systems.
- Chapter 4 describes the command-line switches used at run time to alter KAP C default activities, such as causing KAP C to set optimization levels or enable/disable classes of transformations.
- Chapter 5 describes KAP C assertions and directives. Assertions provide KAP C with additional information about the input program that would normally be unknown at compile time. Directives are in-line instructions to KAP C and function in many ways like command-line switches.
- Chapter 6 contains more information about inlining, interprocedural analysis (IPA), and the KAP command-line switches and directives that control them.
- Chapter 7 offers examples of KAP transformations from ordinary C code into more efficient forms. Users just becoming acquainted with KAP C may want to begin by browsing in this chapter.
- Chapter 8 describes the KAP C optional listing file and messages to users.
- Appendix A describes data dependence analysis and explains how KAP C uses this information to determine if a given loop can be optimized.

# Associated Documentation

This guide is part of the KAP C documentation set that also includes:

- Compaq KAP C/OpenMP for Tru64 UNIX Cover Letter
- Compaq KAP C/OpenMP for Tru64 UNIX Installation Guide
- Compaq KAP C/OpenMP for Tru64 UNIX Quick Reference

To view the KAP C man page, enter: `man kcc`

# Conventions

The following are equivalent terms in this guide:

- KAP, KAP C, KAP C/OpenMP, Compaq KAP, Compaq KAP C
- C, Compaq C
- Pragmas, directives

The following table lists the other conventions used in this guide.

Convention | Description
--- | ---
< > | Angle brackets denote command-line input you replace with the appropriate value.
( ) | Parentheses containing a single command-line value denote the default value. For example, `(-optimize=5)` denotes 5 is the default value. Parentheses containing hyphenated value ranges denote that you choose a value from the range.
[ ] | Square brackets denote optional syntax. For example: `#pragma _KAP [no]inline [(name)]`
UPPERCASE and lowercase | The Tru64 UNIX system differentiates between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function descriptions must be typed exactly as shown.
italic type | Italic type indicates complete titles of manuals and keywords, as well as product names.

Next | Contents | Index