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 246 #ifndef __ASSEMBLER__ 247 #include <linux/stddef.h> 248 #include <linux/types.h> 249 250 typedef 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 261 typedef 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 */ 273 typedef 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 */ 281 typedef 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 */ 292 typedef 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 */ 304 typedef struct { 305 unsigned long cr[NUM_CR_WORDS]; 306 } per_cr_words; 307 308 #define PER_EM_MASK 0xE8000000UL 309 310 typedef 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 332 typedef struct { 333 unsigned short perc_atmid; 334 unsigned long address; 335 unsigned char access_id; 336 } per_lowcore_words; 337 338 typedef 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 357 typedef 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 382 typedef 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 417 typedef enum { 418 ptprot_set_access_watchpoint, 419 ptprot_set_write_watchpoint, 420 ptprot_disable_watchpoint 421 } ptprot_flags; 422 423 typedef 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 */ 439 struct 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 /* _UAPI_S390_PTRACE_H */ 457