mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
c7fe21b019
Add a function to detect the existence of the CPU Measurement Sampling Facility on a system. Add a function which extracts the CPU Measurement Sampling Facility characteristics on a system, such as - minimum sample speed - maximum sample speed - current CPU speed - basic sample size in bytes - diagnostic sample size in bytes Add a function to detect the existence of the CPU Measurement Sampling Facility on a system and return the current sampling buffer management characteristics, such as: - minimum supported sampling buffer size - maximum supported sampling buffer size Add a function to detect the existence of the CPU Measurement Counting Facility on a system. Add a function which extracts the CPU Measurement Counting Facility characteristics on a system, such as - counter first version number - counter second version number - counter set authorization level Add a function the returm the PMU type number of a CPU Measurement Facility device driver. These numbers may vary between boots. Signed-off-by: Thomas Richter <tmricht@linux.ibm.com> Acked-by: Sumanth Korikkar <sumanthk@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
107 lines
3.6 KiB
C
107 lines
3.6 KiB
C
/* Copyright IBM Corp. 2022
|
|
*
|
|
* s390-tools is free software; you can redistribute it and/or modify
|
|
* it under the terms of the MIT license. See LICENSE for details.
|
|
*/
|
|
|
|
#ifndef LIBCPUMF_H
|
|
#define LIBCPUMF_H
|
|
|
|
#include <sched.h>
|
|
#include <stdbool.h>
|
|
|
|
#define S390_CPUMF_CF "/sys/devices/cpum_cf/"
|
|
#define S390_CPUMF_CFDIAG "/sys/devices/cpum_cf_diag/"
|
|
#define S390_CPUMF_SF "/sys/devices/cpum_sf/"
|
|
#define S390_CPUS_POSSIBLE "/sys/devices/system/cpu/possible"
|
|
#define S390_CPUS_ONLINE "/sys/devices/system/cpu/online"
|
|
#define S390_CPUMSF_BUFFERSZ "/sys/module/kernel/parameters/cpum_sfb_size"
|
|
|
|
/**
|
|
* Read out the PMU type from a given file.
|
|
*
|
|
* Return the PMU type number assigned to this PMU by the kernel. This is
|
|
* a non zero number.
|
|
* If the PMU does not exist return -1 and set errno.
|
|
*
|
|
* @param[in] dirname Name of the event directory in sysfs
|
|
*/
|
|
int libcpumf_pmutype(const char *dirname);
|
|
|
|
/**
|
|
* Read out the CPU list from a given file name, for example from files
|
|
* /sys/devices/system/cpu/online or /sys/devices/system/cpu/possible.
|
|
*
|
|
* Return the cpu_set_t created from parsing the CPU list in the second
|
|
* parameter.
|
|
* Return code of zero indicates proper conversion and -1 indicates an
|
|
* error.
|
|
*
|
|
* @param[in] buffer Comma separated string of a CPU list
|
|
* @param[in] filename Name of a sysfs CPU list file name
|
|
* @param[out] mask Converted buffer into cpu_set_t mask structure
|
|
*/
|
|
int libcpumf_cpuset(const char *buffer, cpu_set_t *mask);
|
|
int libcpumf_cpuset_fn(const char *filename, cpu_set_t *mask);
|
|
|
|
/**
|
|
* Read CPU Measurement Counting Facility hardware information
|
|
*
|
|
* Return true if CPU Measurement Counter facility information has been
|
|
* retrieved and is valid.
|
|
*
|
|
* Return false if the information could not be extracted from the file.
|
|
*
|
|
* @param[out] cfvn Contains CPUMF counter first version number
|
|
* @param[out] csvn Contains CPUMF counter second version number
|
|
* @param[out] auth Contains CPUMF counter set authorization level
|
|
*/
|
|
bool libcpumf_cpumcf_info(int *cfvn, int *csvn, int *auth);
|
|
|
|
/**
|
|
* Return true if CPU Measurement Counter Facility is available.
|
|
*/
|
|
bool libcpumf_have_cpumcf(void);
|
|
|
|
/**
|
|
* Read CPU Measurement Sampling Facility hardware information
|
|
*
|
|
* Read all necessary information from /sysfs file /proc/service_levels
|
|
* to return CPU Measurement Counter Sampling facility information
|
|
* characteristics.
|
|
* Return true on success and false when the data can not be retrieved.
|
|
*
|
|
* @param[out] min Minimum supported sampling interval
|
|
* @param[out] max Maximum supported sampling interval
|
|
* @param[out] speed Current CPU speed, number of CPU cylces per
|
|
* microsecond
|
|
* @param[out] basic_sz Basic sample size in bytes
|
|
* @param[out] diag_sz Diagnostic sample size in bytes
|
|
*/
|
|
bool libcpumf_cpumsf_info(unsigned long *min, unsigned long *max,
|
|
unsigned long *speed, int *basic_sz, int *diag_sz);
|
|
|
|
/**
|
|
* Return true if CPU Measurement Sampling Facility is available.
|
|
*/
|
|
bool libcpumf_have_cpumsf(void);
|
|
|
|
/**
|
|
* Return true if CPU Measurement Sampling Facility buffer sizes are
|
|
* available.
|
|
*/
|
|
bool libcpumf_have_sfb(void);
|
|
|
|
/**
|
|
* Read CPU Measurement Sampling Facility supported sampling buffer sizes.
|
|
*
|
|
* Return the minimum and maximum CPU Measurement sampling facitity buffer
|
|
* sizes supported.
|
|
* Return true on success and false otherwise.
|
|
*
|
|
* @param[out] min Minimum supported sampling buffer size
|
|
* @param[out] max Maximum supported sampling buffer size
|
|
*/
|
|
bool libcpumf_sfb_info(unsigned long *min, unsigned long *max);
|
|
#endif
|