Compute Partition Functions

Functions

Compute Partition Functions

Functions
amdsmi_status_t	amdsmi_get_gpu_compute_partition (amdsmi_processor_handle processor_handle, char *compute_partition, uint32_t len)
	Retrieves the current compute partitioning for a desired device. More...
amdsmi_status_t	amdsmi_set_gpu_compute_partition (amdsmi_processor_handle processor_handle, amdsmi_compute_partition_type_t compute_partition)
	Modifies a selected device's compute partition setting. More...

Detailed Description

These functions are used to configure and query the device's compute parition setting.

Function Documentation

◆ amdsmi_get_gpu_compute_partition()

amdsmi_status_t amdsmi_get_gpu_compute_partition	(	amdsmi_processor_handle	processor_handle,
		char *	compute_partition,
		uint32_t	len
	)

Retrieves the current compute partitioning for a desired device.

Platform:

gpu_bm_linux

Given a processor handle processor_handle and a string compute_partition , and uint32 len , this function will attempt to obtain the device's current compute partition setting string. Upon successful retreival, the obtained device's compute partition settings string shall be stored in the passed compute_partition char string variable.

Parameters

[in]	processor_handle	Device which to query
[in,out]	compute_partition	a pointer to a char string variable, which the device's current compute partition will be written to.
[in]	len	the length of the caller provided buffer compute_partition, suggested length is 4 or greater.

Return values

AMDSMI_STATUS_SUCCESS	call was successful
AMDSMI_STATUS_INVAL	the provided arguments are not valid
AMDSMI_STATUS_UNEXPECTED_DATA	data provided to function is not valid
AMDSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function
AMDSMI_STATUS_INSUFFICIENT_SIZE	is returned if len bytes is not large enough to hold the entire compute partition value. In this case, only len bytes will be written.

Returns

amdsmi_status_t

◆ amdsmi_set_gpu_compute_partition()

amdsmi_status_t amdsmi_set_gpu_compute_partition	(	amdsmi_processor_handle	processor_handle,
		amdsmi_compute_partition_type_t	compute_partition
	)

Modifies a selected device's compute partition setting.

Platform:

gpu_bm_linux

Given a processor handle processor_handle, a type of compute partition compute_partition, this function will attempt to update the selected device's compute partition setting. This function does not allow any concurrent operations. Device must be idle and have no workloads when performing set partition operations.

Parameters

[in]	processor_handle	Device which to query
[in]	compute_partition	using enum amdsmi_compute_partition_type_t, define what the selected device's compute partition setting should be updated to.

Return values

AMDSMI_STATUS_SUCCESS	call was successful
::AMDSMI_STATUS_PERMISSION	function requires root access
AMDSMI_STATUS_INVAL	the provided arguments are not valid
AMDSMI_STATUS_SETTING_UNAVAILABLE	the provided setting is unavailable for current device
AMDSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function

Returns

amdsmi_status_t