NAME¶

hipcc - HIP compiler

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)