Compiler warnings#

SCALE offers far more extensive compiler diagnostics than NVIDIA nvcc.

`clang++` flags#

The SCALE compiler accepts all of clang's usual flags in addition to those provided by nvcc, except where doing so would create an ambiguity.

Compiler warnings#

The SCALE compiler has the same default warning behaviour as clang, which is somewhat more strict than NVIDIA nvcc. Warnings may be disabled with the usual -Wno- flags documented in the clang diagnostics reference.

There may be value in enabling even more warnings to find further issues and improve your code.

Note that the end of every compiler warning message tells you the name of the warning flag it is associated with, such as:

warning: implicit conversion from 'int' to 'float' changes value from
2147483647 to 2147483648 [-Wimplicit-const-int-float-conversion]

By changing -W to -Wno-, you obtain the flag required to disable that warning. For example, adding -Wno-implicit-const-int-float-conversion would disable the warning from the example above.

`-Werror`#

nvcc's -Werror takes an argument specifying the types of warnings that should be errors, such as:

-Werror reorder,default-stream-launch

This differs from clang's syntax, which consists of either a lone -Werror to make all warnings into errors, or a set of -Werror=name flags to make specific things into errors.

In nvcc mode, the SCALE compiler accepts only the nvcc syntax, but allows the same set of diagnostic names accepted by clang (as well as the special names supported by NVIDIA's nvcc). For example:

# These two are equivalent in terms of warning flag meaning.
nvcc -Werror=documentation,implicit-int-conversion foo.cu
clang++ -Werror=documentation -Werror=implicit-int-conversion foo.cu

Since SCALE enables more warnings than nvcc does by default, many projects using -Werror with nvcc will not compile unless you:

Disable -Werror.
Disable the corresponding warnings.
Using diagnostic pragmas to disable the corresponding warnings in a region of code.

A quick-and-dirty way to achieve this is to put the appropriate flags in the NVCC_APEND_FLAGS environment variable, which is respected by SCALE.

Diagnostic control pragmas#

The SCALE compiler does not currently support #pragma nv_diag_suppress or #pragma diag_suppress because the set of integers accepted by these pragmas is not documented.

Using these pragmas in your program will produce an "unrecognised pragma ignored" warning, which can itself be disabled with -Wno-unknown-pragmas.

SCALE supports clang-style diagnostic pragmas, as documented here. This can be combined with preprocessor macros to achieve the desired effect:

#if defined(__clang__) // All clang-like compilers, including SCALE.
#pragma clang diagnostic ignored "-Wunused-result"
#elif defined(__NVCC__) // NVCC, but not clang. AKA: nvidia's one.
#pragma nv_diag_suppress ...
#endif

Compiler warnings#

clang++ flags#