Process information#
Functions | |
| amdsmi_status_t | amdsmi_get_gpu_process_list (amdsmi_processor_handle processor_handle, uint32_t *max_processes, amdsmi_proc_info_t *list) |
| Returns the list of processes running on a given GPU including itself. More... | |
Detailed Description
Function Documentation
◆ amdsmi_get_gpu_process_list()
| amdsmi_status_t amdsmi_get_gpu_process_list | ( | amdsmi_processor_handle | processor_handle, |
| uint32_t * | max_processes, | ||
| amdsmi_proc_info_t * | list | ||
| ) |
Returns the list of processes running on a given GPU including itself.
- Platform:
gpu_bm_linux
guest_1vf
guest_mvf
guest_windows
- Note
- The user provides a buffer to store the list and the maximum number of processes that can be returned. If the user sets max_processes to 0, the current total number of processes will replace max_processes param. After that, the function needs to be called again, with updated max_processes, to successfully fill the process list, which was previously allocated with max_processes
- Parameters
-
[in] processor_handle Device which to query [in,out] max_processes Reference to the size of the list buffer in number of elements. Returns the return number of elements in list or the number of running processes if equal to 0, and if given value in param max_processes is less than number of processes currently running, AMDSMI_STATUS_OUT_OF_RESOURCES will be returned.
For cases where max_process is not zero (0), it specifies the list's size limit. That is, the maximum size this list will be able to hold. After the list is built internally, as a return status, we will have AMDSMI_STATUS_OUT_OF_RESOURCES when the original size limit is smaller than the actual list of processes running. Hence, the caller is aware the list size needs to be resized, or AMDSMI_STATUS_SUCCESS otherwise. Holding a copy of max_process before it is passed in will be helpful for monitoring the allocations done upon each call since the max_process will permanently be changed to reflect the actual number of processes running.
- Parameters
-
[out] list Reference to a user-provided buffer where the process list will be returned. This buffer must contain at least max_processes entries of type amd_proc_info_list_t. Must be allocated by user.
- Returns
- amdsmi_status_t | AMDSMI_STATUS_SUCCESS on success, | AMDSMI_STATUS_OUT_OF_RESOURCES, filled list buffer with data, but number of actual running processes is larger than the size provided.