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
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.