1 /*
2 * include/asm-s390/ptrace.h
3 *
4 * S390 version
5 * Copyright (C) 1999,2000 IBM Deutschland Entwicklung GmbH, IBM Corporation
6 * Author(s): Denis Joseph Barrow (djbarrow@de.ibm.com,barrow_dj@yahoo.com)
7 */
8
9 #ifndef _S390_PTRACE_H
10 #define _S390_PTRACE_H
11
12 /*
13 * Offsets in the user_regs_struct. They are used for the ptrace
14 * system call and in entry.S
15 */
16 #ifndef __s390x__
17
18 #define PT_PSWMASK 0x00
19 #define PT_PSWADDR 0x04
20 #define PT_GPR0 0x08
21 #define PT_GPR1 0x0C
22 #define PT_GPR2 0x10
23 #define PT_GPR3 0x14
24 #define PT_GPR4 0x18
25 #define PT_GPR5 0x1C
26 #define PT_GPR6 0x20
27 #define PT_GPR7 0x24
28 #define PT_GPR8 0x28
29 #define PT_GPR9 0x2C
30 #define PT_GPR10 0x30
31 #define PT_GPR11 0x34
32 #define PT_GPR12 0x38
33 #define PT_GPR13 0x3C
34 #define PT_GPR14 0x40
35 #define PT_GPR15 0x44
36 #define PT_ACR0 0x48
37 #define PT_ACR1 0x4C
38 #define PT_ACR2 0x50
39 #define PT_ACR3 0x54
40 #define PT_ACR4 0x58
41 #define PT_ACR5 0x5C
42 #define PT_ACR6 0x60
43 #define PT_ACR7 0x64
44 #define PT_ACR8 0x68
45 #define PT_ACR9 0x6C
46 #define PT_ACR10 0x70
47 #define PT_ACR11 0x74
48 #define PT_ACR12 0x78
49 #define PT_ACR13 0x7C
50 #define PT_ACR14 0x80
51 #define PT_ACR15 0x84
52 #define PT_ORIGGPR2 0x88
53 #define PT_FPC 0x90
54 /*
55 * A nasty fact of life that the ptrace api
56 * only supports passing of longs.
57 */
58 #define PT_FPR0_HI 0x98
59 #define PT_FPR0_LO 0x9C
60 #define PT_FPR1_HI 0xA0
61 #define PT_FPR1_LO 0xA4
62 #define PT_FPR2_HI 0xA8
63 #define PT_FPR2_LO 0xAC
64 #define PT_FPR3_HI 0xB0
65 #define PT_FPR3_LO 0xB4
66 #define PT_FPR4_HI 0xB8
67 #define PT_FPR4_LO 0xBC
68 #define PT_FPR5_HI 0xC0
69 #define PT_FPR5_LO 0xC4
70 #define PT_FPR6_HI 0xC8
71 #define PT_FPR6_LO 0xCC
72 #define PT_FPR7_HI 0xD0
73 #define PT_FPR7_LO 0xD4
74 #define PT_FPR8_HI 0xD8
75 #define PT_FPR8_LO 0XDC
76 #define PT_FPR9_HI 0xE0
77 #define PT_FPR9_LO 0xE4
78 #define PT_FPR10_HI 0xE8
79 #define PT_FPR10_LO 0xEC
80 #define PT_FPR11_HI 0xF0
81 #define PT_FPR11_LO 0xF4
82 #define PT_FPR12_HI 0xF8
83 #define PT_FPR12_LO 0xFC
84 #define PT_FPR13_HI 0x100
85 #define PT_FPR13_LO 0x104
86 #define PT_FPR14_HI 0x108
87 #define PT_FPR14_LO 0x10C
88 #define PT_FPR15_HI 0x110
89 #define PT_FPR15_LO 0x114
90 #define PT_CR_9 0x118
91 #define PT_CR_10 0x11C
92 #define PT_CR_11 0x120
93 #define PT_IEEE_IP 0x13C
94 #define PT_LASTOFF PT_IEEE_IP
95 #define PT_ENDREGS 0x140-1
96
97 #define GPR_SIZE 4
98 #define CR_SIZE 4
99
100 #define STACK_FRAME_OVERHEAD 96 /* size of minimum stack frame */
101
102 #else /* __s390x__ */
103
104 #define PT_PSWMASK 0x00
105 #define PT_PSWADDR 0x08
106 #define PT_GPR0 0x10
107 #define PT_GPR1 0x18
108 #define PT_GPR2 0x20
109 #define PT_GPR3 0x28
110 #define PT_GPR4 0x30
111 #define PT_GPR5 0x38
112 #define PT_GPR6 0x40
113 #define PT_GPR7 0x48
114 #define PT_GPR8 0x50
115 #define PT_GPR9 0x58
116 #define PT_GPR10 0x60
117 #define PT_GPR11 0x68
118 #define PT_GPR12 0x70
119 #define PT_GPR13 0x78
120 #define PT_GPR14 0x80
121 #define PT_GPR15 0x88
122 #define PT_ACR0 0x90
123 #define PT_ACR1 0x94
124 #define PT_ACR2 0x98
125 #define PT_ACR3 0x9C
126 #define PT_ACR4 0xA0
127 #define PT_ACR5 0xA4
128 #define PT_ACR6 0xA8
129 #define PT_ACR7 0xAC
130 #define PT_ACR8 0xB0
131 #define PT_ACR9 0xB4
132 #define PT_ACR10 0xB8
133 #define PT_ACR11 0xBC
134 #define PT_ACR12 0xC0
135 #define PT_ACR13 0xC4
136 #define PT_ACR14 0xC8
137 #define PT_ACR15 0xCC
138 #define PT_ORIGGPR2 0xD0
139 #define PT_FPC 0xD8
140 #define PT_FPR0 0xE0
141 #define PT_FPR1 0xE8
142 #define PT_FPR2 0xF0
143 #define PT_FPR3 0xF8
144 #define PT_FPR4 0x100
145 #define PT_FPR5 0x108
146 #define PT_FPR6 0x110
147 #define PT_FPR7 0x118
148 #define PT_FPR8 0x120
149 #define PT_FPR9 0x128
150 #define PT_FPR10 0x130
151 #define PT_FPR11 0x138
152 #define PT_FPR12 0x140
153 #define PT_FPR13 0x148
154 #define PT_FPR14 0x150
155 #define PT_FPR15 0x158
156 #define PT_CR_9 0x160
157 #define PT_CR_10 0x168
158 #define PT_CR_11 0x170
159 #define PT_IEEE_IP 0x1A8
160 #define PT_LASTOFF PT_IEEE_IP
161 #define PT_ENDREGS 0x1B0-1
162
163 #define GPR_SIZE 8
164 #define CR_SIZE 8
165
166 #define STACK_FRAME_OVERHEAD 160 /* size of minimum stack frame */
167
168 #endif /* __s390x__ */
169
170 #define NUM_GPRS 16
171 #define NUM_FPRS 16
172 #define NUM_CRS 16
173 #define NUM_ACRS 16
174
175 #define NUM_CR_WORDS 3
176
177 #define FPR_SIZE 8
178 #define FPC_SIZE 4
179 #define FPC_PAD_SIZE 4 /* gcc insists on aligning the fpregs */
180 #define ACR_SIZE 4
181
182
183 #define PTRACE_OLDSETOPTIONS 21
184
185 #ifndef __ASSEMBLY__
186 #include <linux/stddef.h>
187 #include <linux/types.h>
188
189 typedef union
190 {
191 float f;
192 double d;
193 __u64 ui;
194 struct
195 {
196 __u32 hi;
197 __u32 lo;
198 } fp;
199 } freg_t;
200
201 typedef struct
202 {
203 __u32 fpc;
204 freg_t fprs[NUM_FPRS];
205 } s390_fp_regs;
206
207 #define FPC_EXCEPTION_MASK 0xF8000000
208 #define FPC_FLAGS_MASK 0x00F80000
209 #define FPC_DXC_MASK 0x0000FF00
210 #define FPC_RM_MASK 0x00000003
211 #define FPC_VALID_MASK 0xF8F8FF03
212
213 /* this typedef defines how a Program Status Word looks like */
214 typedef struct
215 {
216 unsigned long mask;
217 unsigned long addr;
218 } __attribute__ ((aligned(8))) psw_t;
219
220 typedef struct
221 {
222 __u32 mask;
223 __u32 addr;
224 } __attribute__ ((aligned(8))) psw_compat_t;
225
226 #ifndef __s390x__
227
228 #define PSW_MASK_PER 0x40000000UL
229 #define PSW_MASK_DAT 0x04000000UL
230 #define PSW_MASK_IO 0x02000000UL
231 #define PSW_MASK_EXT 0x01000000UL
232 #define PSW_MASK_KEY 0x00F00000UL
233 #define PSW_MASK_BASE 0x00080000UL /* always one */
234 #define PSW_MASK_MCHECK 0x00040000UL
235 #define PSW_MASK_WAIT 0x00020000UL
236 #define PSW_MASK_PSTATE 0x00010000UL
237 #define PSW_MASK_ASC 0x0000C000UL
238 #define PSW_MASK_CC 0x00003000UL
239 #define PSW_MASK_PM 0x00000F00UL
240 #define PSW_MASK_EA 0x00000000UL
241 #define PSW_MASK_BA 0x00000000UL
242
243 #define PSW_MASK_USER 0x0000FF00UL
244
245 #define PSW_ADDR_AMODE 0x80000000UL
246 #define PSW_ADDR_INSN 0x7FFFFFFFUL
247
248 #define PSW_DEFAULT_KEY (((unsigned long) PAGE_DEFAULT_ACC) << 20)
249
250 #define PSW_ASC_PRIMARY 0x00000000UL
251 #define PSW_ASC_ACCREG 0x00004000UL
252 #define PSW_ASC_SECONDARY 0x00008000UL
253 #define PSW_ASC_HOME 0x0000C000UL
254
255 #else /* __s390x__ */
256
257 #define PSW_MASK_PER 0x4000000000000000UL
258 #define PSW_MASK_DAT 0x0400000000000000UL
259 #define PSW_MASK_IO 0x0200000000000000UL
260 #define PSW_MASK_EXT 0x0100000000000000UL
261 #define PSW_MASK_BASE 0x0000000000000000UL
262 #define PSW_MASK_KEY 0x00F0000000000000UL
263 #define PSW_MASK_MCHECK 0x0004000000000000UL
264 #define PSW_MASK_WAIT 0x0002000000000000UL
265 #define PSW_MASK_PSTATE 0x0001000000000000UL
266 #define PSW_MASK_ASC 0x0000C00000000000UL
267 #define PSW_MASK_CC 0x0000300000000000UL
268 #define PSW_MASK_PM 0x00000F0000000000UL
269 #define PSW_MASK_EA 0x0000000100000000UL
270 #define PSW_MASK_BA 0x0000000080000000UL
271
272 #define PSW_MASK_USER 0x0000FF0180000000UL
273
274 #define PSW_ADDR_AMODE 0x0000000000000000UL
275 #define PSW_ADDR_INSN 0xFFFFFFFFFFFFFFFFUL
276
277 #define PSW_DEFAULT_KEY (((unsigned long) PAGE_DEFAULT_ACC) << 52)
278
279 #define PSW_ASC_PRIMARY 0x0000000000000000UL
280 #define PSW_ASC_ACCREG 0x0000400000000000UL
281 #define PSW_ASC_SECONDARY 0x0000800000000000UL
282 #define PSW_ASC_HOME 0x0000C00000000000UL
283
284 #endif /* __s390x__ */
285
286 #ifdef __KERNEL__
287 extern long psw_kernel_bits;
288 extern long psw_user_bits;
289 #endif
290
291 /*
292 * The s390_regs structure is used to define the elf_gregset_t.
293 */
294 typedef struct
295 {
296 psw_t psw;
297 unsigned long gprs[NUM_GPRS];
298 unsigned int acrs[NUM_ACRS];
299 unsigned long orig_gpr2;
300 } s390_regs;
301
302 typedef struct
303 {
304 psw_compat_t psw;
305 __u32 gprs[NUM_GPRS];
306 __u32 acrs[NUM_ACRS];
307 __u32 orig_gpr2;
308 } s390_compat_regs;
309
310 typedef struct
311 {
312 __u32 gprs_high[NUM_GPRS];
313 } s390_compat_regs_high;
314
315 #ifdef __KERNEL__
316
317 /*
318 * The pt_regs struct defines the way the registers are stored on
319 * the stack during a system call.
320 */
321 struct pt_regs
322 {
323 unsigned long args[1];
324 psw_t psw;
325 unsigned long gprs[NUM_GPRS];
326 unsigned long orig_gpr2;
327 unsigned int int_code;
328 unsigned long int_parm_long;
329 };
330
331 /*
332 * Program event recording (PER) register set.
333 */
334 struct per_regs {
335 unsigned long control; /* PER control bits */
336 unsigned long start; /* PER starting address */
337 unsigned long end; /* PER ending address */
338 };
339
340 /*
341 * PER event contains information about the cause of the last PER exception.
342 */
343 struct per_event {
344 unsigned short cause; /* PER code, ATMID and AI */
345 unsigned long address; /* PER address */
346 unsigned char paid; /* PER access identification */
347 };
348
349 /*
350 * Simplified per_info structure used to decode the ptrace user space ABI.
351 */
352 struct per_struct_kernel {
353 unsigned long cr9; /* PER control bits */
354 unsigned long cr10; /* PER starting address */
355 unsigned long cr11; /* PER ending address */
356 unsigned long bits; /* Obsolete software bits */
357 unsigned long starting_addr; /* User specified start address */
358 unsigned long ending_addr; /* User specified end address */
359 unsigned short perc_atmid; /* PER trap ATMID */
360 unsigned long address; /* PER trap instruction address */
361 unsigned char access_id; /* PER trap access identification */
362 };
363
364 #define PER_EVENT_MASK 0xE9000000UL
365
366 #define PER_EVENT_BRANCH 0x80000000UL
367 #define PER_EVENT_IFETCH 0x40000000UL
368 #define PER_EVENT_STORE 0x20000000UL
369 #define PER_EVENT_STORE_REAL 0x08000000UL
370 #define PER_EVENT_NULLIFICATION 0x01000000UL
371
372 #define PER_CONTROL_MASK 0x00a00000UL
373
374 #define PER_CONTROL_BRANCH_ADDRESS 0x00800000UL
375 #define PER_CONTROL_ALTERATION 0x00200000UL
376
377 #endif
378
379 /*
380 * Now for the user space program event recording (trace) definitions.
381 * The following structures are used only for the ptrace interface, don't
382 * touch or even look at it if you don't want to modify the user-space
383 * ptrace interface. In particular stay away from it for in-kernel PER.
384 */
385 typedef struct
386 {
387 unsigned long cr[NUM_CR_WORDS];
388 } per_cr_words;
389
390 #define PER_EM_MASK 0xE8000000UL
391
392 typedef struct
393 {
394 #ifdef __s390x__
395 unsigned : 32;
396 #endif /* __s390x__ */
397 unsigned em_branching : 1;
398 unsigned em_instruction_fetch : 1;
399 /*
400 * Switching on storage alteration automatically fixes
401 * the storage alteration event bit in the users std.
402 */
403 unsigned em_storage_alteration : 1;
404 unsigned em_gpr_alt_unused : 1;
405 unsigned em_store_real_address : 1;
406 unsigned : 3;
407 unsigned branch_addr_ctl : 1;
408 unsigned : 1;
409 unsigned storage_alt_space_ctl : 1;
410 unsigned : 21;
411 unsigned long starting_addr;
412 unsigned long ending_addr;
413 } per_cr_bits;
414
415 typedef struct
416 {
417 unsigned short perc_atmid;
418 unsigned long address;
419 unsigned char access_id;
420 } per_lowcore_words;
421
422 typedef struct
423 {
424 unsigned perc_branching : 1;
425 unsigned perc_instruction_fetch : 1;
426 unsigned perc_storage_alteration : 1;
427 unsigned perc_gpr_alt_unused : 1;
428 unsigned perc_store_real_address : 1;
429 unsigned : 3;
430 unsigned atmid_psw_bit_31 : 1;
431 unsigned atmid_validity_bit : 1;
432 unsigned atmid_psw_bit_32 : 1;
433 unsigned atmid_psw_bit_5 : 1;
434 unsigned atmid_psw_bit_16 : 1;
435 unsigned atmid_psw_bit_17 : 1;
436 unsigned si : 2;
437 unsigned long address;
438 unsigned : 4;
439 unsigned access_id : 4;
440 } per_lowcore_bits;
441
442 typedef struct
443 {
444 union {
445 per_cr_words words;
446 per_cr_bits bits;
447 } control_regs;
448 /*
449 * Use these flags instead of setting em_instruction_fetch
450 * directly they are used so that single stepping can be
451 * switched on & off while not affecting other tracing
452 */
453 unsigned single_step : 1;
454 unsigned instruction_fetch : 1;
455 unsigned : 30;
456 /*
457 * These addresses are copied into cr10 & cr11 if single
458 * stepping is switched off
459 */
460 unsigned long starting_addr;
461 unsigned long ending_addr;
462 union {
463 per_lowcore_words words;
464 per_lowcore_bits bits;
465 } lowcore;
466 } per_struct;
467
468 typedef struct
469 {
470 unsigned int len;
471 unsigned long kernel_addr;
472 unsigned long process_addr;
473 } ptrace_area;
474
475 /*
476 * S/390 specific non posix ptrace requests. I chose unusual values so
477 * they are unlikely to clash with future ptrace definitions.
478 */
479 #define PTRACE_PEEKUSR_AREA 0x5000
480 #define PTRACE_POKEUSR_AREA 0x5001
481 #define PTRACE_PEEKTEXT_AREA 0x5002
482 #define PTRACE_PEEKDATA_AREA 0x5003
483 #define PTRACE_POKETEXT_AREA 0x5004
484 #define PTRACE_POKEDATA_AREA 0x5005
485 #define PTRACE_GET_LAST_BREAK 0x5006
486 #define PTRACE_PEEK_SYSTEM_CALL 0x5007
487 #define PTRACE_POKE_SYSTEM_CALL 0x5008
488
489 /*
490 * PT_PROT definition is loosely based on hppa bsd definition in
491 * gdb/hppab-nat.c
492 */
493 #define PTRACE_PROT 21
494
495 typedef enum
496 {
497 ptprot_set_access_watchpoint,
498 ptprot_set_write_watchpoint,
499 ptprot_disable_watchpoint
500 } ptprot_flags;
501
502 typedef struct
503 {
504 unsigned long lowaddr;
505 unsigned long hiaddr;
506 ptprot_flags prot;
507 } ptprot_area;
508
509 /* Sequence of bytes for breakpoint illegal instruction. */
510 #define S390_BREAKPOINT {0x0,0x1}
511 #define S390_BREAKPOINT_U16 ((__u16)0x0001)
512 #define S390_SYSCALL_OPCODE ((__u16)0x0a00)
513 #define S390_SYSCALL_SIZE 2
514
515 /*
516 * The user_regs_struct defines the way the user registers are
517 * store on the stack for signal handling.
518 */
519 struct user_regs_struct
520 {
521 psw_t psw;
522 unsigned long gprs[NUM_GPRS];
523 unsigned int acrs[NUM_ACRS];
524 unsigned long orig_gpr2;
525 s390_fp_regs fp_regs;
526 /*
527 * These per registers are in here so that gdb can modify them
528 * itself as there is no "official" ptrace interface for hardware
529 * watchpoints. This is the way intel does it.
530 */
531 per_struct per_info;
532 unsigned long ieee_instruction_pointer; /* obsolete, always 0 */
533 };
534
535 #ifdef __KERNEL__
536 /*
537 * These are defined as per linux/ptrace.h, which see.
538 */
539 #define arch_has_single_step() (1)
540
541 #define user_mode(regs) (((regs)->psw.mask & PSW_MASK_PSTATE) != 0)
542 #define instruction_pointer(regs) ((regs)->psw.addr & PSW_ADDR_INSN)
543 #define user_stack_pointer(regs)((regs)->gprs[15])
544 #define profile_pc(regs) instruction_pointer(regs)
545
regs_return_value(struct pt_regs * regs)546 static inline long regs_return_value(struct pt_regs *regs)
547 {
548 return regs->gprs[2];
549 }
550
551 int regs_query_register_offset(const char *name);
552 const char *regs_query_register_name(unsigned int offset);
553 unsigned long regs_get_register(struct pt_regs *regs, unsigned int offset);
554 unsigned long regs_get_kernel_stack_nth(struct pt_regs *regs, unsigned int n);
555
kernel_stack_pointer(struct pt_regs * regs)556 static inline unsigned long kernel_stack_pointer(struct pt_regs *regs)
557 {
558 return regs->gprs[15] & PSW_ADDR_INSN;
559 }
560
561 #endif /* __KERNEL__ */
562 #endif /* __ASSEMBLY__ */
563
564 #endif /* _S390_PTRACE_H */
565