1 /* SPDX-License-Identifier: MIT */ <<
2 #ifndef __XEN_PUBLIC_XENPMU_H__ 1 #ifndef __XEN_PUBLIC_XENPMU_H__
3 #define __XEN_PUBLIC_XENPMU_H__ 2 #define __XEN_PUBLIC_XENPMU_H__
4 3
5 #include "xen.h" 4 #include "xen.h"
6 5
7 #define XENPMU_VER_MAJ 0 6 #define XENPMU_VER_MAJ 0
8 #define XENPMU_VER_MIN 1 7 #define XENPMU_VER_MIN 1
9 8
10 /* 9 /*
11 * ` enum neg_errnoval 10 * ` enum neg_errnoval
12 * ` HYPERVISOR_xenpmu_op(enum xenpmu_op cmd, 11 * ` HYPERVISOR_xenpmu_op(enum xenpmu_op cmd, struct xenpmu_params *args);
13 * 12 *
14 * @cmd == XENPMU_* (PMU operation) 13 * @cmd == XENPMU_* (PMU operation)
15 * @args == struct xenpmu_params 14 * @args == struct xenpmu_params
16 */ 15 */
17 /* ` enum xenpmu_op { */ 16 /* ` enum xenpmu_op { */
18 #define XENPMU_mode_get 0 /* Also used 17 #define XENPMU_mode_get 0 /* Also used for getting PMU version */
19 #define XENPMU_mode_set 1 18 #define XENPMU_mode_set 1
20 #define XENPMU_feature_get 2 19 #define XENPMU_feature_get 2
21 #define XENPMU_feature_set 3 20 #define XENPMU_feature_set 3
22 #define XENPMU_init 4 21 #define XENPMU_init 4
23 #define XENPMU_finish 5 22 #define XENPMU_finish 5
24 #define XENPMU_lvtpc_set 6 23 #define XENPMU_lvtpc_set 6
25 #define XENPMU_flush 7 24 #define XENPMU_flush 7
26 25
27 /* ` } */ 26 /* ` } */
28 27
29 /* Parameters structure for HYPERVISOR_xenpmu_ 28 /* Parameters structure for HYPERVISOR_xenpmu_op call */
30 struct xen_pmu_params { 29 struct xen_pmu_params {
31 /* IN/OUT parameters */ 30 /* IN/OUT parameters */
32 struct { 31 struct {
33 uint32_t maj; 32 uint32_t maj;
34 uint32_t min; 33 uint32_t min;
35 } version; 34 } version;
36 uint64_t val; 35 uint64_t val;
37 36
38 /* IN parameters */ 37 /* IN parameters */
39 uint32_t vcpu; 38 uint32_t vcpu;
40 uint32_t pad; 39 uint32_t pad;
41 }; 40 };
42 41
43 /* PMU modes: 42 /* PMU modes:
44 * - XENPMU_MODE_OFF: No PMU virtualization 43 * - XENPMU_MODE_OFF: No PMU virtualization
45 * - XENPMU_MODE_SELF: Guests can profile the 44 * - XENPMU_MODE_SELF: Guests can profile themselves
46 * - XENPMU_MODE_HV: Guests can profile the 45 * - XENPMU_MODE_HV: Guests can profile themselves, dom0 profiles
47 * itself and Xen 46 * itself and Xen
48 * - XENPMU_MODE_ALL: Only dom0 has access t 47 * - XENPMU_MODE_ALL: Only dom0 has access to VPMU and it profiles
49 * everyone: itself, the 48 * everyone: itself, the hypervisor and the guests.
50 */ 49 */
51 #define XENPMU_MODE_OFF 0 50 #define XENPMU_MODE_OFF 0
52 #define XENPMU_MODE_SELF (1<<0) 51 #define XENPMU_MODE_SELF (1<<0)
53 #define XENPMU_MODE_HV (1<<1) 52 #define XENPMU_MODE_HV (1<<1)
54 #define XENPMU_MODE_ALL (1<<2) 53 #define XENPMU_MODE_ALL (1<<2)
55 54
56 /* 55 /*
57 * PMU features: 56 * PMU features:
58 * - XENPMU_FEATURE_INTEL_BTS: Intel BTS suppo 57 * - XENPMU_FEATURE_INTEL_BTS: Intel BTS support (ignored on AMD)
59 */ 58 */
60 #define XENPMU_FEATURE_INTEL_BTS 1 59 #define XENPMU_FEATURE_INTEL_BTS 1
61 60
62 /* 61 /*
63 * Shared PMU data between hypervisor and PV(H 62 * Shared PMU data between hypervisor and PV(H) domains.
64 * 63 *
65 * The hypervisor fills out this structure dur 64 * The hypervisor fills out this structure during PMU interrupt and sends an
66 * interrupt to appropriate VCPU. 65 * interrupt to appropriate VCPU.
67 * Architecture-independent fields of xen_pmu_ 66 * Architecture-independent fields of xen_pmu_data are WO for the hypervisor
68 * and RO for the guest but some fields in xen 67 * and RO for the guest but some fields in xen_pmu_arch can be writable
69 * by both the hypervisor and the guest (see a 68 * by both the hypervisor and the guest (see arch-$arch/pmu.h).
70 */ 69 */
71 struct xen_pmu_data { 70 struct xen_pmu_data {
72 /* Interrupted VCPU */ 71 /* Interrupted VCPU */
73 uint32_t vcpu_id; 72 uint32_t vcpu_id;
74 73
75 /* 74 /*
76 * Physical processor on which the int 75 * Physical processor on which the interrupt occurred. On non-privileged
77 * guests set to vcpu_id; 76 * guests set to vcpu_id;
78 */ 77 */
79 uint32_t pcpu_id; 78 uint32_t pcpu_id;
80 79
81 /* 80 /*
82 * Domain that was interrupted. On non 81 * Domain that was interrupted. On non-privileged guests set to
83 * DOMID_SELF. 82 * DOMID_SELF.
84 * On privileged guests can be DOMID_S 83 * On privileged guests can be DOMID_SELF, DOMID_XEN, or, when in
85 * XENPMU_MODE_ALL mode, domain ID of 84 * XENPMU_MODE_ALL mode, domain ID of another domain.
86 */ 85 */
87 domid_t domain_id; 86 domid_t domain_id;
88 87
89 uint8_t pad[6]; 88 uint8_t pad[6];
90 89
91 /* Architecture-specific information * 90 /* Architecture-specific information */
92 struct xen_pmu_arch pmu; 91 struct xen_pmu_arch pmu;
93 }; 92 };
94 93
95 #endif /* __XEN_PUBLIC_XENPMU_H__ */ 94 #endif /* __XEN_PUBLIC_XENPMU_H__ */
96 95
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.