Modules

group DCGMAPI_MODULES

This chapter describes the methods that query and configure DCGM modules.

Functions

dcgmReturn_t dcgmModuleDenylist(dcgmHandle_t pDcgmHandle, dcgmModuleId_t moduleId)

Add a module to the denylist.

This module will be prevented from being loaded if it hasn’t been loaded already. Modules are lazy-loaded as they are used by DCGM APIs, so it’s important to call this API soon after the host engine has been started. You can also pass —denylist-modules to the nv-hostengine binary to make sure modules get add to the denylist immediately after the host engine starts up.

Parameters:

• pDcgmHandle – IN: DCGM Handle

• moduleId – IN: ID of the module to denylist. Use dcgmModuleGetStatuses to get a list of valid module IDs.

Returns:

• DCGM_ST_OK if the module has been add to the denylist.

• DCGM_ST_IN_USE if the module has already been loaded and cannot add to the denylist.

• DCGM_ST_BADPARAM if a parameter is missing or bad.

dcgmReturn_t dcgmModuleGetStatuses(dcgmHandle_t pDcgmHandle, dcgmModuleGetStatuses_t *moduleStatuses)

Get the status of all of the DCGM modules.

Parameters:

• pDcgmHandle – IN: DCGM Handle

• moduleStatuses –

  OUT: Module statuses.

  .version should be set to dcgmModuleStatuses_version upon calling.

Returns:

• DCGM_ST_OK if the request succeeds.

• DCGM_ST_BADPARAM if a parameter is missing or bad.