---
name: "hipcc"
section: "1"
platform: "linux"
package: "hipcc"
version: "5.7.1-6+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hipcc"
---

# hipcc(1)

HIP compiler driver

## NAME

hipcc - HIP compiler driver

## SYNOPSIS

usage: hipcc \[OPTIONS\] FILENAME ...

## DESCRIPTION

The hipcc script wraps clang or nvcc depending on the value of the HIP\_PLATFORM reported by hipconfig. When building for the AMD platform, the options given to hipcc are forwarded to clang. The hipcc script adds additional options to the list of arguments being forwarded, including *-x hip* to force the compilation language to HIP, *-O3* when no optimization level is specified, and *--offload-arch* with an autodetected GPU architecture if no target architecture is specified.

## ENVIRONMENT

- **HIPCC\_VERBOSE**

  This environment variable can enable additional output. The following flags control the level of verbosity to be printed:

- •

  **0x1** The clang command being invoked.

- •

  **0x2** The paths to HIP components.

- •

  **0x3** The arguments hipcc was called with.

- **HIPCC\_COMPILE\_FLAGS\_APPEND**

  The contents of this variable are added to the end of the argument list that is passed to clang when compiling.

- **HIPCC\_LINK\_FLAGS\_APPEND**

  The contents of this variable are added to the end of the argument list that is passed to clang when linking.

- **DEVICE\_LIB\_PATH**

  This variable is used to override the path to the ROCm device libraries.

- **HIP\_LIB\_PATH**

  This variable is used to override the path to the directory containing the HIP runtime library.

- **HIP\_CLANG\_HCC\_COMPAT\_MODE**

  This variable is used to specify if clang should enable options that make it more compatible with the old hcc compiler. This includes allowing the half float type to be used in function signatures as arguments or return values. When in this mode, the **\_\_HIP\_HCC\_COMPAT\_MODE\_\_** preprocessor macro will also be defined.

- **HIP\_CLANG\_LAUNCHER**

  This environment variable specifies a path to an executable to use for launching HIP clang, which can be useful for making use of a compiler caching tool.

## SEE ALSO

**[hipconfig(1)](/hipconfig/1.md)**