1 /* SPDX-License-Identifier: GPL-2.0 */ 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 #ifndef _S390_PTRACE_H 8 #define _S390_PTRACE_H 9 10 #include <linux/bits.h> 11 #include <uapi/asm/ptrace.h> 12 #include <asm/tpi.h> 13 14 #define PIF_SYSCALL 0 /* inside a system call */ 15 #define PIF_EXECVE_PGSTE_RESTART 1 /* restart execve for PGSTE binaries */ 16 #define PIF_SYSCALL_RET_SET 2 /* return value was set via ptrace */ 17 #define PIF_GUEST_FAULT 3 /* indicates program check in sie64a */ 18 #define PIF_FTRACE_FULL_REGS 4 /* all register contents valid (ftrace) */ 19 20 #define _PIF_SYSCALL BIT(PIF_SYSCALL) 21 #define _PIF_EXECVE_PGSTE_RESTART BIT(PIF_EXECVE_PGSTE_RESTART) 22 #define _PIF_SYSCALL_RET_SET BIT(PIF_SYSCALL_RET_SET) 23 #define _PIF_GUEST_FAULT BIT(PIF_GUEST_FAULT) 24 #define _PIF_FTRACE_FULL_REGS BIT(PIF_FTRACE_FULL_REGS) 25 26 #ifndef __ASSEMBLY__ 27 28 #define PSW_KERNEL_BITS (PSW_DEFAULT_KEY | PSW_MASK_BASE | PSW_ASC_HOME | \ 29 PSW_MASK_EA | PSW_MASK_BA | PSW_MASK_DAT) 30 #define PSW_USER_BITS (PSW_MASK_DAT | PSW_MASK_IO | PSW_MASK_EXT | \ 31 PSW_DEFAULT_KEY | PSW_MASK_BASE | PSW_MASK_MCHECK | \ 32 PSW_MASK_PSTATE | PSW_ASC_PRIMARY) 33 34 struct psw_bits { 35 unsigned long : 1; 36 unsigned long per : 1; /* PER-Mask */ 37 unsigned long : 3; 38 unsigned long dat : 1; /* DAT Mode */ 39 unsigned long io : 1; /* Input/Output Mask */ 40 unsigned long ext : 1; /* External Mask */ 41 unsigned long key : 4; /* PSW Key */ 42 unsigned long : 1; 43 unsigned long mcheck : 1; /* Machine-Check Mask */ 44 unsigned long wait : 1; /* Wait State */ 45 unsigned long pstate : 1; /* Problem State */ 46 unsigned long as : 2; /* Address Space Control */ 47 unsigned long cc : 2; /* Condition Code */ 48 unsigned long pm : 4; /* Program Mask */ 49 unsigned long ri : 1; /* Runtime Instrumentation */ 50 unsigned long : 6; 51 unsigned long eaba : 2; /* Addressing Mode */ 52 unsigned long : 31; 53 unsigned long ia : 64; /* Instruction Address */ 54 }; 55 56 enum { 57 PSW_BITS_AMODE_24BIT = 0, 58 PSW_BITS_AMODE_31BIT = 1, 59 PSW_BITS_AMODE_64BIT = 3 60 }; 61 62 enum { 63 PSW_BITS_AS_PRIMARY = 0, 64 PSW_BITS_AS_ACCREG = 1, 65 PSW_BITS_AS_SECONDARY = 2, 66 PSW_BITS_AS_HOME = 3 67 }; 68 69 #define psw_bits(__psw) (*({ \ 70 typecheck(psw_t, __psw); \ 71 &(*(struct psw_bits *)(&(__psw))); \ 72 })) 73 74 #define PSW32_MASK_PER 0x40000000UL 75 #define PSW32_MASK_DAT 0x04000000UL 76 #define PSW32_MASK_IO 0x02000000UL 77 #define PSW32_MASK_EXT 0x01000000UL 78 #define PSW32_MASK_KEY 0x00F00000UL 79 #define PSW32_MASK_BASE 0x00080000UL /* Always one */ 80 #define PSW32_MASK_MCHECK 0x00040000UL 81 #define PSW32_MASK_WAIT 0x00020000UL 82 #define PSW32_MASK_PSTATE 0x00010000UL 83 #define PSW32_MASK_ASC 0x0000C000UL 84 #define PSW32_MASK_CC 0x00003000UL 85 #define PSW32_MASK_PM 0x00000f00UL 86 #define PSW32_MASK_RI 0x00000080UL 87 88 #define PSW32_ADDR_AMODE 0x80000000UL 89 #define PSW32_ADDR_INSN 0x7FFFFFFFUL 90 91 #define PSW32_DEFAULT_KEY (((u32)PAGE_DEFAULT_ACC) << 20) 92 93 #define PSW32_ASC_PRIMARY 0x00000000UL 94 #define PSW32_ASC_ACCREG 0x00004000UL 95 #define PSW32_ASC_SECONDARY 0x00008000UL 96 #define PSW32_ASC_HOME 0x0000C000UL 97 98 typedef struct { 99 unsigned int mask; 100 unsigned int addr; 101 } psw_t32 __aligned(8); 102 103 #define PGM_INT_CODE_MASK 0x7f 104 #define PGM_INT_CODE_PER 0x80 105 106 /* 107 * The pt_regs struct defines the way the registers are stored on 108 * the stack during a system call. 109 */ 110 struct pt_regs { 111 union { 112 user_pt_regs user_regs; 113 struct { 114 unsigned long args[1]; 115 psw_t psw; 116 unsigned long gprs[NUM_GPRS]; 117 }; 118 }; 119 unsigned long orig_gpr2; 120 union { 121 struct { 122 unsigned int int_code; 123 unsigned int int_parm; 124 unsigned long int_parm_long; 125 }; 126 struct tpi_info tpi_info; 127 }; 128 unsigned long flags; 129 unsigned long cr1; 130 unsigned long last_break; 131 }; 132 133 /* 134 * Program event recording (PER) register set. 135 */ 136 struct per_regs { 137 unsigned long control; /* PER control bits */ 138 unsigned long start; /* PER starting address */ 139 unsigned long end; /* PER ending address */ 140 }; 141 142 /* 143 * PER event contains information about the cause of the last PER exception. 144 */ 145 struct per_event { 146 unsigned short cause; /* PER code, ATMID and AI */ 147 unsigned long address; /* PER address */ 148 unsigned char paid; /* PER access identification */ 149 }; 150 151 /* 152 * Simplified per_info structure used to decode the ptrace user space ABI. 153 */ 154 struct per_struct_kernel { 155 unsigned long cr9; /* PER control bits */ 156 unsigned long cr10; /* PER starting address */ 157 unsigned long cr11; /* PER ending address */ 158 unsigned long bits; /* Obsolete software bits */ 159 unsigned long starting_addr; /* User specified start address */ 160 unsigned long ending_addr; /* User specified end address */ 161 unsigned short perc_atmid; /* PER trap ATMID */ 162 unsigned long address; /* PER trap instruction address */ 163 unsigned char access_id; /* PER trap access identification */ 164 }; 165 166 #define PER_EVENT_MASK 0xEB000000UL 167 168 #define PER_EVENT_BRANCH 0x80000000UL 169 #define PER_EVENT_IFETCH 0x40000000UL 170 #define PER_EVENT_STORE 0x20000000UL 171 #define PER_EVENT_STORE_REAL 0x08000000UL 172 #define PER_EVENT_TRANSACTION_END 0x02000000UL 173 #define PER_EVENT_NULLIFICATION 0x01000000UL 174 175 #define PER_CONTROL_MASK 0x00e00000UL 176 177 #define PER_CONTROL_BRANCH_ADDRESS 0x00800000UL 178 #define PER_CONTROL_SUSPENSION 0x00400000UL 179 #define PER_CONTROL_ALTERATION 0x00200000UL 180 set_pt_regs_flag(struct pt_regs * regs,int flag)181 static inline void set_pt_regs_flag(struct pt_regs *regs, int flag) 182 { 183 regs->flags |= (1UL << flag); 184 } 185 clear_pt_regs_flag(struct pt_regs * regs,int flag)186 static inline void clear_pt_regs_flag(struct pt_regs *regs, int flag) 187 { 188 regs->flags &= ~(1UL << flag); 189 } 190 test_pt_regs_flag(struct pt_regs * regs,int flag)191 static inline int test_pt_regs_flag(struct pt_regs *regs, int flag) 192 { 193 return !!(regs->flags & (1UL << flag)); 194 } 195 test_and_clear_pt_regs_flag(struct pt_regs * regs,int flag)196 static inline int test_and_clear_pt_regs_flag(struct pt_regs *regs, int flag) 197 { 198 int ret = test_pt_regs_flag(regs, flag); 199 200 clear_pt_regs_flag(regs, flag); 201 return ret; 202 } 203 204 /* 205 * These are defined as per linux/ptrace.h, which see. 206 */ 207 #define arch_has_single_step() (1) 208 #define arch_has_block_step() (1) 209 210 #define user_mode(regs) (((regs)->psw.mask & PSW_MASK_PSTATE) != 0) 211 #define instruction_pointer(regs) ((regs)->psw.addr) 212 #define user_stack_pointer(regs)((regs)->gprs[15]) 213 #define profile_pc(regs) instruction_pointer(regs) 214 regs_return_value(struct pt_regs * regs)215 static inline long regs_return_value(struct pt_regs *regs) 216 { 217 return regs->gprs[2]; 218 } 219 instruction_pointer_set(struct pt_regs * regs,unsigned long val)220 static inline void instruction_pointer_set(struct pt_regs *regs, 221 unsigned long val) 222 { 223 regs->psw.addr = val; 224 } 225 226 int regs_query_register_offset(const char *name); 227 const char *regs_query_register_name(unsigned int offset); 228 unsigned long regs_get_register(struct pt_regs *regs, unsigned int offset); 229 unsigned long regs_get_kernel_stack_nth(struct pt_regs *regs, unsigned int n); 230 231 /** 232 * regs_get_kernel_argument() - get Nth function argument in kernel 233 * @regs: pt_regs of that context 234 * @n: function argument number (start from 0) 235 * 236 * regs_get_kernel_argument() returns @n th argument of the function call. 237 */ regs_get_kernel_argument(struct pt_regs * regs,unsigned int n)238 static inline unsigned long regs_get_kernel_argument(struct pt_regs *regs, 239 unsigned int n) 240 { 241 unsigned int argoffset = STACK_FRAME_OVERHEAD / sizeof(long); 242 243 #define NR_REG_ARGUMENTS 5 244 if (n < NR_REG_ARGUMENTS) 245 return regs_get_register(regs, 2 + n); 246 n -= NR_REG_ARGUMENTS; 247 return regs_get_kernel_stack_nth(regs, argoffset + n); 248 } 249 kernel_stack_pointer(struct pt_regs * regs)250 static inline unsigned long kernel_stack_pointer(struct pt_regs *regs) 251 { 252 return regs->gprs[15]; 253 } 254 regs_set_return_value(struct pt_regs * regs,unsigned long rc)255 static inline void regs_set_return_value(struct pt_regs *regs, unsigned long rc) 256 { 257 regs->gprs[2] = rc; 258 } 259 260 #endif /* __ASSEMBLY__ */ 261 #endif /* _S390_PTRACE_H */ 262