xref: /linux/arch/s390/include/uapi/asm/ptrace.h (revision 95298d63c67673c654c08952672d016212b26054)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  *  S390 version
4  *    Copyright IBM Corp. 1999, 2000
5  *    Author(s): Denis Joseph Barrow (djbarrow@de.ibm.com,barrow_dj@yahoo.com)
6  */
7 
8 #ifndef _UAPI_S390_PTRACE_H
9 #define _UAPI_S390_PTRACE_H
10 
11 /*
12  * Offsets in the user_regs_struct. They are used for the ptrace
13  * system call and in entry.S
14  */
15 #ifndef __s390x__
16 
17 #define PT_PSWMASK  0x00
18 #define PT_PSWADDR  0x04
19 #define PT_GPR0     0x08
20 #define PT_GPR1     0x0C
21 #define PT_GPR2     0x10
22 #define PT_GPR3     0x14
23 #define PT_GPR4     0x18
24 #define PT_GPR5     0x1C
25 #define PT_GPR6     0x20
26 #define PT_GPR7     0x24
27 #define PT_GPR8     0x28
28 #define PT_GPR9     0x2C
29 #define PT_GPR10    0x30
30 #define PT_GPR11    0x34
31 #define PT_GPR12    0x38
32 #define PT_GPR13    0x3C
33 #define PT_GPR14    0x40
34 #define PT_GPR15    0x44
35 #define PT_ACR0     0x48
36 #define PT_ACR1     0x4C
37 #define PT_ACR2     0x50
38 #define PT_ACR3     0x54
39 #define PT_ACR4	    0x58
40 #define PT_ACR5	    0x5C
41 #define PT_ACR6	    0x60
42 #define PT_ACR7	    0x64
43 #define PT_ACR8	    0x68
44 #define PT_ACR9	    0x6C
45 #define PT_ACR10    0x70
46 #define PT_ACR11    0x74
47 #define PT_ACR12    0x78
48 #define PT_ACR13    0x7C
49 #define PT_ACR14    0x80
50 #define PT_ACR15    0x84
51 #define PT_ORIGGPR2 0x88
52 #define PT_FPC	    0x90
53 /*
54  * A nasty fact of life that the ptrace api
55  * only supports passing of longs.
56  */
57 #define PT_FPR0_HI  0x98
58 #define PT_FPR0_LO  0x9C
59 #define PT_FPR1_HI  0xA0
60 #define PT_FPR1_LO  0xA4
61 #define PT_FPR2_HI  0xA8
62 #define PT_FPR2_LO  0xAC
63 #define PT_FPR3_HI  0xB0
64 #define PT_FPR3_LO  0xB4
65 #define PT_FPR4_HI  0xB8
66 #define PT_FPR4_LO  0xBC
67 #define PT_FPR5_HI  0xC0
68 #define PT_FPR5_LO  0xC4
69 #define PT_FPR6_HI  0xC8
70 #define PT_FPR6_LO  0xCC
71 #define PT_FPR7_HI  0xD0
72 #define PT_FPR7_LO  0xD4
73 #define PT_FPR8_HI  0xD8
74 #define PT_FPR8_LO  0XDC
75 #define PT_FPR9_HI  0xE0
76 #define PT_FPR9_LO  0xE4
77 #define PT_FPR10_HI 0xE8
78 #define PT_FPR10_LO 0xEC
79 #define PT_FPR11_HI 0xF0
80 #define PT_FPR11_LO 0xF4
81 #define PT_FPR12_HI 0xF8
82 #define PT_FPR12_LO 0xFC
83 #define PT_FPR13_HI 0x100
84 #define PT_FPR13_LO 0x104
85 #define PT_FPR14_HI 0x108
86 #define PT_FPR14_LO 0x10C
87 #define PT_FPR15_HI 0x110
88 #define PT_FPR15_LO 0x114
89 #define PT_CR_9	    0x118
90 #define PT_CR_10    0x11C
91 #define PT_CR_11    0x120
92 #define PT_IEEE_IP  0x13C
93 #define PT_LASTOFF  PT_IEEE_IP
94 #define PT_ENDREGS  0x140-1
95 
96 #define GPR_SIZE	4
97 #define CR_SIZE		4
98 
99 #define STACK_FRAME_OVERHEAD	96	/* size of minimum stack frame */
100 
101 #else /* __s390x__ */
102 
103 #define PT_PSWMASK  0x00
104 #define PT_PSWADDR  0x08
105 #define PT_GPR0     0x10
106 #define PT_GPR1     0x18
107 #define PT_GPR2     0x20
108 #define PT_GPR3     0x28
109 #define PT_GPR4     0x30
110 #define PT_GPR5     0x38
111 #define PT_GPR6     0x40
112 #define PT_GPR7     0x48
113 #define PT_GPR8     0x50
114 #define PT_GPR9     0x58
115 #define PT_GPR10    0x60
116 #define PT_GPR11    0x68
117 #define PT_GPR12    0x70
118 #define PT_GPR13    0x78
119 #define PT_GPR14    0x80
120 #define PT_GPR15    0x88
121 #define PT_ACR0     0x90
122 #define PT_ACR1     0x94
123 #define PT_ACR2     0x98
124 #define PT_ACR3     0x9C
125 #define PT_ACR4	    0xA0
126 #define PT_ACR5	    0xA4
127 #define PT_ACR6	    0xA8
128 #define PT_ACR7	    0xAC
129 #define PT_ACR8	    0xB0
130 #define PT_ACR9	    0xB4
131 #define PT_ACR10    0xB8
132 #define PT_ACR11    0xBC
133 #define PT_ACR12    0xC0
134 #define PT_ACR13    0xC4
135 #define PT_ACR14    0xC8
136 #define PT_ACR15    0xCC
137 #define PT_ORIGGPR2 0xD0
138 #define PT_FPC	    0xD8
139 #define PT_FPR0     0xE0
140 #define PT_FPR1     0xE8
141 #define PT_FPR2     0xF0
142 #define PT_FPR3     0xF8
143 #define PT_FPR4     0x100
144 #define PT_FPR5     0x108
145 #define PT_FPR6     0x110
146 #define PT_FPR7     0x118
147 #define PT_FPR8     0x120
148 #define PT_FPR9     0x128
149 #define PT_FPR10    0x130
150 #define PT_FPR11    0x138
151 #define PT_FPR12    0x140
152 #define PT_FPR13    0x148
153 #define PT_FPR14    0x150
154 #define PT_FPR15    0x158
155 #define PT_CR_9     0x160
156 #define PT_CR_10    0x168
157 #define PT_CR_11    0x170
158 #define PT_IEEE_IP  0x1A8
159 #define PT_LASTOFF  PT_IEEE_IP
160 #define PT_ENDREGS  0x1B0-1
161 
162 #define GPR_SIZE	8
163 #define CR_SIZE		8
164 
165 #define STACK_FRAME_OVERHEAD	160	 /* size of minimum stack frame */
166 
167 #endif /* __s390x__ */
168 
169 #define NUM_GPRS	16
170 #define NUM_FPRS	16
171 #define NUM_CRS		16
172 #define NUM_ACRS	16
173 
174 #define NUM_CR_WORDS	3
175 
176 #define FPR_SIZE	8
177 #define FPC_SIZE	4
178 #define FPC_PAD_SIZE	4 /* gcc insists on aligning the fpregs */
179 #define ACR_SIZE	4
180 
181 
182 #define PTRACE_OLDSETOPTIONS	     21
183 
184 #ifndef __ASSEMBLY__
185 #include <linux/stddef.h>
186 #include <linux/types.h>
187 
188 typedef union {
189 	float	f;
190 	double	d;
191 	__u64	ui;
192 	struct
193 	{
194 		__u32 hi;
195 		__u32 lo;
196 	} fp;
197 } freg_t;
198 
199 typedef struct {
200 	__u32	fpc;
201 	__u32	pad;
202 	freg_t	fprs[NUM_FPRS];
203 } s390_fp_regs;
204 
205 #define FPC_EXCEPTION_MASK	0xF8000000
206 #define FPC_FLAGS_MASK		0x00F80000
207 #define FPC_DXC_MASK		0x0000FF00
208 #define FPC_RM_MASK		0x00000003
209 
210 /* this typedef defines how a Program Status Word looks like */
211 typedef struct {
212 	unsigned long mask;
213 	unsigned long addr;
214 } __attribute__ ((aligned(8))) psw_t;
215 
216 #ifndef __s390x__
217 
218 #define PSW_MASK_PER		0x40000000UL
219 #define PSW_MASK_DAT		0x04000000UL
220 #define PSW_MASK_IO		0x02000000UL
221 #define PSW_MASK_EXT		0x01000000UL
222 #define PSW_MASK_KEY		0x00F00000UL
223 #define PSW_MASK_BASE		0x00080000UL	/* always one */
224 #define PSW_MASK_MCHECK		0x00040000UL
225 #define PSW_MASK_WAIT		0x00020000UL
226 #define PSW_MASK_PSTATE		0x00010000UL
227 #define PSW_MASK_ASC		0x0000C000UL
228 #define PSW_MASK_CC		0x00003000UL
229 #define PSW_MASK_PM		0x00000F00UL
230 #define PSW_MASK_RI		0x00000000UL
231 #define PSW_MASK_EA		0x00000000UL
232 #define PSW_MASK_BA		0x00000000UL
233 
234 #define PSW_MASK_USER		0x0000FF00UL
235 
236 #define PSW_ADDR_AMODE		0x80000000UL
237 #define PSW_ADDR_INSN		0x7FFFFFFFUL
238 
239 #define PSW_DEFAULT_KEY		(((unsigned long) PAGE_DEFAULT_ACC) << 20)
240 
241 #define PSW_ASC_PRIMARY		0x00000000UL
242 #define PSW_ASC_ACCREG		0x00004000UL
243 #define PSW_ASC_SECONDARY	0x00008000UL
244 #define PSW_ASC_HOME		0x0000C000UL
245 
246 #else /* __s390x__ */
247 
248 #define PSW_MASK_PER		0x4000000000000000UL
249 #define PSW_MASK_DAT		0x0400000000000000UL
250 #define PSW_MASK_IO		0x0200000000000000UL
251 #define PSW_MASK_EXT		0x0100000000000000UL
252 #define PSW_MASK_BASE		0x0000000000000000UL
253 #define PSW_MASK_KEY		0x00F0000000000000UL
254 #define PSW_MASK_MCHECK		0x0004000000000000UL
255 #define PSW_MASK_WAIT		0x0002000000000000UL
256 #define PSW_MASK_PSTATE		0x0001000000000000UL
257 #define PSW_MASK_ASC		0x0000C00000000000UL
258 #define PSW_MASK_CC		0x0000300000000000UL
259 #define PSW_MASK_PM		0x00000F0000000000UL
260 #define PSW_MASK_RI		0x0000008000000000UL
261 #define PSW_MASK_EA		0x0000000100000000UL
262 #define PSW_MASK_BA		0x0000000080000000UL
263 
264 #define PSW_MASK_USER		0x0000FF0180000000UL
265 
266 #define PSW_ADDR_AMODE		0x0000000000000000UL
267 #define PSW_ADDR_INSN		0xFFFFFFFFFFFFFFFFUL
268 
269 #define PSW_DEFAULT_KEY		(((unsigned long) PAGE_DEFAULT_ACC) << 52)
270 
271 #define PSW_ASC_PRIMARY		0x0000000000000000UL
272 #define PSW_ASC_ACCREG		0x0000400000000000UL
273 #define PSW_ASC_SECONDARY	0x0000800000000000UL
274 #define PSW_ASC_HOME		0x0000C00000000000UL
275 
276 #endif /* __s390x__ */
277 
278 
279 /*
280  * The s390_regs structure is used to define the elf_gregset_t.
281  */
282 typedef struct {
283 	psw_t psw;
284 	unsigned long gprs[NUM_GPRS];
285 	unsigned int  acrs[NUM_ACRS];
286 	unsigned long orig_gpr2;
287 } s390_regs;
288 
289 /*
290  * The user_pt_regs structure exports the beginning of
291  * the in-kernel pt_regs structure to user space.
292  */
293 typedef struct {
294 	unsigned long args[1];
295 	psw_t psw;
296 	unsigned long gprs[NUM_GPRS];
297 } user_pt_regs;
298 
299 /*
300  * Now for the user space program event recording (trace) definitions.
301  * The following structures are used only for the ptrace interface, don't
302  * touch or even look at it if you don't want to modify the user-space
303  * ptrace interface. In particular stay away from it for in-kernel PER.
304  */
305 typedef struct {
306 	unsigned long cr[NUM_CR_WORDS];
307 } per_cr_words;
308 
309 #define PER_EM_MASK 0xE8000000UL
310 
311 typedef struct {
312 #ifdef __s390x__
313 	unsigned		       : 32;
314 #endif /* __s390x__ */
315 	unsigned em_branching	       : 1;
316 	unsigned em_instruction_fetch  : 1;
317 	/*
318 	 * Switching on storage alteration automatically fixes
319 	 * the storage alteration event bit in the users std.
320 	 */
321 	unsigned em_storage_alteration : 1;
322 	unsigned em_gpr_alt_unused     : 1;
323 	unsigned em_store_real_address : 1;
324 	unsigned		       : 3;
325 	unsigned branch_addr_ctl       : 1;
326 	unsigned		       : 1;
327 	unsigned storage_alt_space_ctl : 1;
328 	unsigned		       : 21;
329 	unsigned long starting_addr;
330 	unsigned long ending_addr;
331 } per_cr_bits;
332 
333 typedef struct {
334 	unsigned short perc_atmid;
335 	unsigned long address;
336 	unsigned char access_id;
337 } per_lowcore_words;
338 
339 typedef struct {
340 	unsigned perc_branching		 : 1;
341 	unsigned perc_instruction_fetch  : 1;
342 	unsigned perc_storage_alteration : 1;
343 	unsigned perc_gpr_alt_unused	 : 1;
344 	unsigned perc_store_real_address : 1;
345 	unsigned			 : 3;
346 	unsigned atmid_psw_bit_31	 : 1;
347 	unsigned atmid_validity_bit	 : 1;
348 	unsigned atmid_psw_bit_32	 : 1;
349 	unsigned atmid_psw_bit_5	 : 1;
350 	unsigned atmid_psw_bit_16	 : 1;
351 	unsigned atmid_psw_bit_17	 : 1;
352 	unsigned si			 : 2;
353 	unsigned long address;
354 	unsigned			 : 4;
355 	unsigned access_id		 : 4;
356 } per_lowcore_bits;
357 
358 typedef struct {
359 	union {
360 		per_cr_words   words;
361 		per_cr_bits    bits;
362 	} control_regs;
363 	/*
364 	 * The single_step and instruction_fetch bits are obsolete,
365 	 * the kernel always sets them to zero. To enable single
366 	 * stepping use ptrace(PTRACE_SINGLESTEP) instead.
367 	 */
368 	unsigned  single_step	    : 1;
369 	unsigned  instruction_fetch : 1;
370 	unsigned		    : 30;
371 	/*
372 	 * These addresses are copied into cr10 & cr11 if single
373 	 * stepping is switched off
374 	 */
375 	unsigned long starting_addr;
376 	unsigned long ending_addr;
377 	union {
378 		per_lowcore_words words;
379 		per_lowcore_bits  bits;
380 	} lowcore;
381 } per_struct;
382 
383 typedef struct {
384 	unsigned int  len;
385 	unsigned long kernel_addr;
386 	unsigned long process_addr;
387 } ptrace_area;
388 
389 /*
390  * S/390 specific non posix ptrace requests. I chose unusual values so
391  * they are unlikely to clash with future ptrace definitions.
392  */
393 #define PTRACE_PEEKUSR_AREA	      0x5000
394 #define PTRACE_POKEUSR_AREA	      0x5001
395 #define PTRACE_PEEKTEXT_AREA	      0x5002
396 #define PTRACE_PEEKDATA_AREA	      0x5003
397 #define PTRACE_POKETEXT_AREA	      0x5004
398 #define PTRACE_POKEDATA_AREA	      0x5005
399 #define PTRACE_GET_LAST_BREAK	      0x5006
400 #define PTRACE_PEEK_SYSTEM_CALL       0x5007
401 #define PTRACE_POKE_SYSTEM_CALL	      0x5008
402 #define PTRACE_ENABLE_TE	      0x5009
403 #define PTRACE_DISABLE_TE	      0x5010
404 #define PTRACE_TE_ABORT_RAND	      0x5011
405 
406 /*
407  * The numbers chosen here are somewhat arbitrary but absolutely MUST
408  * not overlap with any of the number assigned in <linux/ptrace.h>.
409  */
410 #define PTRACE_SINGLEBLOCK	12	/* resume execution until next branch */
411 
412 /*
413  * PT_PROT definition is loosely based on hppa bsd definition in
414  * gdb/hppab-nat.c
415  */
416 #define PTRACE_PROT			  21
417 
418 typedef enum {
419 	ptprot_set_access_watchpoint,
420 	ptprot_set_write_watchpoint,
421 	ptprot_disable_watchpoint
422 } ptprot_flags;
423 
424 typedef struct {
425 	unsigned long lowaddr;
426 	unsigned long hiaddr;
427 	ptprot_flags prot;
428 } ptprot_area;
429 
430 /* Sequence of bytes for breakpoint illegal instruction.  */
431 #define S390_BREAKPOINT     {0x0,0x1}
432 #define S390_BREAKPOINT_U16 ((__u16)0x0001)
433 #define S390_SYSCALL_OPCODE ((__u16)0x0a00)
434 #define S390_SYSCALL_SIZE   2
435 
436 /*
437  * The user_regs_struct defines the way the user registers are
438  * store on the stack for signal handling.
439  */
440 struct user_regs_struct {
441 	psw_t psw;
442 	unsigned long gprs[NUM_GPRS];
443 	unsigned int  acrs[NUM_ACRS];
444 	unsigned long orig_gpr2;
445 	s390_fp_regs fp_regs;
446 	/*
447 	 * These per registers are in here so that gdb can modify them
448 	 * itself as there is no "official" ptrace interface for hardware
449 	 * watchpoints. This is the way intel does it.
450 	 */
451 	per_struct per_info;
452 	unsigned long ieee_instruction_pointer;	/* obsolete, always 0 */
453 };
454 
455 #endif /* __ASSEMBLY__ */
456 
457 #endif /* _UAPI_S390_PTRACE_H */
458