Package oshi.jna.platform.unix.aix
Interface Perfstat
- All Superinterfaces:
com.sun.jna.Library
public interface Perfstat
extends com.sun.jna.Library
The perfstat API uses the perfstat kernel extension to extract various AIX®
performance metrics.
System component information is also retrieved from the Object Data Manager
(ODM) and returned with the performance metrics.
The perfstat API is thread–safe, and does not require root authority.
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
Perfstat.perfstat_cpu_t
static class
Perfstat.perfstat_cpu_total_t
static class
Perfstat.perfstat_disk_t
static class
Perfstat.perfstat_id_t
static class
Perfstat.perfstat_memory_total_t
static class
Perfstat.perfstat_netinterface_t
static class
Perfstat.perfstat_partition_config_t
static class
Perfstat.perfstat_process_t
static class
Perfstat.perfstat_protocol_t
static class
Perfstat.perfstat_value_t
-
Field Summary
Fields Modifier and Type Field Description static int
IDENTIFIER_LENGTH
static Perfstat
INSTANCE
-
Method Summary
Modifier and Type Method Description static Perfstat
getInstance()
int
perfstat_cpu(Perfstat.perfstat_id_t name, Perfstat.perfstat_cpu_t[] cpu, int sizeof_struct, int desired_number)
Retrieves individual processor usage metricsint
perfstat_cpu_total(Perfstat.perfstat_id_t name, Perfstat.perfstat_cpu_total_t cpu, int sizeof_struct, int desired_number)
Retrieves total processor usage metricsint
perfstat_disk(Perfstat.perfstat_id_t name, Perfstat.perfstat_disk_t[] disks, int sizeof_struct, int desired_number)
Retrieves disk statisticsint
perfstat_memory_total(Perfstat.perfstat_id_t name, Perfstat.perfstat_memory_total_t mem, int sizeof_struct, int desired_number)
Retrieves total memory-related metricsint
perfstat_netinterface(Perfstat.perfstat_id_t name, Perfstat.perfstat_netinterface_t[] netints, int sizeof_struct, int desired_number)
Retrieves network interfacesint
perfstat_partition_config(Perfstat.perfstat_id_t name, Perfstat.perfstat_partition_config_t config, int sizeof_struct, int desired_number)
Retrieves total memory-related metricsint
perfstat_process(Perfstat.perfstat_id_t name, Perfstat.perfstat_process_t[] procs, int sizeof_struct, int desired_number)
Retrieves process-related metricsint
perfstat_protocol(Perfstat.perfstat_id_t name, Perfstat.perfstat_protocol_t[] protocols, int sizeof_struct, int desired_number)
Retrieves protocol data
-
Field Details
-
INSTANCE
-
IDENTIFIER_LENGTH
static final int IDENTIFIER_LENGTH- See Also:
- Constant Field Values
-
-
Method Details
-
getInstance
-
perfstat_cpu_total
int perfstat_cpu_total(Perfstat.perfstat_id_t name, Perfstat.perfstat_cpu_total_t cpu, int sizeof_struct, int desired_number)Retrieves total processor usage metrics- Parameters:
name
- Reserved for future use, must be NULLcpu
- Populated with structuresizeof_struct
- Should be set to sizeof(perfstat_cpu_total_t)desired_number
- Reserved for future use, must be set to 0 or 1- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned. This is always 1.
-
perfstat_cpu
int perfstat_cpu(Perfstat.perfstat_id_t name, Perfstat.perfstat_cpu_t[] cpu, int sizeof_struct, int desired_number)Retrieves individual processor usage metrics- Parameters:
name
- Structure containing empty string when collecting all cpu stats, or null to count CPUscpu
- Populated with structures, or null to count CPUssizeof_struct
- Should be set to sizeof(perfstat_cpu_t)desired_number
- Set to 0 to count CPUs, set to number of cpus to return otherwise- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned.
-
perfstat_memory_total
int perfstat_memory_total(Perfstat.perfstat_id_t name, Perfstat.perfstat_memory_total_t mem, int sizeof_struct, int desired_number)Retrieves total memory-related metrics- Parameters:
name
- Reserved for future use, must be NULLmem
- Populated with structuresizeof_struct
- Should be set to sizeof(perfstat_memory_total_t)desired_number
- Reserved for future use, must be set to 0 or 1- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned. This is always 1.
-
perfstat_process
int perfstat_process(Perfstat.perfstat_id_t name, Perfstat.perfstat_process_t[] procs, int sizeof_struct, int desired_number)Retrieves process-related metrics- Parameters:
name
- Structure containing empty string when collecting all process stats, or null to count processesprocs
- Populated with structuresizeof_struct
- Should be set to sizeof(perfstat_process_t)desired_number
- Set to 0 to count processes, set to number of processes to return otherwise- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned.
-
perfstat_disk
int perfstat_disk(Perfstat.perfstat_id_t name, Perfstat.perfstat_disk_t[] disks, int sizeof_struct, int desired_number)Retrieves disk statistics- Parameters:
name
- Structure containing empty string when collecting all disk stats, or null to count block disksdisks
- Populated with structures, or null to count diskssizeof_struct
- Should be set to sizeof(perfstat_disk_t)desired_number
- Set to 0 to count disks, set to number of disks to return otherwise- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned.
-
perfstat_partition_config
int perfstat_partition_config(Perfstat.perfstat_id_t name, Perfstat.perfstat_partition_config_t config, int sizeof_struct, int desired_number)Retrieves total memory-related metrics- Parameters:
name
- Reserved for future use, must be NULLconfig
- Populated with structuresizeof_struct
- Should be set to sizeof(perfstat_partition_config_t)desired_number
- Reserved for future use, must be set to 0 or 1- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned. This is always 1.
-
perfstat_netinterface
int perfstat_netinterface(Perfstat.perfstat_id_t name, Perfstat.perfstat_netinterface_t[] netints, int sizeof_struct, int desired_number)Retrieves network interfaces- Parameters:
name
- Structure containing empty string when collecting all interface stats, or null to count interfacesnetints
- Populated with structures, or null to count interfacessizeof_struct
- Should be set to sizeof(perfstat_netinterface_t)desired_number
- Set to 0 to count network interfaces, set to number of interfaces to return otherwise- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned.
-
perfstat_protocol
int perfstat_protocol(Perfstat.perfstat_id_t name, Perfstat.perfstat_protocol_t[] protocols, int sizeof_struct, int desired_number)Retrieves protocol data- Parameters:
name
- Structure containing empty string when collecting all protocol stats, or null to count statsprotocols
- Populated with structures, or null to count protocolssizeof_struct
- Should be set to sizeof(perfstat_protocol_t)desired_number
- Set to 0 to count protocols, set to number of protocols to return otherwise- Returns:
- The return value is -1 in case of errors. Otherwise, the number of structures copied is returned.
-