master
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 _S390_PTRACE_H
9#define _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
246#ifndef __ASSEMBLER__
247#include <linux/stddef.h>
248#include <linux/types.h>
249
250typedef union {
251 float f;
252 double d;
253 __u64 ui;
254 struct
255 {
256 __u32 hi;
257 __u32 lo;
258 } fp;
259} freg_t;
260
261typedef struct {
262 __u32 fpc;
263 __u32 pad;
264 freg_t fprs[NUM_FPRS];
265} s390_fp_regs;
266
267#define FPC_EXCEPTION_MASK 0xF8000000
268#define FPC_FLAGS_MASK 0x00F80000
269#define FPC_DXC_MASK 0x0000FF00
270#define FPC_RM_MASK 0x00000003
271
272/* this typedef defines how a Program Status Word looks like */
273typedef struct {
274 unsigned long mask;
275 unsigned long addr;
276} __attribute__ ((aligned(8))) psw_t;
277
278/*
279 * The s390_regs structure is used to define the elf_gregset_t.
280 */
281typedef struct {
282 psw_t psw;
283 unsigned long gprs[NUM_GPRS];
284 unsigned int acrs[NUM_ACRS];
285 unsigned long orig_gpr2;
286} s390_regs;
287
288/*
289 * The user_pt_regs structure exports the beginning of
290 * the in-kernel pt_regs structure to user space.
291 */
292typedef struct {
293 unsigned long args[1];
294 psw_t psw;
295 unsigned long gprs[NUM_GPRS];
296} user_pt_regs;
297
298/*
299 * Now for the user space program event recording (trace) definitions.
300 * The following structures are used only for the ptrace interface, don't
301 * touch or even look at it if you don't want to modify the user-space
302 * ptrace interface. In particular stay away from it for in-kernel PER.
303 */
304typedef struct {
305 unsigned long cr[NUM_CR_WORDS];
306} per_cr_words;
307
308#define PER_EM_MASK 0xE8000000UL
309
310typedef struct {
311#ifdef __s390x__
312 unsigned : 32;
313#endif /* __s390x__ */
314 unsigned em_branching : 1;
315 unsigned em_instruction_fetch : 1;
316 /*
317 * Switching on storage alteration automatically fixes
318 * the storage alteration event bit in the users std.
319 */
320 unsigned em_storage_alteration : 1;
321 unsigned em_gpr_alt_unused : 1;
322 unsigned em_store_real_address : 1;
323 unsigned : 3;
324 unsigned branch_addr_ctl : 1;
325 unsigned : 1;
326 unsigned storage_alt_space_ctl : 1;
327 unsigned : 21;
328 unsigned long starting_addr;
329 unsigned long ending_addr;
330} per_cr_bits;
331
332typedef struct {
333 unsigned short perc_atmid;
334 unsigned long address;
335 unsigned char access_id;
336} per_lowcore_words;
337
338typedef struct {
339 unsigned perc_branching : 1;
340 unsigned perc_instruction_fetch : 1;
341 unsigned perc_storage_alteration : 1;
342 unsigned perc_gpr_alt_unused : 1;
343 unsigned perc_store_real_address : 1;
344 unsigned : 3;
345 unsigned atmid_psw_bit_31 : 1;
346 unsigned atmid_validity_bit : 1;
347 unsigned atmid_psw_bit_32 : 1;
348 unsigned atmid_psw_bit_5 : 1;
349 unsigned atmid_psw_bit_16 : 1;
350 unsigned atmid_psw_bit_17 : 1;
351 unsigned si : 2;
352 unsigned long address;
353 unsigned : 4;
354 unsigned access_id : 4;
355} per_lowcore_bits;
356
357typedef struct {
358 union {
359 per_cr_words words;
360 per_cr_bits bits;
361 } control_regs;
362 /*
363 * The single_step and instruction_fetch bits are obsolete,
364 * the kernel always sets them to zero. To enable single
365 * stepping use ptrace(PTRACE_SINGLESTEP) instead.
366 */
367 unsigned single_step : 1;
368 unsigned instruction_fetch : 1;
369 unsigned : 30;
370 /*
371 * These addresses are copied into cr10 & cr11 if single
372 * stepping is switched off
373 */
374 unsigned long starting_addr;
375 unsigned long ending_addr;
376 union {
377 per_lowcore_words words;
378 per_lowcore_bits bits;
379 } lowcore;
380} per_struct;
381
382typedef struct {
383 unsigned int len;
384 unsigned long kernel_addr;
385 unsigned long process_addr;
386} ptrace_area;
387
388/*
389 * S/390 specific non posix ptrace requests. I chose unusual values so
390 * they are unlikely to clash with future ptrace definitions.
391 */
392#define PTRACE_PEEKUSR_AREA 0x5000
393#define PTRACE_POKEUSR_AREA 0x5001
394#define PTRACE_PEEKTEXT_AREA 0x5002
395#define PTRACE_PEEKDATA_AREA 0x5003
396#define PTRACE_POKETEXT_AREA 0x5004
397#define PTRACE_POKEDATA_AREA 0x5005
398#define PTRACE_GET_LAST_BREAK 0x5006
399#define PTRACE_PEEK_SYSTEM_CALL 0x5007
400#define PTRACE_POKE_SYSTEM_CALL 0x5008
401#define PTRACE_ENABLE_TE 0x5009
402#define PTRACE_DISABLE_TE 0x5010
403#define PTRACE_TE_ABORT_RAND 0x5011
404
405/*
406 * The numbers chosen here are somewhat arbitrary but absolutely MUST
407 * not overlap with any of the number assigned in <linux/ptrace.h>.
408 */
409#define PTRACE_SINGLEBLOCK 12 /* resume execution until next branch */
410
411/*
412 * PT_PROT definition is loosely based on hppa bsd definition in
413 * gdb/hppab-nat.c
414 */
415#define PTRACE_PROT 21
416
417typedef enum {
418 ptprot_set_access_watchpoint,
419 ptprot_set_write_watchpoint,
420 ptprot_disable_watchpoint
421} ptprot_flags;
422
423typedef struct {
424 unsigned long lowaddr;
425 unsigned long hiaddr;
426 ptprot_flags prot;
427} ptprot_area;
428
429/* Sequence of bytes for breakpoint illegal instruction. */
430#define S390_BREAKPOINT {0x0,0x1}
431#define S390_BREAKPOINT_U16 ((__u16)0x0001)
432#define S390_SYSCALL_OPCODE ((__u16)0x0a00)
433#define S390_SYSCALL_SIZE 2
434
435/*
436 * The user_regs_struct defines the way the user registers are
437 * store on the stack for signal handling.
438 */
439struct user_regs_struct {
440 psw_t psw;
441 unsigned long gprs[NUM_GPRS];
442 unsigned int acrs[NUM_ACRS];
443 unsigned long orig_gpr2;
444 s390_fp_regs fp_regs;
445 /*
446 * These per registers are in here so that gdb can modify them
447 * itself as there is no "official" ptrace interface for hardware
448 * watchpoints. This is the way intel does it.
449 */
450 per_struct per_info;
451 unsigned long ieee_instruction_pointer; /* obsolete, always 0 */
452};
453
454#endif /* __ASSEMBLER__ */
455
456#endif /* _S390_PTRACE_H */