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