xref: /openbmc/qemu/target/s390x/cpu.h (revision 709395f8)
1 /*
2  * S/390 virtual CPU header
3  *
4  *  Copyright (c) 2009 Ulrich Hecht
5  *  Copyright IBM Corp. 2012, 2018
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, see <http://www.gnu.org/licenses/>.
19  */
20 
21 #ifndef S390X_CPU_H
22 #define S390X_CPU_H
23 
24 #include "qemu-common.h"
25 #include "cpu-qom.h"
26 #include "cpu_models.h"
27 
28 #define TARGET_LONG_BITS 64
29 
30 #define ELF_MACHINE_UNAME "S390X"
31 
32 #define CPUArchState struct CPUS390XState
33 
34 #include "exec/cpu-defs.h"
35 
36 /* The z/Architecture has a strong memory model with some store-after-load re-ordering */
37 #define TCG_GUEST_DEFAULT_MO      (TCG_MO_ALL & ~TCG_MO_ST_LD)
38 
39 #define TARGET_PAGE_BITS 12
40 
41 #define TARGET_PHYS_ADDR_SPACE_BITS 64
42 #define TARGET_VIRT_ADDR_SPACE_BITS 64
43 
44 #include "exec/cpu-all.h"
45 
46 #define NB_MMU_MODES 4
47 #define TARGET_INSN_START_EXTRA_WORDS 1
48 
49 #define MMU_MODE0_SUFFIX _primary
50 #define MMU_MODE1_SUFFIX _secondary
51 #define MMU_MODE2_SUFFIX _home
52 #define MMU_MODE3_SUFFIX _real
53 
54 #define MMU_USER_IDX 0
55 
56 #define S390_MAX_CPUS 248
57 
58 typedef struct PSW {
59     uint64_t mask;
60     uint64_t addr;
61 } PSW;
62 
63 struct CPUS390XState {
64     uint64_t regs[16];     /* GP registers */
65     /*
66      * The floating point registers are part of the vector registers.
67      * vregs[0][0] -> vregs[15][0] are 16 floating point registers
68      */
69     CPU_DoubleU vregs[32][2];  /* vector registers */
70     uint32_t aregs[16];    /* access registers */
71     uint8_t riccb[64];     /* runtime instrumentation control */
72     uint64_t gscb[4];      /* guarded storage control */
73     uint64_t etoken;       /* etoken */
74     uint64_t etoken_extension; /* etoken extension */
75 
76     /* Fields up to this point are not cleared by initial CPU reset */
77     struct {} start_initial_reset_fields;
78 
79     uint32_t fpc;          /* floating-point control register */
80     uint32_t cc_op;
81     bool bpbc;             /* branch prediction blocking */
82 
83     float_status fpu_status; /* passed to softfloat lib */
84 
85     /* The low part of a 128-bit return, or remainder of a divide.  */
86     uint64_t retxl;
87 
88     PSW psw;
89 
90     S390CrashReason crash_reason;
91 
92     uint64_t cc_src;
93     uint64_t cc_dst;
94     uint64_t cc_vr;
95 
96     uint64_t ex_value;
97 
98     uint64_t __excp_addr;
99     uint64_t psa;
100 
101     uint32_t int_pgm_code;
102     uint32_t int_pgm_ilen;
103 
104     uint32_t int_svc_code;
105     uint32_t int_svc_ilen;
106 
107     uint64_t per_address;
108     uint16_t per_perc_atmid;
109 
110     uint64_t cregs[16]; /* control registers */
111 
112     int pending_int;
113     uint16_t external_call_addr;
114     DECLARE_BITMAP(emergency_signals, S390_MAX_CPUS);
115 
116     uint64_t ckc;
117     uint64_t cputm;
118     uint32_t todpr;
119 
120     uint64_t pfault_token;
121     uint64_t pfault_compare;
122     uint64_t pfault_select;
123 
124     uint64_t gbea;
125     uint64_t pp;
126 
127     /* Fields up to this point are cleared by a CPU reset */
128     struct {} end_reset_fields;
129 
130     CPU_COMMON
131 
132 #if !defined(CONFIG_USER_ONLY)
133     uint32_t core_id; /* PoP "CPU address", same as cpu_index */
134     uint64_t cpuid;
135 #endif
136 
137     QEMUTimer *tod_timer;
138 
139     QEMUTimer *cpu_timer;
140 
141     /*
142      * The cpu state represents the logical state of a cpu. In contrast to other
143      * architectures, there is a difference between a halt and a stop on s390.
144      * If all cpus are either stopped (including check stop) or in the disabled
145      * wait state, the vm can be shut down.
146      * The acceptable cpu_state values are defined in the CpuInfoS390State
147      * enum.
148      */
149     uint8_t cpu_state;
150 
151     /* currently processed sigp order */
152     uint8_t sigp_order;
153 
154 };
155 
156 static inline CPU_DoubleU *get_freg(CPUS390XState *cs, int nr)
157 {
158     return &cs->vregs[nr][0];
159 }
160 
161 /**
162  * S390CPU:
163  * @env: #CPUS390XState.
164  *
165  * An S/390 CPU.
166  */
167 struct S390CPU {
168     /*< private >*/
169     CPUState parent_obj;
170     /*< public >*/
171 
172     CPUS390XState env;
173     S390CPUModel *model;
174     /* needed for live migration */
175     void *irqstate;
176     uint32_t irqstate_saved_size;
177 };
178 
179 static inline S390CPU *s390_env_get_cpu(CPUS390XState *env)
180 {
181     return container_of(env, S390CPU, env);
182 }
183 
184 #define ENV_GET_CPU(e) CPU(s390_env_get_cpu(e))
185 
186 #define ENV_OFFSET offsetof(S390CPU, env)
187 
188 #ifndef CONFIG_USER_ONLY
189 extern const struct VMStateDescription vmstate_s390_cpu;
190 #endif
191 
192 /* distinguish between 24 bit and 31 bit addressing */
193 #define HIGH_ORDER_BIT 0x80000000
194 
195 /* Interrupt Codes */
196 /* Program Interrupts */
197 #define PGM_OPERATION                   0x0001
198 #define PGM_PRIVILEGED                  0x0002
199 #define PGM_EXECUTE                     0x0003
200 #define PGM_PROTECTION                  0x0004
201 #define PGM_ADDRESSING                  0x0005
202 #define PGM_SPECIFICATION               0x0006
203 #define PGM_DATA                        0x0007
204 #define PGM_FIXPT_OVERFLOW              0x0008
205 #define PGM_FIXPT_DIVIDE                0x0009
206 #define PGM_DEC_OVERFLOW                0x000a
207 #define PGM_DEC_DIVIDE                  0x000b
208 #define PGM_HFP_EXP_OVERFLOW            0x000c
209 #define PGM_HFP_EXP_UNDERFLOW           0x000d
210 #define PGM_HFP_SIGNIFICANCE            0x000e
211 #define PGM_HFP_DIVIDE                  0x000f
212 #define PGM_SEGMENT_TRANS               0x0010
213 #define PGM_PAGE_TRANS                  0x0011
214 #define PGM_TRANS_SPEC                  0x0012
215 #define PGM_SPECIAL_OP                  0x0013
216 #define PGM_OPERAND                     0x0015
217 #define PGM_TRACE_TABLE                 0x0016
218 #define PGM_SPACE_SWITCH                0x001c
219 #define PGM_HFP_SQRT                    0x001d
220 #define PGM_PC_TRANS_SPEC               0x001f
221 #define PGM_AFX_TRANS                   0x0020
222 #define PGM_ASX_TRANS                   0x0021
223 #define PGM_LX_TRANS                    0x0022
224 #define PGM_EX_TRANS                    0x0023
225 #define PGM_PRIM_AUTH                   0x0024
226 #define PGM_SEC_AUTH                    0x0025
227 #define PGM_ALET_SPEC                   0x0028
228 #define PGM_ALEN_SPEC                   0x0029
229 #define PGM_ALE_SEQ                     0x002a
230 #define PGM_ASTE_VALID                  0x002b
231 #define PGM_ASTE_SEQ                    0x002c
232 #define PGM_EXT_AUTH                    0x002d
233 #define PGM_STACK_FULL                  0x0030
234 #define PGM_STACK_EMPTY                 0x0031
235 #define PGM_STACK_SPEC                  0x0032
236 #define PGM_STACK_TYPE                  0x0033
237 #define PGM_STACK_OP                    0x0034
238 #define PGM_ASCE_TYPE                   0x0038
239 #define PGM_REG_FIRST_TRANS             0x0039
240 #define PGM_REG_SEC_TRANS               0x003a
241 #define PGM_REG_THIRD_TRANS             0x003b
242 #define PGM_MONITOR                     0x0040
243 #define PGM_PER                         0x0080
244 #define PGM_CRYPTO                      0x0119
245 
246 /* External Interrupts */
247 #define EXT_INTERRUPT_KEY               0x0040
248 #define EXT_CLOCK_COMP                  0x1004
249 #define EXT_CPU_TIMER                   0x1005
250 #define EXT_MALFUNCTION                 0x1200
251 #define EXT_EMERGENCY                   0x1201
252 #define EXT_EXTERNAL_CALL               0x1202
253 #define EXT_ETR                         0x1406
254 #define EXT_SERVICE                     0x2401
255 #define EXT_VIRTIO                      0x2603
256 
257 /* PSW defines */
258 #undef PSW_MASK_PER
259 #undef PSW_MASK_UNUSED_2
260 #undef PSW_MASK_DAT
261 #undef PSW_MASK_IO
262 #undef PSW_MASK_EXT
263 #undef PSW_MASK_KEY
264 #undef PSW_SHIFT_KEY
265 #undef PSW_MASK_MCHECK
266 #undef PSW_MASK_WAIT
267 #undef PSW_MASK_PSTATE
268 #undef PSW_MASK_ASC
269 #undef PSW_SHIFT_ASC
270 #undef PSW_MASK_CC
271 #undef PSW_MASK_PM
272 #undef PSW_SHIFT_MASK_PM
273 #undef PSW_MASK_64
274 #undef PSW_MASK_32
275 #undef PSW_MASK_ESA_ADDR
276 
277 #define PSW_MASK_PER            0x4000000000000000ULL
278 #define PSW_MASK_UNUSED_2       0x2000000000000000ULL
279 #define PSW_MASK_DAT            0x0400000000000000ULL
280 #define PSW_MASK_IO             0x0200000000000000ULL
281 #define PSW_MASK_EXT            0x0100000000000000ULL
282 #define PSW_MASK_KEY            0x00F0000000000000ULL
283 #define PSW_SHIFT_KEY           52
284 #define PSW_MASK_MCHECK         0x0004000000000000ULL
285 #define PSW_MASK_WAIT           0x0002000000000000ULL
286 #define PSW_MASK_PSTATE         0x0001000000000000ULL
287 #define PSW_MASK_ASC            0x0000C00000000000ULL
288 #define PSW_SHIFT_ASC           46
289 #define PSW_MASK_CC             0x0000300000000000ULL
290 #define PSW_MASK_PM             0x00000F0000000000ULL
291 #define PSW_SHIFT_MASK_PM       40
292 #define PSW_MASK_64             0x0000000100000000ULL
293 #define PSW_MASK_32             0x0000000080000000ULL
294 #define PSW_MASK_ESA_ADDR       0x000000007fffffffULL
295 
296 #undef PSW_ASC_PRIMARY
297 #undef PSW_ASC_ACCREG
298 #undef PSW_ASC_SECONDARY
299 #undef PSW_ASC_HOME
300 
301 #define PSW_ASC_PRIMARY         0x0000000000000000ULL
302 #define PSW_ASC_ACCREG          0x0000400000000000ULL
303 #define PSW_ASC_SECONDARY       0x0000800000000000ULL
304 #define PSW_ASC_HOME            0x0000C00000000000ULL
305 
306 /* the address space values shifted */
307 #define AS_PRIMARY              0
308 #define AS_ACCREG               1
309 #define AS_SECONDARY            2
310 #define AS_HOME                 3
311 
312 /* tb flags */
313 
314 #define FLAG_MASK_PSW_SHIFT     31
315 #define FLAG_MASK_PER           (PSW_MASK_PER    >> FLAG_MASK_PSW_SHIFT)
316 #define FLAG_MASK_DAT           (PSW_MASK_DAT    >> FLAG_MASK_PSW_SHIFT)
317 #define FLAG_MASK_PSTATE        (PSW_MASK_PSTATE >> FLAG_MASK_PSW_SHIFT)
318 #define FLAG_MASK_ASC           (PSW_MASK_ASC    >> FLAG_MASK_PSW_SHIFT)
319 #define FLAG_MASK_64            (PSW_MASK_64     >> FLAG_MASK_PSW_SHIFT)
320 #define FLAG_MASK_32            (PSW_MASK_32     >> FLAG_MASK_PSW_SHIFT)
321 #define FLAG_MASK_PSW           (FLAG_MASK_PER | FLAG_MASK_DAT | FLAG_MASK_PSTATE \
322                                 | FLAG_MASK_ASC | FLAG_MASK_64 | FLAG_MASK_32)
323 
324 /* we'll use some unused PSW positions to store CR flags in tb flags */
325 #define FLAG_MASK_AFP           (PSW_MASK_UNUSED_2 >> FLAG_MASK_PSW_SHIFT)
326 
327 /* Control register 0 bits */
328 #define CR0_LOWPROT             0x0000000010000000ULL
329 #define CR0_SECONDARY           0x0000000004000000ULL
330 #define CR0_EDAT                0x0000000000800000ULL
331 #define CR0_AFP                 0x0000000000040000ULL
332 #define CR0_EMERGENCY_SIGNAL_SC 0x0000000000004000ULL
333 #define CR0_EXTERNAL_CALL_SC    0x0000000000002000ULL
334 #define CR0_CKC_SC              0x0000000000000800ULL
335 #define CR0_CPU_TIMER_SC        0x0000000000000400ULL
336 #define CR0_SERVICE_SC          0x0000000000000200ULL
337 
338 /* Control register 14 bits */
339 #define CR14_CHANNEL_REPORT_SC  0x0000000010000000ULL
340 
341 /* MMU */
342 #define MMU_PRIMARY_IDX         0
343 #define MMU_SECONDARY_IDX       1
344 #define MMU_HOME_IDX            2
345 #define MMU_REAL_IDX            3
346 
347 static inline int cpu_mmu_index(CPUS390XState *env, bool ifetch)
348 {
349     if (!(env->psw.mask & PSW_MASK_DAT)) {
350         return MMU_REAL_IDX;
351     }
352 
353     switch (env->psw.mask & PSW_MASK_ASC) {
354     case PSW_ASC_PRIMARY:
355         return MMU_PRIMARY_IDX;
356     case PSW_ASC_SECONDARY:
357         return MMU_SECONDARY_IDX;
358     case PSW_ASC_HOME:
359         return MMU_HOME_IDX;
360     case PSW_ASC_ACCREG:
361         /* Fallthrough: access register mode is not yet supported */
362     default:
363         abort();
364     }
365 }
366 
367 static inline void cpu_get_tb_cpu_state(CPUS390XState* env, target_ulong *pc,
368                                         target_ulong *cs_base, uint32_t *flags)
369 {
370     *pc = env->psw.addr;
371     *cs_base = env->ex_value;
372     *flags = (env->psw.mask >> FLAG_MASK_PSW_SHIFT) & FLAG_MASK_PSW;
373     if (env->cregs[0] & CR0_AFP) {
374         *flags |= FLAG_MASK_AFP;
375     }
376 }
377 
378 /* PER bits from control register 9 */
379 #define PER_CR9_EVENT_BRANCH           0x80000000
380 #define PER_CR9_EVENT_IFETCH           0x40000000
381 #define PER_CR9_EVENT_STORE            0x20000000
382 #define PER_CR9_EVENT_STORE_REAL       0x08000000
383 #define PER_CR9_EVENT_NULLIFICATION    0x01000000
384 #define PER_CR9_CONTROL_BRANCH_ADDRESS 0x00800000
385 #define PER_CR9_CONTROL_ALTERATION     0x00200000
386 
387 /* PER bits from the PER CODE/ATMID/AI in lowcore */
388 #define PER_CODE_EVENT_BRANCH          0x8000
389 #define PER_CODE_EVENT_IFETCH          0x4000
390 #define PER_CODE_EVENT_STORE           0x2000
391 #define PER_CODE_EVENT_STORE_REAL      0x0800
392 #define PER_CODE_EVENT_NULLIFICATION   0x0100
393 
394 #define EXCP_EXT 1 /* external interrupt */
395 #define EXCP_SVC 2 /* supervisor call (syscall) */
396 #define EXCP_PGM 3 /* program interruption */
397 #define EXCP_RESTART 4 /* restart interrupt */
398 #define EXCP_STOP 5 /* stop interrupt */
399 #define EXCP_IO  7 /* I/O interrupt */
400 #define EXCP_MCHK 8 /* machine check */
401 
402 #define INTERRUPT_EXT_CPU_TIMER          (1 << 3)
403 #define INTERRUPT_EXT_CLOCK_COMPARATOR   (1 << 4)
404 #define INTERRUPT_EXTERNAL_CALL          (1 << 5)
405 #define INTERRUPT_EMERGENCY_SIGNAL       (1 << 6)
406 #define INTERRUPT_RESTART                (1 << 7)
407 #define INTERRUPT_STOP                   (1 << 8)
408 
409 /* Program Status Word.  */
410 #define S390_PSWM_REGNUM 0
411 #define S390_PSWA_REGNUM 1
412 /* General Purpose Registers.  */
413 #define S390_R0_REGNUM 2
414 #define S390_R1_REGNUM 3
415 #define S390_R2_REGNUM 4
416 #define S390_R3_REGNUM 5
417 #define S390_R4_REGNUM 6
418 #define S390_R5_REGNUM 7
419 #define S390_R6_REGNUM 8
420 #define S390_R7_REGNUM 9
421 #define S390_R8_REGNUM 10
422 #define S390_R9_REGNUM 11
423 #define S390_R10_REGNUM 12
424 #define S390_R11_REGNUM 13
425 #define S390_R12_REGNUM 14
426 #define S390_R13_REGNUM 15
427 #define S390_R14_REGNUM 16
428 #define S390_R15_REGNUM 17
429 /* Total Core Registers. */
430 #define S390_NUM_CORE_REGS 18
431 
432 static inline void setcc(S390CPU *cpu, uint64_t cc)
433 {
434     CPUS390XState *env = &cpu->env;
435 
436     env->psw.mask &= ~(3ull << 44);
437     env->psw.mask |= (cc & 3) << 44;
438     env->cc_op = cc;
439 }
440 
441 /* STSI */
442 #define STSI_R0_FC_MASK         0x00000000f0000000ULL
443 #define STSI_R0_FC_CURRENT      0x0000000000000000ULL
444 #define STSI_R0_FC_LEVEL_1      0x0000000010000000ULL
445 #define STSI_R0_FC_LEVEL_2      0x0000000020000000ULL
446 #define STSI_R0_FC_LEVEL_3      0x0000000030000000ULL
447 #define STSI_R0_RESERVED_MASK   0x000000000fffff00ULL
448 #define STSI_R0_SEL1_MASK       0x00000000000000ffULL
449 #define STSI_R1_RESERVED_MASK   0x00000000ffff0000ULL
450 #define STSI_R1_SEL2_MASK       0x000000000000ffffULL
451 
452 /* Basic Machine Configuration */
453 typedef struct SysIB_111 {
454     uint8_t  res1[32];
455     uint8_t  manuf[16];
456     uint8_t  type[4];
457     uint8_t  res2[12];
458     uint8_t  model[16];
459     uint8_t  sequence[16];
460     uint8_t  plant[4];
461     uint8_t  res3[3996];
462 } SysIB_111;
463 QEMU_BUILD_BUG_ON(sizeof(SysIB_111) != 4096);
464 
465 /* Basic Machine CPU */
466 typedef struct SysIB_121 {
467     uint8_t  res1[80];
468     uint8_t  sequence[16];
469     uint8_t  plant[4];
470     uint8_t  res2[2];
471     uint16_t cpu_addr;
472     uint8_t  res3[3992];
473 } SysIB_121;
474 QEMU_BUILD_BUG_ON(sizeof(SysIB_121) != 4096);
475 
476 /* Basic Machine CPUs */
477 typedef struct SysIB_122 {
478     uint8_t res1[32];
479     uint32_t capability;
480     uint16_t total_cpus;
481     uint16_t conf_cpus;
482     uint16_t standby_cpus;
483     uint16_t reserved_cpus;
484     uint16_t adjustments[2026];
485 } SysIB_122;
486 QEMU_BUILD_BUG_ON(sizeof(SysIB_122) != 4096);
487 
488 /* LPAR CPU */
489 typedef struct SysIB_221 {
490     uint8_t  res1[80];
491     uint8_t  sequence[16];
492     uint8_t  plant[4];
493     uint16_t cpu_id;
494     uint16_t cpu_addr;
495     uint8_t  res3[3992];
496 } SysIB_221;
497 QEMU_BUILD_BUG_ON(sizeof(SysIB_221) != 4096);
498 
499 /* LPAR CPUs */
500 typedef struct SysIB_222 {
501     uint8_t  res1[32];
502     uint16_t lpar_num;
503     uint8_t  res2;
504     uint8_t  lcpuc;
505     uint16_t total_cpus;
506     uint16_t conf_cpus;
507     uint16_t standby_cpus;
508     uint16_t reserved_cpus;
509     uint8_t  name[8];
510     uint32_t caf;
511     uint8_t  res3[16];
512     uint16_t dedicated_cpus;
513     uint16_t shared_cpus;
514     uint8_t  res4[4020];
515 } SysIB_222;
516 QEMU_BUILD_BUG_ON(sizeof(SysIB_222) != 4096);
517 
518 /* VM CPUs */
519 typedef struct SysIB_322 {
520     uint8_t  res1[31];
521     uint8_t  count;
522     struct {
523         uint8_t  res2[4];
524         uint16_t total_cpus;
525         uint16_t conf_cpus;
526         uint16_t standby_cpus;
527         uint16_t reserved_cpus;
528         uint8_t  name[8];
529         uint32_t caf;
530         uint8_t  cpi[16];
531         uint8_t res5[3];
532         uint8_t ext_name_encoding;
533         uint32_t res3;
534         uint8_t uuid[16];
535     } vm[8];
536     uint8_t res4[1504];
537     uint8_t ext_names[8][256];
538 } SysIB_322;
539 QEMU_BUILD_BUG_ON(sizeof(SysIB_322) != 4096);
540 
541 typedef union SysIB {
542     SysIB_111 sysib_111;
543     SysIB_121 sysib_121;
544     SysIB_122 sysib_122;
545     SysIB_221 sysib_221;
546     SysIB_222 sysib_222;
547     SysIB_322 sysib_322;
548 } SysIB;
549 QEMU_BUILD_BUG_ON(sizeof(SysIB) != 4096);
550 
551 /* MMU defines */
552 #define ASCE_ORIGIN           (~0xfffULL) /* segment table origin             */
553 #define ASCE_SUBSPACE         0x200       /* subspace group control           */
554 #define ASCE_PRIVATE_SPACE    0x100       /* private space control            */
555 #define ASCE_ALT_EVENT        0x80        /* storage alteration event control */
556 #define ASCE_SPACE_SWITCH     0x40        /* space switch event               */
557 #define ASCE_REAL_SPACE       0x20        /* real space control               */
558 #define ASCE_TYPE_MASK        0x0c        /* asce table type mask             */
559 #define ASCE_TYPE_REGION1     0x0c        /* region first table type          */
560 #define ASCE_TYPE_REGION2     0x08        /* region second table type         */
561 #define ASCE_TYPE_REGION3     0x04        /* region third table type          */
562 #define ASCE_TYPE_SEGMENT     0x00        /* segment table type               */
563 #define ASCE_TABLE_LENGTH     0x03        /* region table length              */
564 
565 #define REGION_ENTRY_ORIGIN   (~0xfffULL) /* region/segment table origin    */
566 #define REGION_ENTRY_RO       0x200       /* region/segment protection bit  */
567 #define REGION_ENTRY_TF       0xc0        /* region/segment table offset    */
568 #define REGION_ENTRY_INV      0x20        /* invalid region table entry     */
569 #define REGION_ENTRY_TYPE_MASK 0x0c       /* region/segment table type mask */
570 #define REGION_ENTRY_TYPE_R1  0x0c        /* region first table type        */
571 #define REGION_ENTRY_TYPE_R2  0x08        /* region second table type       */
572 #define REGION_ENTRY_TYPE_R3  0x04        /* region third table type        */
573 #define REGION_ENTRY_LENGTH   0x03        /* region third length            */
574 
575 #define SEGMENT_ENTRY_ORIGIN  (~0x7ffULL) /* segment table origin        */
576 #define SEGMENT_ENTRY_FC      0x400       /* format control              */
577 #define SEGMENT_ENTRY_RO      0x200       /* page protection bit         */
578 #define SEGMENT_ENTRY_INV     0x20        /* invalid segment table entry */
579 
580 #define VADDR_PX              0xff000     /* page index bits   */
581 
582 #define PAGE_RO               0x200       /* HW read-only bit  */
583 #define PAGE_INVALID          0x400       /* HW invalid bit    */
584 #define PAGE_RES0             0x800       /* bit must be zero  */
585 
586 #define SK_C                    (0x1 << 1)
587 #define SK_R                    (0x1 << 2)
588 #define SK_F                    (0x1 << 3)
589 #define SK_ACC_MASK             (0xf << 4)
590 
591 /* SIGP order codes */
592 #define SIGP_SENSE             0x01
593 #define SIGP_EXTERNAL_CALL     0x02
594 #define SIGP_EMERGENCY         0x03
595 #define SIGP_START             0x04
596 #define SIGP_STOP              0x05
597 #define SIGP_RESTART           0x06
598 #define SIGP_STOP_STORE_STATUS 0x09
599 #define SIGP_INITIAL_CPU_RESET 0x0b
600 #define SIGP_CPU_RESET         0x0c
601 #define SIGP_SET_PREFIX        0x0d
602 #define SIGP_STORE_STATUS_ADDR 0x0e
603 #define SIGP_SET_ARCH          0x12
604 #define SIGP_COND_EMERGENCY    0x13
605 #define SIGP_SENSE_RUNNING     0x15
606 #define SIGP_STORE_ADTL_STATUS 0x17
607 
608 /* SIGP condition codes */
609 #define SIGP_CC_ORDER_CODE_ACCEPTED 0
610 #define SIGP_CC_STATUS_STORED       1
611 #define SIGP_CC_BUSY                2
612 #define SIGP_CC_NOT_OPERATIONAL     3
613 
614 /* SIGP status bits */
615 #define SIGP_STAT_EQUIPMENT_CHECK   0x80000000UL
616 #define SIGP_STAT_NOT_RUNNING       0x00000400UL
617 #define SIGP_STAT_INCORRECT_STATE   0x00000200UL
618 #define SIGP_STAT_INVALID_PARAMETER 0x00000100UL
619 #define SIGP_STAT_EXT_CALL_PENDING  0x00000080UL
620 #define SIGP_STAT_STOPPED           0x00000040UL
621 #define SIGP_STAT_OPERATOR_INTERV   0x00000020UL
622 #define SIGP_STAT_CHECK_STOP        0x00000010UL
623 #define SIGP_STAT_INOPERATIVE       0x00000004UL
624 #define SIGP_STAT_INVALID_ORDER     0x00000002UL
625 #define SIGP_STAT_RECEIVER_CHECK    0x00000001UL
626 
627 /* SIGP SET ARCHITECTURE modes */
628 #define SIGP_MODE_ESA_S390 0
629 #define SIGP_MODE_Z_ARCH_TRANS_ALL_PSW 1
630 #define SIGP_MODE_Z_ARCH_TRANS_CUR_PSW 2
631 
632 /* SIGP order code mask corresponding to bit positions 56-63 */
633 #define SIGP_ORDER_MASK 0x000000ff
634 
635 /* machine check interruption code */
636 
637 /* subclasses */
638 #define MCIC_SC_SD 0x8000000000000000ULL
639 #define MCIC_SC_PD 0x4000000000000000ULL
640 #define MCIC_SC_SR 0x2000000000000000ULL
641 #define MCIC_SC_CD 0x0800000000000000ULL
642 #define MCIC_SC_ED 0x0400000000000000ULL
643 #define MCIC_SC_DG 0x0100000000000000ULL
644 #define MCIC_SC_W  0x0080000000000000ULL
645 #define MCIC_SC_CP 0x0040000000000000ULL
646 #define MCIC_SC_SP 0x0020000000000000ULL
647 #define MCIC_SC_CK 0x0010000000000000ULL
648 
649 /* subclass modifiers */
650 #define MCIC_SCM_B  0x0002000000000000ULL
651 #define MCIC_SCM_DA 0x0000000020000000ULL
652 #define MCIC_SCM_AP 0x0000000000080000ULL
653 
654 /* storage errors */
655 #define MCIC_SE_SE 0x0000800000000000ULL
656 #define MCIC_SE_SC 0x0000400000000000ULL
657 #define MCIC_SE_KE 0x0000200000000000ULL
658 #define MCIC_SE_DS 0x0000100000000000ULL
659 #define MCIC_SE_IE 0x0000000080000000ULL
660 
661 /* validity bits */
662 #define MCIC_VB_WP 0x0000080000000000ULL
663 #define MCIC_VB_MS 0x0000040000000000ULL
664 #define MCIC_VB_PM 0x0000020000000000ULL
665 #define MCIC_VB_IA 0x0000010000000000ULL
666 #define MCIC_VB_FA 0x0000008000000000ULL
667 #define MCIC_VB_VR 0x0000004000000000ULL
668 #define MCIC_VB_EC 0x0000002000000000ULL
669 #define MCIC_VB_FP 0x0000001000000000ULL
670 #define MCIC_VB_GR 0x0000000800000000ULL
671 #define MCIC_VB_CR 0x0000000400000000ULL
672 #define MCIC_VB_ST 0x0000000100000000ULL
673 #define MCIC_VB_AR 0x0000000040000000ULL
674 #define MCIC_VB_GS 0x0000000008000000ULL
675 #define MCIC_VB_PR 0x0000000000200000ULL
676 #define MCIC_VB_FC 0x0000000000100000ULL
677 #define MCIC_VB_CT 0x0000000000020000ULL
678 #define MCIC_VB_CC 0x0000000000010000ULL
679 
680 static inline uint64_t s390_build_validity_mcic(void)
681 {
682     uint64_t mcic;
683 
684     /*
685      * Indicate all validity bits (no damage) only. Other bits have to be
686      * added by the caller. (storage errors, subclasses and subclass modifiers)
687      */
688     mcic = MCIC_VB_WP | MCIC_VB_MS | MCIC_VB_PM | MCIC_VB_IA | MCIC_VB_FP |
689            MCIC_VB_GR | MCIC_VB_CR | MCIC_VB_ST | MCIC_VB_AR | MCIC_VB_PR |
690            MCIC_VB_FC | MCIC_VB_CT | MCIC_VB_CC;
691     if (s390_has_feat(S390_FEAT_VECTOR)) {
692         mcic |= MCIC_VB_VR;
693     }
694     if (s390_has_feat(S390_FEAT_GUARDED_STORAGE)) {
695         mcic |= MCIC_VB_GS;
696     }
697     return mcic;
698 }
699 
700 static inline void s390_do_cpu_full_reset(CPUState *cs, run_on_cpu_data arg)
701 {
702     cpu_reset(cs);
703 }
704 
705 static inline void s390_do_cpu_reset(CPUState *cs, run_on_cpu_data arg)
706 {
707     S390CPUClass *scc = S390_CPU_GET_CLASS(cs);
708 
709     scc->cpu_reset(cs);
710 }
711 
712 static inline void s390_do_cpu_initial_reset(CPUState *cs, run_on_cpu_data arg)
713 {
714     S390CPUClass *scc = S390_CPU_GET_CLASS(cs);
715 
716     scc->initial_cpu_reset(cs);
717 }
718 
719 static inline void s390_do_cpu_load_normal(CPUState *cs, run_on_cpu_data arg)
720 {
721     S390CPUClass *scc = S390_CPU_GET_CLASS(cs);
722 
723     scc->load_normal(cs);
724 }
725 
726 
727 /* cpu.c */
728 void s390_crypto_reset(void);
729 int s390_set_memory_limit(uint64_t new_limit, uint64_t *hw_limit);
730 void s390_cmma_reset(void);
731 void s390_enable_css_support(S390CPU *cpu);
732 int s390_assign_subch_ioeventfd(EventNotifier *notifier, uint32_t sch_id,
733                                 int vq, bool assign);
734 #ifndef CONFIG_USER_ONLY
735 unsigned int s390_cpu_set_state(uint8_t cpu_state, S390CPU *cpu);
736 #else
737 static inline unsigned int s390_cpu_set_state(uint8_t cpu_state, S390CPU *cpu)
738 {
739     return 0;
740 }
741 #endif /* CONFIG_USER_ONLY */
742 static inline uint8_t s390_cpu_get_state(S390CPU *cpu)
743 {
744     return cpu->env.cpu_state;
745 }
746 
747 
748 /* cpu_models.c */
749 void s390_cpu_list(FILE *f, fprintf_function cpu_fprintf);
750 #define cpu_list s390_cpu_list
751 void s390_set_qemu_cpu_model(uint16_t type, uint8_t gen, uint8_t ec_ga,
752                              const S390FeatInit feat_init);
753 
754 
755 /* helper.c */
756 #define S390_CPU_TYPE_SUFFIX "-" TYPE_S390_CPU
757 #define S390_CPU_TYPE_NAME(name) (name S390_CPU_TYPE_SUFFIX)
758 #define CPU_RESOLVING_TYPE TYPE_S390_CPU
759 
760 /* you can call this signal handler from your SIGBUS and SIGSEGV
761    signal handlers to inform the virtual CPU of exceptions. non zero
762    is returned if the signal was handled by the virtual CPU.  */
763 int cpu_s390x_signal_handler(int host_signum, void *pinfo, void *puc);
764 #define cpu_signal_handler cpu_s390x_signal_handler
765 
766 
767 /* interrupt.c */
768 void s390_crw_mchk(void);
769 void s390_io_interrupt(uint16_t subchannel_id, uint16_t subchannel_nr,
770                        uint32_t io_int_parm, uint32_t io_int_word);
771 /* automatically detect the instruction length */
772 #define ILEN_AUTO                   0xff
773 #define RA_IGNORED                  0
774 void s390_program_interrupt(CPUS390XState *env, uint32_t code, int ilen,
775                             uintptr_t ra);
776 /* service interrupts are floating therefore we must not pass an cpustate */
777 void s390_sclp_extint(uint32_t parm);
778 
779 /* mmu_helper.c */
780 int s390_cpu_virt_mem_rw(S390CPU *cpu, vaddr laddr, uint8_t ar, void *hostbuf,
781                          int len, bool is_write);
782 #define s390_cpu_virt_mem_read(cpu, laddr, ar, dest, len)    \
783         s390_cpu_virt_mem_rw(cpu, laddr, ar, dest, len, false)
784 #define s390_cpu_virt_mem_write(cpu, laddr, ar, dest, len)       \
785         s390_cpu_virt_mem_rw(cpu, laddr, ar, dest, len, true)
786 #define s390_cpu_virt_mem_check_read(cpu, laddr, ar, len)   \
787         s390_cpu_virt_mem_rw(cpu, laddr, ar, NULL, len, false)
788 #define s390_cpu_virt_mem_check_write(cpu, laddr, ar, len)   \
789         s390_cpu_virt_mem_rw(cpu, laddr, ar, NULL, len, true)
790 void s390_cpu_virt_mem_handle_exc(S390CPU *cpu, uintptr_t ra);
791 
792 
793 /* sigp.c */
794 int s390_cpu_restart(S390CPU *cpu);
795 void s390_init_sigp(void);
796 
797 
798 /* outside of target/s390x/ */
799 S390CPU *s390_cpu_addr2state(uint16_t cpu_addr);
800 
801 #endif
802