Profile Configurations

Profile Configurations#

Rocprofiler SDK Developer API: Profile Configurations

Rocprofiler SDK Developer API 0.5.0

ROCm Profiling API and tools

Group one or more hardware counters into a unique handle. More...

Functions
rocprofiler_status_t	rocprofiler_create_profile_config (rocprofiler_agent_id_t agent_id, rocprofiler_counter_id_t counters_list, unsigned long counters_count, rocprofiler_profile_config_id_t config_id)
	Create Profile Configuration. A profile is bound to an agent but can be used across many contexts. The profile has a fixed set of counters that are collected (and specified by counter_list). The available counters for an agent can be queried using rocprofiler_iterate_agent_supported_counters. An existing profile may be supplied via config_id to use as a base for the new profile. All counters in the existing profile will be copied over to the new profile. The existing profile will remain unmodified and usable with the new profile id being returned in config_id.

rocprofiler_status_t	rocprofiler_destroy_profile_config (rocprofiler_profile_config_id_t config_id)
	Destroy Profile Configuration.

Detailed Description

Group one or more hardware counters into a unique handle.

Function Documentation

◆ rocprofiler_create_profile_config()

rocprofiler_status_t rocprofiler_create_profile_config	(	rocprofiler_agent_id_t	agent_id,
		rocprofiler_counter_id_t *	counters_list,
		unsigned long	counters_count,
		rocprofiler_profile_config_id_t *	config_id
	)

Create Profile Configuration. A profile is bound to an agent but can be used across many contexts. The profile has a fixed set of counters that are collected (and specified by counter_list). The available counters for an agent can be queried using rocprofiler_iterate_agent_supported_counters. An existing profile may be supplied via config_id to use as a base for the new profile. All counters in the existing profile will be copied over to the new profile. The existing profile will remain unmodified and usable with the new profile id being returned in config_id.

Parameters

[in]	agent_id	Agent identifier
[in]	counters_list	List of GPU counters
[in]	counters_count	Size of counters list
[in,out]	config_id	Identifier for GPU counters group. If an existing profile is supplied, that profiles counters will be copied over to a new profile (returned via this id)

Returns: rocprofiler_status_t

Return values

ROCPROFILER_STATUS_SUCCESS	if profile created
ROCPROFILER_STATUS_ERROR	if profile could not be created

◆ rocprofiler_destroy_profile_config()

rocprofiler_status_t rocprofiler_destroy_profile_config ( rocprofiler_profile_config_id_t config_id )

Destroy Profile Configuration.