1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef RESCTRL_H 3 #define RESCTRL_H 4 #include <stdio.h> 5 #include <math.h> 6 #include <errno.h> 7 #include <sched.h> 8 #include <stdlib.h> 9 #include <unistd.h> 10 #include <string.h> 11 #include <signal.h> 12 #include <dirent.h> 13 #include <stdbool.h> 14 #include <sys/stat.h> 15 #include <sys/ioctl.h> 16 #include <sys/mount.h> 17 #include <sys/types.h> 18 #include <sys/wait.h> 19 #include <sys/select.h> 20 #include <sys/time.h> 21 #include <sys/eventfd.h> 22 #include <asm/unistd.h> 23 #include <linux/perf_event.h> 24 #include "../kselftest.h" 25 26 #define MB (1024 * 1024) 27 #define RESCTRL_PATH "/sys/fs/resctrl" 28 #define PHYS_ID_PATH "/sys/devices/system/cpu/cpu" 29 #define INFO_PATH "/sys/fs/resctrl/info" 30 #define L3_PATH "/sys/fs/resctrl/info/L3" 31 #define MB_PATH "/sys/fs/resctrl/info/MB" 32 #define L3_MON_PATH "/sys/fs/resctrl/info/L3_MON" 33 #define L3_MON_FEATURES_PATH "/sys/fs/resctrl/info/L3_MON/mon_features" 34 35 #define ARCH_INTEL 1 36 #define ARCH_AMD 2 37 38 #define END_OF_TESTS 1 39 40 #define PARENT_EXIT(err_msg) \ 41 do { \ 42 perror(err_msg); \ 43 kill(ppid, SIGKILL); \ 44 umount_resctrlfs(); \ 45 exit(EXIT_FAILURE); \ 46 } while (0) 47 48 /* 49 * resctrl_val_param: resctrl test parameters 50 * @resctrl_val: Resctrl feature (Eg: mbm, mba.. etc) 51 * @ctrlgrp: Name of the control monitor group (con_mon grp) 52 * @mongrp: Name of the monitor group (mon grp) 53 * @cpu_no: CPU number to which the benchmark would be binded 54 * @span: Memory bytes accessed in each benchmark iteration 55 * @filename: Name of file to which the o/p should be written 56 * @bw_report: Bandwidth report type (reads vs writes) 57 * @setup: Call back function to setup test environment 58 */ 59 struct resctrl_val_param { 60 char *resctrl_val; 61 char ctrlgrp[64]; 62 char mongrp[64]; 63 int cpu_no; 64 size_t span; 65 char filename[64]; 66 char *bw_report; 67 unsigned long mask; 68 int num_of_runs; 69 int (*setup)(struct resctrl_val_param *param); 70 }; 71 72 #define MBM_STR "mbm" 73 #define MBA_STR "mba" 74 #define CMT_STR "cmt" 75 #define CAT_STR "cat" 76 77 extern pid_t bm_pid, ppid; 78 79 extern char llc_occup_path[1024]; 80 81 int get_vendor(void); 82 bool check_resctrlfs_support(void); 83 int filter_dmesg(void); 84 int get_resource_id(int cpu_no, int *resource_id); 85 int mount_resctrlfs(void); 86 int umount_resctrlfs(void); 87 int validate_bw_report_request(char *bw_report); 88 bool validate_resctrl_feature_request(const char *resctrl_val); 89 char *fgrep(FILE *inf, const char *str); 90 int taskset_benchmark(pid_t bm_pid, int cpu_no); 91 void run_benchmark(int signum, siginfo_t *info, void *ucontext); 92 int write_schemata(char *ctrlgrp, char *schemata, int cpu_no, 93 char *resctrl_val); 94 int write_bm_pid_to_resctrl(pid_t bm_pid, char *ctrlgrp, char *mongrp, 95 char *resctrl_val); 96 int perf_event_open(struct perf_event_attr *hw_event, pid_t pid, int cpu, 97 int group_fd, unsigned long flags); 98 int run_fill_buf(size_t span, int memflush, int op, bool once); 99 int resctrl_val(char **benchmark_cmd, struct resctrl_val_param *param); 100 int mbm_bw_change(size_t span, int cpu_no, char *bw_report, char **benchmark_cmd); 101 void tests_cleanup(void); 102 void mbm_test_cleanup(void); 103 int mba_schemata_change(int cpu_no, char *bw_report, char **benchmark_cmd); 104 void mba_test_cleanup(void); 105 int get_cbm_mask(char *cache_type, char *cbm_mask); 106 int get_cache_size(int cpu_no, char *cache_type, unsigned long *cache_size); 107 void ctrlc_handler(int signum, siginfo_t *info, void *ptr); 108 int signal_handler_register(void); 109 void signal_handler_unregister(void); 110 int cat_val(struct resctrl_val_param *param); 111 void cat_test_cleanup(void); 112 int cat_perf_miss_val(int cpu_no, int no_of_bits, char *cache_type); 113 int cmt_resctrl_val(int cpu_no, int n, char **benchmark_cmd); 114 unsigned int count_bits(unsigned long n); 115 void cmt_test_cleanup(void); 116 int get_core_sibling(int cpu_no); 117 int measure_cache_vals(struct resctrl_val_param *param, int bm_pid); 118 int show_cache_info(unsigned long sum_llc_val, int no_of_bits, 119 size_t cache_span, unsigned long max_diff, 120 unsigned long max_diff_percent, unsigned long num_of_runs, 121 bool platform, bool cmt); 122 123 #endif /* RESCTRL_H */ 124