Logging Capabilities¶

cuSPARSELt logging mechanism can be enabled by setting the following environment variables before launching the target application:

CUSPARSELT_LOG_LEVEL=<level> - while <level> is one of the following levels:

  • 0 - Off - Logging is disabled (default)

  • 1 - Error - Only errors will be logged

  • 2 - Trace - API calls that launch CUDA kernels will log their parameters and important information

  • 3 - Hints - Hints that can potentially improve the application’s performance

  • 4 - Info - Provides general information about the library execution, may contain details about heuristic status

  • 5 - API Trace - API calls will log their parameter and important information

CUSPARSELT_LOG_MASK=<mask> - while <mask> is a combination of the following masks:

  • 0 - Off

  • 1 - Error

  • 2 - Trace

  • 4 - Hints

  • 8 - Info

  • 16 - API Trace

CUSPARSELT_LOG_FILE=<file_name> - while file name is a path to a logging file. File name may contain %i, that will be replaced with the process id. E.g "<file_name>_%i.log". If CUSPARSELT_LOG_FILE is not defined, the log messages are printed to stdout.