Compute Partition Functions

Functions

Compute Partition Functions

Functions
amdsmi_status_t	amdsmi_dev_compute_partition_get (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_dev_compute_partition_set (amdsmi_processor_handle processor_handle, amdsmi_compute_partition_type_t compute_partition)
	Modifies a selected device's compute partition setting. More...
amdsmi_status_t	amdsmi_dev_compute_partition_reset (amdsmi_processor_handle processor_handle)
	Reverts a selected device's compute partition setting back to its boot state. More...

Detailed Description

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

Function Documentation

◆ amdsmi_dev_compute_partition_get()

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

Retrieves the current compute partitioning for a desired device.

Given a device index dv_ind 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]	dv_ind	a device index
[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_INVALID_ARGS	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.

◆ amdsmi_dev_compute_partition_set()

amdsmi_status_t amdsmi_dev_compute_partition_set	(	amdsmi_processor_handle	processor_handle,
		amdsmi_compute_partition_type_t	compute_partition
	)

Modifies a selected device's compute partition setting.

Given a device index dv_ind, a type of compute partition compute_partition, this function will attempt to update the selected device's compute partition setting.

Parameters

[in]	dv_ind	a device index
[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_INVALID_ARGS	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

◆ amdsmi_dev_compute_partition_reset()

amdsmi_status_t amdsmi_dev_compute_partition_reset

(

amdsmi_processor_handle

processor_handle

)

Reverts a selected device's compute partition setting back to its boot state.

Given a device index dv_ind , this function will attempt to revert its compute partition setting back to its boot state.

Parameters

[in]

dv_ind

a device index

Return values

AMDSMI_STATUS_SUCCESS	call was successful
::AMDSMI_STATUS_PERMISSION	function requires root access
AMDSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function