1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef LINUX_POWERPC_PERF_HV_24X7_H_
3#define LINUX_POWERPC_PERF_HV_24X7_H_
4
5#include <linux/types.h>
6
7enum hv_perf_domains {
8#define DOMAIN(n, v, x, c) HV_PERF_DOMAIN_##n = v,
9#include "hv-24x7-domains.h"
10#undef DOMAIN
11	HV_PERF_DOMAIN_MAX,
12};
13
14#define H24x7_REQUEST_SIZE(iface_version)	(iface_version == 1 ? 16 : 32)
15
16struct hv_24x7_request {
17	/* PHYSICAL domains require enabling via phyp/hmc. */
18	__u8 performance_domain;
19	__u8 reserved[0x1];
20
21	/* bytes to read starting at @data_offset. must be a multiple of 8 */
22	__be16 data_size;
23
24	/*
25	 * byte offset within the perf domain to read from. must be 8 byte
26	 * aligned
27	 */
28	__be32 data_offset;
29
30	/*
31	 * only valid for VIRTUAL_PROCESSOR domains, ignored for others.
32	 * -1 means "current partition only"
33	 *  Enabling via phyp/hmc required for non-"-1" values. 0 forbidden
34	 *  unless requestor is 0.
35	 */
36	__be16 starting_lpar_ix;
37
38	/*
39	 * Ignored when @starting_lpar_ix == -1
40	 * Ignored when @performance_domain is not VIRTUAL_PROCESSOR_*
41	 * -1 means "infinite" or all
42	 */
43	__be16 max_num_lpars;
44
45	/* chip, core, or virtual processor based on @performance_domain */
46	__be16 starting_ix;
47	__be16 max_ix;
48
49	/* The following fields were added in v2 of the 24x7 interface. */
50
51	__u8 starting_thread_group_ix;
52
53	/* -1 means all thread groups starting at @starting_thread_group_ix */
54	__u8 max_num_thread_groups;
55
56	__u8 reserved2[0xE];
57} __packed;
58
59struct hv_24x7_request_buffer {
60	/* 0 - ? */
61	/* 1 - ? */
62	__u8 interface_version;
63	__u8 num_requests;
64	__u8 reserved[0xE];
65	struct hv_24x7_request requests[];
66} __packed;
67
68struct hv_24x7_result_element_v1 {
69	__be16 lpar_ix;
70
71	/*
72	 * represents the core, chip, or virtual processor based on the
73	 * request's @performance_domain
74	 */
75	__be16 domain_ix;
76
77	/* -1 if @performance_domain does not refer to a virtual processor */
78	__be32 lpar_cfg_instance_id;
79
80	/* size = @result_element_data_size of containing result. */
81	__u64 element_data[];
82} __packed;
83
84/*
85 * We need a separate struct for v2 because the offset of @element_data changed
86 * between versions.
87 */
88struct hv_24x7_result_element_v2 {
89	__be16 lpar_ix;
90
91	/*
92	 * represents the core, chip, or virtual processor based on the
93	 * request's @performance_domain
94	 */
95	__be16 domain_ix;
96
97	/* -1 if @performance_domain does not refer to a virtual processor */
98	__be32 lpar_cfg_instance_id;
99
100	__u8 thread_group_ix;
101
102	__u8 reserved[7];
103
104	/* size = @result_element_data_size of containing result. */
105	__u64 element_data[];
106} __packed;
107
108struct hv_24x7_result {
109	/*
110	 * The index of the 24x7 Request Structure in the 24x7 Request Buffer
111	 * used to request this result.
112	 */
113	__u8 result_ix;
114
115	/*
116	 * 0 = not all result elements fit into the buffer, additional requests
117	 *     required
118	 * 1 = all result elements were returned
119	 */
120	__u8 results_complete;
121	__be16 num_elements_returned;
122
123	/*
124	 * This is a copy of @data_size from the corresponding hv_24x7_request
125	 *
126	 * Warning: to obtain the size of each element in @elements you have
127	 * to add the size of the other members of the result_element struct.
128	 */
129	__be16 result_element_data_size;
130	__u8 reserved[0x2];
131
132	/*
133	 * Either
134	 *	struct hv_24x7_result_element_v1[@num_elements_returned]
135	 * or
136	 *	struct hv_24x7_result_element_v2[@num_elements_returned]
137	 *
138	 * depending on the interface_version field of the
139	 * struct hv_24x7_data_result_buffer containing this result.
140	 */
141	char elements[];
142} __packed;
143
144struct hv_24x7_data_result_buffer {
145	/* See versioning for request buffer */
146	__u8 interface_version;
147
148	__u8 num_results;
149	__u8 reserved[0x1];
150	__u8 failing_request_ix;
151	__be32 detailed_rc;
152	__be64 cec_cfg_instance_id;
153	__be64 catalog_version_num;
154	__u8 reserved2[0x8];
155	/* WARNING: only valid for the first result due to variable sizes of
156	 *	    results */
157	struct hv_24x7_result results[]; /* [@num_results] */
158} __packed;
159
160#endif
161