Nvidia PTX Options#
These options are defined for Nvidia PTX:
- -m64#
Ignored, but preserved for backward compatibility. Only 64-bit ABI is supported.
- -march=architecture-string#
Generate code for the specified PTX ISA target architecture (e.g.
sm_35
). Valid architecture strings aresm_30
,sm_35
,sm_53
,sm_70
,sm_75
andsm_80
. The default depends on how the compiler has been configured, see--with-arch
.This option sets the value of the preprocessor macro
__PTX_SM__
; for instance, forsm_35
, it has the value350
.
- -march-map=architecture-string#
Select the closest available
-march=
value that is not more capable. For instance, for-march-map=sm_50
select-march=sm_35
, and for-march-map=sm_53
select-march=sm_53
.
- -mptx=version-string#
Generate code for the specified PTX ISA version (e.g.
7.0
). Valid version strings include3.1
,6.0
,6.3
, and7.0
. The default PTX ISA version is 6.0, unless a higher version is required for specified PTX ISA target architecture via option-march=
.This option sets the values of the preprocessor macros
__PTX_ISA_VERSION_MAJOR__
and__PTX_ISA_VERSION_MINOR__
; for instance, for3.1
the macros have the values3
and1
, respectively.
- -mmainkernel#
Link in code for a __main kernel. This is for stand-alone instead of offloading execution.
- -moptimize#
Apply partitioned execution optimizations. This is the default when any level of optimization is selected.
- -msoft-stack#
Generate code that does not use
.local
memory directly for stack storage. Instead, a per-warp stack pointer is maintained explicitly. This enables variable-length stack allocation (with variable-length arrays oralloca
), and when global memory is used for underlying storage, makes it possible to access automatic variables from other threads, or with atomic instructions. This code generation variant is used for OpenMP offloading, but the option is exposed on its own for the purpose of testing the compiler; to generate code suitable for linking into programs using OpenMP offloading, use option-mgomp
.
- -muniform-simt#
Switch to code generation variant that allows to execute all threads in each warp, while maintaining memory state and side effects as if only one thread in each warp was active outside of OpenMP SIMD regions. All atomic operations and calls to runtime (malloc, free, vprintf) are conditionally executed (iff current lane index equals the master lane index), and the register being assigned is copied via a shuffle instruction from the master lane. Outside of SIMD regions lane 0 is the master; inside, each thread sees itself as the master. Shared memory array
int __nvptx_uni[]
stores all-zeros or all-ones bitmasks for each warp, indicating current mode (0 outside of SIMD regions). Each thread can bitwise-and the bitmask at positiontid.y
with current lane index to compute the master lane index.
- -mgomp#
Generate code for use in OpenMP offloading: enables
-msoft-stack
and-muniform-simt
options, and selects corresponding multilib variant.