cpu: drop old comments describing members
[qemu/ar7.git] / target / s390x / internal.h
blobb4d3583b2438b868233344b8d5aea877b3973ed9
1 /*
2 * s390x internal definitions and helpers
4 * Copyright (c) 2009 Ulrich Hecht
6 * This work is licensed under the terms of the GNU GPL, version 2 or later.
7 * See the COPYING file in the top-level directory.
8 */
10 #ifndef S390X_INTERNAL_H
11 #define S390X_INTERNAL_H
13 #include "cpu.h"
15 #ifndef CONFIG_USER_ONLY
16 typedef struct LowCore {
17 /* prefix area: defined by architecture */
18 uint32_t ccw1[2]; /* 0x000 */
19 uint32_t ccw2[4]; /* 0x008 */
20 uint8_t pad1[0x80 - 0x18]; /* 0x018 */
21 uint32_t ext_params; /* 0x080 */
22 uint16_t cpu_addr; /* 0x084 */
23 uint16_t ext_int_code; /* 0x086 */
24 uint16_t svc_ilen; /* 0x088 */
25 uint16_t svc_code; /* 0x08a */
26 uint16_t pgm_ilen; /* 0x08c */
27 uint16_t pgm_code; /* 0x08e */
28 uint32_t data_exc_code; /* 0x090 */
29 uint16_t mon_class_num; /* 0x094 */
30 uint16_t per_perc_atmid; /* 0x096 */
31 uint64_t per_address; /* 0x098 */
32 uint8_t exc_access_id; /* 0x0a0 */
33 uint8_t per_access_id; /* 0x0a1 */
34 uint8_t op_access_id; /* 0x0a2 */
35 uint8_t ar_access_id; /* 0x0a3 */
36 uint8_t pad2[0xA8 - 0xA4]; /* 0x0a4 */
37 uint64_t trans_exc_code; /* 0x0a8 */
38 uint64_t monitor_code; /* 0x0b0 */
39 uint16_t subchannel_id; /* 0x0b8 */
40 uint16_t subchannel_nr; /* 0x0ba */
41 uint32_t io_int_parm; /* 0x0bc */
42 uint32_t io_int_word; /* 0x0c0 */
43 uint8_t pad3[0xc8 - 0xc4]; /* 0x0c4 */
44 uint32_t stfl_fac_list; /* 0x0c8 */
45 uint8_t pad4[0xe8 - 0xcc]; /* 0x0cc */
46 uint32_t mcck_interruption_code[2]; /* 0x0e8 */
47 uint8_t pad5[0xf4 - 0xf0]; /* 0x0f0 */
48 uint32_t external_damage_code; /* 0x0f4 */
49 uint64_t failing_storage_address; /* 0x0f8 */
50 uint8_t pad6[0x110 - 0x100]; /* 0x100 */
51 uint64_t per_breaking_event_addr; /* 0x110 */
52 uint8_t pad7[0x120 - 0x118]; /* 0x118 */
53 PSW restart_old_psw; /* 0x120 */
54 PSW external_old_psw; /* 0x130 */
55 PSW svc_old_psw; /* 0x140 */
56 PSW program_old_psw; /* 0x150 */
57 PSW mcck_old_psw; /* 0x160 */
58 PSW io_old_psw; /* 0x170 */
59 uint8_t pad8[0x1a0 - 0x180]; /* 0x180 */
60 PSW restart_new_psw; /* 0x1a0 */
61 PSW external_new_psw; /* 0x1b0 */
62 PSW svc_new_psw; /* 0x1c0 */
63 PSW program_new_psw; /* 0x1d0 */
64 PSW mcck_new_psw; /* 0x1e0 */
65 PSW io_new_psw; /* 0x1f0 */
66 PSW return_psw; /* 0x200 */
67 uint8_t irb[64]; /* 0x210 */
68 uint64_t sync_enter_timer; /* 0x250 */
69 uint64_t async_enter_timer; /* 0x258 */
70 uint64_t exit_timer; /* 0x260 */
71 uint64_t last_update_timer; /* 0x268 */
72 uint64_t user_timer; /* 0x270 */
73 uint64_t system_timer; /* 0x278 */
74 uint64_t last_update_clock; /* 0x280 */
75 uint64_t steal_clock; /* 0x288 */
76 PSW return_mcck_psw; /* 0x290 */
77 uint8_t pad9[0xc00 - 0x2a0]; /* 0x2a0 */
78 /* System info area */
79 uint64_t save_area[16]; /* 0xc00 */
80 uint8_t pad10[0xd40 - 0xc80]; /* 0xc80 */
81 uint64_t kernel_stack; /* 0xd40 */
82 uint64_t thread_info; /* 0xd48 */
83 uint64_t async_stack; /* 0xd50 */
84 uint64_t kernel_asce; /* 0xd58 */
85 uint64_t user_asce; /* 0xd60 */
86 uint64_t panic_stack; /* 0xd68 */
87 uint64_t user_exec_asce; /* 0xd70 */
88 uint8_t pad11[0xdc0 - 0xd78]; /* 0xd78 */
90 /* SMP info area: defined by DJB */
91 uint64_t clock_comparator; /* 0xdc0 */
92 uint64_t ext_call_fast; /* 0xdc8 */
93 uint64_t percpu_offset; /* 0xdd0 */
94 uint64_t current_task; /* 0xdd8 */
95 uint32_t softirq_pending; /* 0xde0 */
96 uint32_t pad_0x0de4; /* 0xde4 */
97 uint64_t int_clock; /* 0xde8 */
98 uint8_t pad12[0xe00 - 0xdf0]; /* 0xdf0 */
100 /* 0xe00 is used as indicator for dump tools */
101 /* whether the kernel died with panic() or not */
102 uint32_t panic_magic; /* 0xe00 */
104 uint8_t pad13[0x11b8 - 0xe04]; /* 0xe04 */
106 /* 64 bit extparam used for pfault, diag 250 etc */
107 uint64_t ext_params2; /* 0x11B8 */
109 uint8_t pad14[0x1200 - 0x11C0]; /* 0x11C0 */
111 /* System info area */
113 uint64_t floating_pt_save_area[16]; /* 0x1200 */
114 uint64_t gpregs_save_area[16]; /* 0x1280 */
115 uint32_t st_status_fixed_logout[4]; /* 0x1300 */
116 uint8_t pad15[0x1318 - 0x1310]; /* 0x1310 */
117 uint32_t prefixreg_save_area; /* 0x1318 */
118 uint32_t fpt_creg_save_area; /* 0x131c */
119 uint8_t pad16[0x1324 - 0x1320]; /* 0x1320 */
120 uint32_t tod_progreg_save_area; /* 0x1324 */
121 uint32_t cpu_timer_save_area[2]; /* 0x1328 */
122 uint32_t clock_comp_save_area[2]; /* 0x1330 */
123 uint8_t pad17[0x1340 - 0x1338]; /* 0x1338 */
124 uint32_t access_regs_save_area[16]; /* 0x1340 */
125 uint64_t cregs_save_area[16]; /* 0x1380 */
127 /* align to the top of the prefix area */
129 uint8_t pad18[0x2000 - 0x1400]; /* 0x1400 */
130 } QEMU_PACKED LowCore;
131 #endif /* CONFIG_USER_ONLY */
133 #define MAX_ILEN 6
135 /* While the PoO talks about ILC (a number between 1-3) what is actually
136 stored in LowCore is shifted left one bit (an even between 2-6). As
137 this is the actual length of the insn and therefore more useful, that
138 is what we want to pass around and manipulate. To make sure that we
139 have applied this distinction universally, rename the "ILC" to "ILEN". */
140 static inline int get_ilen(uint8_t opc)
142 switch (opc >> 6) {
143 case 0:
144 return 2;
145 case 1:
146 case 2:
147 return 4;
148 default:
149 return 6;
153 /* Compute the ATMID field that is stored in the per_perc_atmid lowcore
154 entry when a PER exception is triggered. */
155 static inline uint8_t get_per_atmid(CPUS390XState *env)
157 return ((env->psw.mask & PSW_MASK_64) ? (1 << 7) : 0) |
158 (1 << 6) |
159 ((env->psw.mask & PSW_MASK_32) ? (1 << 5) : 0) |
160 ((env->psw.mask & PSW_MASK_DAT) ? (1 << 4) : 0) |
161 ((env->psw.mask & PSW_ASC_SECONDARY) ? (1 << 3) : 0) |
162 ((env->psw.mask & PSW_ASC_ACCREG) ? (1 << 2) : 0);
165 /* CC optimization */
167 /* Instead of computing the condition codes after each x86 instruction,
168 * QEMU just stores the result (called CC_DST), the type of operation
169 * (called CC_OP) and whatever operands are needed (CC_SRC and possibly
170 * CC_VR). When the condition codes are needed, the condition codes can
171 * be calculated using this information. Condition codes are not generated
172 * if they are only needed for conditional branches.
174 enum cc_op {
175 CC_OP_CONST0 = 0, /* CC is 0 */
176 CC_OP_CONST1, /* CC is 1 */
177 CC_OP_CONST2, /* CC is 2 */
178 CC_OP_CONST3, /* CC is 3 */
180 CC_OP_DYNAMIC, /* CC calculation defined by env->cc_op */
181 CC_OP_STATIC, /* CC value is env->cc_op */
183 CC_OP_NZ, /* env->cc_dst != 0 */
184 CC_OP_LTGT_32, /* signed less/greater than (32bit) */
185 CC_OP_LTGT_64, /* signed less/greater than (64bit) */
186 CC_OP_LTUGTU_32, /* unsigned less/greater than (32bit) */
187 CC_OP_LTUGTU_64, /* unsigned less/greater than (64bit) */
188 CC_OP_LTGT0_32, /* signed less/greater than 0 (32bit) */
189 CC_OP_LTGT0_64, /* signed less/greater than 0 (64bit) */
191 CC_OP_ADD_64, /* overflow on add (64bit) */
192 CC_OP_ADDU_64, /* overflow on unsigned add (64bit) */
193 CC_OP_ADDC_64, /* overflow on unsigned add-carry (64bit) */
194 CC_OP_SUB_64, /* overflow on subtraction (64bit) */
195 CC_OP_SUBU_64, /* overflow on unsigned subtraction (64bit) */
196 CC_OP_SUBB_64, /* overflow on unsigned sub-borrow (64bit) */
197 CC_OP_ABS_64, /* sign eval on abs (64bit) */
198 CC_OP_NABS_64, /* sign eval on nabs (64bit) */
200 CC_OP_ADD_32, /* overflow on add (32bit) */
201 CC_OP_ADDU_32, /* overflow on unsigned add (32bit) */
202 CC_OP_ADDC_32, /* overflow on unsigned add-carry (32bit) */
203 CC_OP_SUB_32, /* overflow on subtraction (32bit) */
204 CC_OP_SUBU_32, /* overflow on unsigned subtraction (32bit) */
205 CC_OP_SUBB_32, /* overflow on unsigned sub-borrow (32bit) */
206 CC_OP_ABS_32, /* sign eval on abs (64bit) */
207 CC_OP_NABS_32, /* sign eval on nabs (64bit) */
209 CC_OP_COMP_32, /* complement */
210 CC_OP_COMP_64, /* complement */
212 CC_OP_TM_32, /* test under mask (32bit) */
213 CC_OP_TM_64, /* test under mask (64bit) */
215 CC_OP_NZ_F32, /* FP dst != 0 (32bit) */
216 CC_OP_NZ_F64, /* FP dst != 0 (64bit) */
217 CC_OP_NZ_F128, /* FP dst != 0 (128bit) */
219 CC_OP_ICM, /* insert characters under mask */
220 CC_OP_SLA_32, /* Calculate shift left signed (32bit) */
221 CC_OP_SLA_64, /* Calculate shift left signed (64bit) */
222 CC_OP_FLOGR, /* find leftmost one */
223 CC_OP_MAX
226 /* The value of the TOD clock for 1.1.1970. */
227 #define TOD_UNIX_EPOCH 0x7d91048bca000000ULL
229 /* Converts ns to s390's clock format */
230 static inline uint64_t time2tod(uint64_t ns)
232 return (ns << 9) / 125;
235 /* Converts s390's clock format to ns */
236 static inline uint64_t tod2time(uint64_t t)
238 return (t * 125) >> 9;
241 static inline hwaddr decode_basedisp_s(CPUS390XState *env, uint32_t ipb,
242 uint8_t *ar)
244 hwaddr addr = 0;
245 uint8_t reg;
247 reg = ipb >> 28;
248 if (reg > 0) {
249 addr = env->regs[reg];
251 addr += (ipb >> 16) & 0xfff;
252 if (ar) {
253 *ar = reg;
256 return addr;
259 /* Base/displacement are at the same locations. */
260 #define decode_basedisp_rs decode_basedisp_s
262 static inline void s390_do_cpu_full_reset(CPUState *cs, run_on_cpu_data arg)
264 cpu_reset(cs);
267 static inline uint8_t s390_cpu_get_state(S390CPU *cpu)
269 return cpu->env.cpu_state;
273 /* arch_dump.c */
274 int s390_cpu_write_elf64_note(WriteCoreDumpFunction f, CPUState *cs,
275 int cpuid, void *opaque);
278 /* cc_helper.c */
279 const char *cc_name(enum cc_op cc_op);
280 void load_psw(CPUS390XState *env, uint64_t mask, uint64_t addr);
281 uint32_t calc_cc(CPUS390XState *env, uint32_t cc_op, uint64_t src, uint64_t dst,
282 uint64_t vr);
285 /* cpu.c */
286 #ifndef CONFIG_USER_ONLY
287 unsigned int s390_cpu_halt(S390CPU *cpu);
288 void s390_cpu_unhalt(S390CPU *cpu);
289 #else
290 static inline unsigned int s390_cpu_halt(S390CPU *cpu)
292 return 0;
295 static inline void s390_cpu_unhalt(S390CPU *cpu)
298 #endif /* CONFIG_USER_ONLY */
301 /* cpu_models.c */
302 void s390_cpu_model_register_props(Object *obj);
303 void s390_cpu_model_class_register_props(ObjectClass *oc);
304 void s390_realize_cpu_model(CPUState *cs, Error **errp);
305 ObjectClass *s390_cpu_class_by_name(const char *name);
308 /* excp_helper.c */
309 void s390x_cpu_debug_excp_handler(CPUState *cs);
310 void s390_cpu_do_interrupt(CPUState *cpu);
311 bool s390_cpu_exec_interrupt(CPUState *cpu, int int_req);
312 int s390_cpu_handle_mmu_fault(CPUState *cpu, vaddr address, int rw,
313 int mmu_idx);
314 void s390x_cpu_do_unaligned_access(CPUState *cs, vaddr addr,
315 MMUAccessType access_type,
316 int mmu_idx, uintptr_t retaddr);
319 /* fpu_helper.c */
320 uint32_t set_cc_nz_f32(float32 v);
321 uint32_t set_cc_nz_f64(float64 v);
322 uint32_t set_cc_nz_f128(float128 v);
325 /* gdbstub.c */
326 int s390_cpu_gdb_read_register(CPUState *cpu, uint8_t *buf, int reg);
327 int s390_cpu_gdb_write_register(CPUState *cpu, uint8_t *buf, int reg);
328 void s390_cpu_gdb_init(CPUState *cs);
331 /* helper.c */
332 void s390_cpu_dump_state(CPUState *cpu, FILE *f, fprintf_function cpu_fprintf,
333 int flags);
334 hwaddr s390_cpu_get_phys_page_debug(CPUState *cpu, vaddr addr);
335 hwaddr s390_cpu_get_phys_addr_debug(CPUState *cpu, vaddr addr);
336 uint64_t get_psw_mask(CPUS390XState *env);
337 void s390_cpu_recompute_watchpoints(CPUState *cs);
338 void s390x_tod_timer(void *opaque);
339 void s390x_cpu_timer(void *opaque);
340 S390CPU *cpu_s390x_create(const char *cpu_model, Error **errp);
341 void do_restart_interrupt(CPUS390XState *env);
342 #ifndef CONFIG_USER_ONLY
343 LowCore *cpu_map_lowcore(CPUS390XState *env);
344 void cpu_unmap_lowcore(LowCore *lowcore);
345 #endif /* CONFIG_USER_ONLY */
348 /* interrupt.c */
349 void trigger_pgm_exception(CPUS390XState *env, uint32_t code, uint32_t ilen);
350 void cpu_inject_ext(S390CPU *cpu, uint32_t code, uint32_t param,
351 uint64_t param64);
354 /* ioinst.c */
355 void ioinst_handle_xsch(S390CPU *cpu, uint64_t reg1);
356 void ioinst_handle_csch(S390CPU *cpu, uint64_t reg1);
357 void ioinst_handle_hsch(S390CPU *cpu, uint64_t reg1);
358 void ioinst_handle_msch(S390CPU *cpu, uint64_t reg1, uint32_t ipb);
359 void ioinst_handle_ssch(S390CPU *cpu, uint64_t reg1, uint32_t ipb);
360 void ioinst_handle_stcrw(S390CPU *cpu, uint32_t ipb);
361 void ioinst_handle_stsch(S390CPU *cpu, uint64_t reg1, uint32_t ipb);
362 int ioinst_handle_tsch(S390CPU *cpu, uint64_t reg1, uint32_t ipb);
363 void ioinst_handle_chsc(S390CPU *cpu, uint32_t ipb);
364 int ioinst_handle_tpi(S390CPU *cpu, uint32_t ipb);
365 void ioinst_handle_schm(S390CPU *cpu, uint64_t reg1, uint64_t reg2,
366 uint32_t ipb);
367 void ioinst_handle_rsch(S390CPU *cpu, uint64_t reg1);
368 void ioinst_handle_rchp(S390CPU *cpu, uint64_t reg1);
369 void ioinst_handle_sal(S390CPU *cpu, uint64_t reg1);
372 /* mem_helper.c */
373 target_ulong mmu_real2abs(CPUS390XState *env, target_ulong raddr);
376 /* mmu_helper.c */
377 int mmu_translate(CPUS390XState *env, target_ulong vaddr, int rw, uint64_t asc,
378 target_ulong *raddr, int *flags, bool exc);
381 /* misc_helper.c */
382 void QEMU_NORETURN runtime_exception(CPUS390XState *env, int excp,
383 uintptr_t retaddr);
384 int handle_diag_288(CPUS390XState *env, uint64_t r1, uint64_t r3);
385 void handle_diag_308(CPUS390XState *env, uint64_t r1, uint64_t r3);
388 /* translate.c */
389 void s390x_translate_init(void);
391 #endif /* S390X_INTERNAL_H */