subrutina perfstat_process_util
Finalidad
Calcula las métricas de utilización de procesos.
Biblioteca
biblioteca perfstatlibperfstat.a)
Sintaxis
#include <libperfstat.h>perfstat_id_t * data;
perfstat_process_t * userbuff;
int sizeof_userbuff ;
int desired_number ;
Descripción
La subrutina perfstat_process_util proporciona la interfaz para las métricas de utilización de procesos. La subrutina perfstat_process recupera una o más estadísticas de proceso para rellenar la estructura de datos perfstat_process_t. La subrutina perfstat_process_util utiliza los valores actuales y anteriores para calcular las métricas relacionadas con la utilización. Si los parámetros ' nombre ' y ' userbuff ' son NULL, y el parámetro ' sizeof_userbuff ' es 0, se devuelve el tamaño de la versión actual de la estructura de datos ' perfstat_process_t '. Si el parámetro desired_number se establece en 0, se devuelve el número de elementos actuales, de la estructura de datos perfstat_rawdata_t.
Parámetros
| Elemento | Descripción |
|---|---|
| Datos | Especifica que el parámetro de datos es del tipo perfstat_rawdata_t. La estructura de datos perfstat_rawdata_t puede tomar los valores actual y anterior para calcular las métricas relacionadas con la utilización. |
| userbuff | Especifica el área de memoria que se llenará con una o más estructuras de datos perfstat_process_t. |
| tamaño_usuario_tamaño | Especifica el tamaño de la estructura de datos perfstat_process_t. Nota: Para obtener el tamaño de la última versión de la estructura de datos perfstat_process_t, ponga el parámetro sizeof_userbuff a 0, y los parámetros name y userbuff a NULL.
|
| número_deseado | Especifica el número de estructuras perfstat_process_t a copiar en el parámetro userbuff. |
Valores de retorno
A menos que se utilice la subrutina perfstat_process_util para recuperar el número de estructuras disponibles, el número de estructuras llenas se devuelve al finalizar con éxito. Si no se consigue, se devuelve un valor de -1 y se establece la variable global errno.
Códigos de error
La subrutina perfstat_process_util no tiene éxito si el siguiente código de error es verdadero:
| Elemento | Descripción |
|---|---|
| EINVAL | Uno de los parámetros no es válido. |
Archivos
El archivo libperfstat.h define macros, tipos de datos y subrutinas estándar.