1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Copyright (C) 2012,2013 - ARM Ltd
4*4882a593Smuzhiyun * Author: Marc Zyngier <marc.zyngier@arm.com>
5*4882a593Smuzhiyun *
6*4882a593Smuzhiyun * Derived from arch/arm/kvm/coproc.h
7*4882a593Smuzhiyun * Copyright (C) 2012 - Virtual Open Systems and Columbia University
8*4882a593Smuzhiyun * Authors: Christoffer Dall <c.dall@virtualopensystems.com>
9*4882a593Smuzhiyun */
10*4882a593Smuzhiyun
11*4882a593Smuzhiyun #ifndef __ARM64_KVM_SYS_REGS_LOCAL_H__
12*4882a593Smuzhiyun #define __ARM64_KVM_SYS_REGS_LOCAL_H__
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun struct sys_reg_params {
15*4882a593Smuzhiyun u8 Op0;
16*4882a593Smuzhiyun u8 Op1;
17*4882a593Smuzhiyun u8 CRn;
18*4882a593Smuzhiyun u8 CRm;
19*4882a593Smuzhiyun u8 Op2;
20*4882a593Smuzhiyun u64 regval;
21*4882a593Smuzhiyun bool is_write;
22*4882a593Smuzhiyun };
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun struct sys_reg_desc {
25*4882a593Smuzhiyun /* Sysreg string for debug */
26*4882a593Smuzhiyun const char *name;
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun enum {
29*4882a593Smuzhiyun AA32_ZEROHIGH,
30*4882a593Smuzhiyun AA32_LO,
31*4882a593Smuzhiyun AA32_HI,
32*4882a593Smuzhiyun } aarch32_map;
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun /* MRS/MSR instruction which accesses it. */
35*4882a593Smuzhiyun u8 Op0;
36*4882a593Smuzhiyun u8 Op1;
37*4882a593Smuzhiyun u8 CRn;
38*4882a593Smuzhiyun u8 CRm;
39*4882a593Smuzhiyun u8 Op2;
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun /* Trapped access from guest, if non-NULL. */
42*4882a593Smuzhiyun bool (*access)(struct kvm_vcpu *,
43*4882a593Smuzhiyun struct sys_reg_params *,
44*4882a593Smuzhiyun const struct sys_reg_desc *);
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun /* Initialization for vcpu. */
47*4882a593Smuzhiyun void (*reset)(struct kvm_vcpu *, const struct sys_reg_desc *);
48*4882a593Smuzhiyun
49*4882a593Smuzhiyun /* Index into sys_reg[], or 0 if we don't need to save it. */
50*4882a593Smuzhiyun int reg;
51*4882a593Smuzhiyun
52*4882a593Smuzhiyun /* Value (usually reset value) */
53*4882a593Smuzhiyun u64 val;
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun /* Custom get/set_user functions, fallback to generic if NULL */
56*4882a593Smuzhiyun int (*get_user)(struct kvm_vcpu *vcpu, const struct sys_reg_desc *rd,
57*4882a593Smuzhiyun const struct kvm_one_reg *reg, void __user *uaddr);
58*4882a593Smuzhiyun int (*set_user)(struct kvm_vcpu *vcpu, const struct sys_reg_desc *rd,
59*4882a593Smuzhiyun const struct kvm_one_reg *reg, void __user *uaddr);
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun /* Return mask of REG_* runtime visibility overrides */
62*4882a593Smuzhiyun unsigned int (*visibility)(const struct kvm_vcpu *vcpu,
63*4882a593Smuzhiyun const struct sys_reg_desc *rd);
64*4882a593Smuzhiyun };
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun #define REG_HIDDEN (1 << 0) /* hidden from userspace and guest */
67*4882a593Smuzhiyun #define REG_RAZ (1 << 1) /* RAZ from userspace and guest */
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun static __printf(2, 3)
print_sys_reg_msg(const struct sys_reg_params * p,char * fmt,...)70*4882a593Smuzhiyun inline void print_sys_reg_msg(const struct sys_reg_params *p,
71*4882a593Smuzhiyun char *fmt, ...)
72*4882a593Smuzhiyun {
73*4882a593Smuzhiyun va_list va;
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun va_start(va, fmt);
76*4882a593Smuzhiyun /* Look, we even formatted it for you to paste into the table! */
77*4882a593Smuzhiyun kvm_pr_unimpl("%pV { Op0(%2u), Op1(%2u), CRn(%2u), CRm(%2u), Op2(%2u), func_%s },\n",
78*4882a593Smuzhiyun &(struct va_format){ fmt, &va },
79*4882a593Smuzhiyun p->Op0, p->Op1, p->CRn, p->CRm, p->Op2, p->is_write ? "write" : "read");
80*4882a593Smuzhiyun va_end(va);
81*4882a593Smuzhiyun }
82*4882a593Smuzhiyun
print_sys_reg_instr(const struct sys_reg_params * p)83*4882a593Smuzhiyun static inline void print_sys_reg_instr(const struct sys_reg_params *p)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun /* GCC warns on an empty format string */
86*4882a593Smuzhiyun print_sys_reg_msg(p, "%s", "");
87*4882a593Smuzhiyun }
88*4882a593Smuzhiyun
ignore_write(struct kvm_vcpu * vcpu,const struct sys_reg_params * p)89*4882a593Smuzhiyun static inline bool ignore_write(struct kvm_vcpu *vcpu,
90*4882a593Smuzhiyun const struct sys_reg_params *p)
91*4882a593Smuzhiyun {
92*4882a593Smuzhiyun return true;
93*4882a593Smuzhiyun }
94*4882a593Smuzhiyun
read_zero(struct kvm_vcpu * vcpu,struct sys_reg_params * p)95*4882a593Smuzhiyun static inline bool read_zero(struct kvm_vcpu *vcpu,
96*4882a593Smuzhiyun struct sys_reg_params *p)
97*4882a593Smuzhiyun {
98*4882a593Smuzhiyun p->regval = 0;
99*4882a593Smuzhiyun return true;
100*4882a593Smuzhiyun }
101*4882a593Smuzhiyun
102*4882a593Smuzhiyun /* Reset functions */
reset_unknown(struct kvm_vcpu * vcpu,const struct sys_reg_desc * r)103*4882a593Smuzhiyun static inline void reset_unknown(struct kvm_vcpu *vcpu,
104*4882a593Smuzhiyun const struct sys_reg_desc *r)
105*4882a593Smuzhiyun {
106*4882a593Smuzhiyun BUG_ON(!r->reg);
107*4882a593Smuzhiyun BUG_ON(r->reg >= NR_SYS_REGS);
108*4882a593Smuzhiyun __vcpu_sys_reg(vcpu, r->reg) = 0x1de7ec7edbadc0deULL;
109*4882a593Smuzhiyun }
110*4882a593Smuzhiyun
reset_val(struct kvm_vcpu * vcpu,const struct sys_reg_desc * r)111*4882a593Smuzhiyun static inline void reset_val(struct kvm_vcpu *vcpu, const struct sys_reg_desc *r)
112*4882a593Smuzhiyun {
113*4882a593Smuzhiyun BUG_ON(!r->reg);
114*4882a593Smuzhiyun BUG_ON(r->reg >= NR_SYS_REGS);
115*4882a593Smuzhiyun __vcpu_sys_reg(vcpu, r->reg) = r->val;
116*4882a593Smuzhiyun }
117*4882a593Smuzhiyun
sysreg_hidden(const struct kvm_vcpu * vcpu,const struct sys_reg_desc * r)118*4882a593Smuzhiyun static inline bool sysreg_hidden(const struct kvm_vcpu *vcpu,
119*4882a593Smuzhiyun const struct sys_reg_desc *r)
120*4882a593Smuzhiyun {
121*4882a593Smuzhiyun if (likely(!r->visibility))
122*4882a593Smuzhiyun return false;
123*4882a593Smuzhiyun
124*4882a593Smuzhiyun return r->visibility(vcpu, r) & REG_HIDDEN;
125*4882a593Smuzhiyun }
126*4882a593Smuzhiyun
sysreg_visible_as_raz(const struct kvm_vcpu * vcpu,const struct sys_reg_desc * r)127*4882a593Smuzhiyun static inline bool sysreg_visible_as_raz(const struct kvm_vcpu *vcpu,
128*4882a593Smuzhiyun const struct sys_reg_desc *r)
129*4882a593Smuzhiyun {
130*4882a593Smuzhiyun if (likely(!r->visibility))
131*4882a593Smuzhiyun return false;
132*4882a593Smuzhiyun
133*4882a593Smuzhiyun return r->visibility(vcpu, r) & REG_RAZ;
134*4882a593Smuzhiyun }
135*4882a593Smuzhiyun
cmp_sys_reg(const struct sys_reg_desc * i1,const struct sys_reg_desc * i2)136*4882a593Smuzhiyun static inline int cmp_sys_reg(const struct sys_reg_desc *i1,
137*4882a593Smuzhiyun const struct sys_reg_desc *i2)
138*4882a593Smuzhiyun {
139*4882a593Smuzhiyun BUG_ON(i1 == i2);
140*4882a593Smuzhiyun if (!i1)
141*4882a593Smuzhiyun return 1;
142*4882a593Smuzhiyun else if (!i2)
143*4882a593Smuzhiyun return -1;
144*4882a593Smuzhiyun if (i1->Op0 != i2->Op0)
145*4882a593Smuzhiyun return i1->Op0 - i2->Op0;
146*4882a593Smuzhiyun if (i1->Op1 != i2->Op1)
147*4882a593Smuzhiyun return i1->Op1 - i2->Op1;
148*4882a593Smuzhiyun if (i1->CRn != i2->CRn)
149*4882a593Smuzhiyun return i1->CRn - i2->CRn;
150*4882a593Smuzhiyun if (i1->CRm != i2->CRm)
151*4882a593Smuzhiyun return i1->CRm - i2->CRm;
152*4882a593Smuzhiyun return i1->Op2 - i2->Op2;
153*4882a593Smuzhiyun }
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun const struct sys_reg_desc *find_reg_by_id(u64 id,
156*4882a593Smuzhiyun struct sys_reg_params *params,
157*4882a593Smuzhiyun const struct sys_reg_desc table[],
158*4882a593Smuzhiyun unsigned int num);
159*4882a593Smuzhiyun
160*4882a593Smuzhiyun #define AA32(_x) .aarch32_map = AA32_##_x
161*4882a593Smuzhiyun #define Op0(_x) .Op0 = _x
162*4882a593Smuzhiyun #define Op1(_x) .Op1 = _x
163*4882a593Smuzhiyun #define CRn(_x) .CRn = _x
164*4882a593Smuzhiyun #define CRm(_x) .CRm = _x
165*4882a593Smuzhiyun #define Op2(_x) .Op2 = _x
166*4882a593Smuzhiyun
167*4882a593Smuzhiyun #define SYS_DESC(reg) \
168*4882a593Smuzhiyun .name = #reg, \
169*4882a593Smuzhiyun Op0(sys_reg_Op0(reg)), Op1(sys_reg_Op1(reg)), \
170*4882a593Smuzhiyun CRn(sys_reg_CRn(reg)), CRm(sys_reg_CRm(reg)), \
171*4882a593Smuzhiyun Op2(sys_reg_Op2(reg))
172*4882a593Smuzhiyun
173*4882a593Smuzhiyun #endif /* __ARM64_KVM_SYS_REGS_LOCAL_H__ */
174