Home | History | Annotate | Line # | Download | only in include
      1 /* $NetBSD: db_machdep.h,v 1.16 2021/10/31 22:06:32 skrll Exp $ */
      2 
      3 /*-
      4  * Copyright (c) 2014 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Matt Thomas of 3am Software Foundry.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 /*-
     33  * Copyright (c) 2014 Andrew Turner
     34  * Copyright (c) 2014-2015 The FreeBSD Foundation
     35  * All rights reserved.
     36  *
     37  * This software was developed by Semihalf under
     38  * sponsorship from the FreeBSD Foundation.
     39  *
     40  * Redistribution and use in source and binary forms, with or without
     41  * modification, are permitted provided that the following conditions
     42  * are met:
     43  * 1. Redistributions of source code must retain the above copyright
     44  *    notice, this list of conditions and the following disclaimer.
     45  * 2. Redistributions in binary form must reproduce the above copyright
     46  *    notice, this list of conditions and the following disclaimer in the
     47  *    documentation and/or other materials provided with the distribution.
     48  *
     49  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
     50  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     51  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     52  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     53  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     54  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     55  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     56  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     57  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     58  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     59  * SUCH DAMAGE.
     60  *
     61  * $FreeBSD: head/sys/arm64/include/db_machdep.h 316001 2017-03-26 18:46:35Z bde $
     62  */
     63 
     64 #ifndef _AARCH64_DB_MACHDEP_H_
     65 #define _AARCH64_DB_MACHDEP_H_
     66 
     67 #ifdef __aarch64__
     68 
     69 #include <sys/types.h>
     70 
     71 #include <uvm/uvm.h>
     72 
     73 #include <aarch64/frame.h>
     74 #include <aarch64/pmap.h>
     75 
     76 #include <ddb/db_user.h>
     77 
     78 typedef long long int db_expr_t;
     79 #define DDB_EXPR_FMT "ll"
     80 typedef uintptr_t db_addr_t;
     81 
     82 #define BKPT_ADDR(addr)		(addr)
     83 #define BKPT_SIZE		4
     84 #ifdef __AARCH64EB__
     85 #define BKPT_INSN		0x000020d4	/* brk #0 */
     86 #else
     87 #define BKPT_INSN		0xd4200000	/* brk #0 */
     88 #endif
     89 #define BKPT_SET(insn, addr)	(BKPT_INSN)
     90 
     91 typedef struct trapframe db_regs_t;
     92 extern db_regs_t ddb_regs;
     93 #define DDB_REGS		(&ddb_regs)
     94 #define PC_REGS(tf)		((tf)->tf_pc)
     95 
     96 int kdb_trap(int, struct trapframe *);
     97 #define DB_TRAP_UNKNOWN		0
     98 #define DB_TRAP_BREAKPOINT	1
     99 #define DB_TRAP_BKPT_INSN	2
    100 #define DB_TRAP_WATCHPOINT	3
    101 #define DB_TRAP_SW_STEP		4
    102 
    103 #define IS_BREAKPOINT_TRAP(type, code) \
    104 	((type) == DB_TRAP_BKPT_INSN)
    105 #define IS_WATCHPOINT_TRAP(type, code) \
    106 	((type) == DB_TRAP_BREAKPOINT || (type) == DB_TRAP_WATCHPOINT)
    107 
    108 static inline bool
    109 inst_return(db_expr_t insn)
    110 {
    111 	LE32TOH(insn);
    112 	return ((insn & 0xfffffc1f) == 0xd65f0000);	/* ret xN */
    113 }
    114 
    115 static inline bool
    116 inst_trap_return(db_expr_t insn)
    117 {
    118 	LE32TOH(insn);
    119 	return insn == 0xd69f03e0;			/* eret */
    120 }
    121 
    122 static inline bool
    123 inst_call(db_expr_t insn)
    124 {
    125 	LE32TOH(insn);
    126 	return ((insn & 0xfc000000) == 0x94000000)	/* bl */
    127 	    || ((insn & 0xfffffc1f) == 0xd63f0000);	/* blr */
    128 }
    129 
    130 static inline bool
    131 inst_load(db_expr_t insn)
    132 {
    133 	LE32TOH(insn);
    134 	return
    135 	    ((insn & 0xffe00c00) == 0xb8800000) ||	/* ldursw */
    136 	    /* ldrsw imm{pre,post}idx */
    137 	    ((insn & 0xffe00400) == 0xb8800400) ||
    138 	    ((insn & 0xffc00c00) == 0xb8800800) ||	/* ldrsw reg,ldtrsw */
    139 	    ((insn & 0xffc00000) == 0xb9800000) ||	/* ldrsw immunsign */
    140 	    ((insn & 0xffc00000) == 0x39400000) ||	/* ldrb immunsign */
    141 	    ((insn & 0xff000000) == 0x98000000) ||	/* ldrsw literal */
    142 	    /* ldpsw {pre,post}idx */
    143 	    ((insn & 0xfec00000) == 0x68c00000) ||
    144 	    /* ldrh immunsign,ldpsw signed */
    145 	    ((insn & 0xefc00000) == 0x69400000) ||
    146 	    ((insn & 0xbfff0000) == 0x887f0000) ||	/* ldaxp,ldxp */
    147 	    ((insn & 0xbfc00000) == 0xb9400000) ||	/* ldr immunsign */
    148 	    ((insn & 0xbfa00c00) == 0x38800000) ||	/* ldursh,ldursb */
    149 	    /* ldrsh imm{pre,post}idx,ldrsb imm{pre,post}idx */
    150 	    ((insn & 0xbfa00400) == 0x38800400) ||
    151 	    /* ldrs[bh] reg,ldtrs[bh] */
    152 	    ((insn & 0xbf800c00) == 0x38800800) ||
    153 	    /* ldrsh immunsign,ldrsb immunsign */
    154 	    ((insn & 0xbf800000) == 0x39800000) ||
    155 	    ((insn & 0xbf000000) == 0x18000000) ||	/* ldr literal */
    156 	    /* ldp {pre,post}idx,ldp signed,ldnp */
    157 	    ((insn & 0x7e400000) == 0x28400000) ||
    158 	    ((insn & 0x3ffffc00) == 0x085f7c00) ||	/* ldxr,ldxr[bh] */
    159 	    ((insn & 0x3fe00c00) == 0x38400000) ||	/* ldur,ldur[bh] */
    160 	    /* ldr imm{pre,post}idx,ldr[bh]_imm{pre,post}idx */
    161 	    ((insn & 0x3fe00400) == 0x38400400) ||
    162 	    /* ldtr,ldtr[bh],ldr_reg,ldr[bh]_reg */
    163 	    ((insn & 0x3fc00c00) == 0x38400800) ||
    164 	    /* ldaxr,ldaxr[bh],ldar,ldar[bh] */
    165 	    ((insn & 0x3f7ffc00) == 0x085ffc00);
    166 }
    167 
    168 static inline bool
    169 inst_store(db_expr_t insn)
    170 {
    171 	LE32TOH(insn);
    172 	return
    173 	    ((insn & 0xbfe00000) == 0x88200000) ||	/* stlxp,stxp */
    174 	    /* stp {pre,post}idx,stp signed,stnp */
    175 	    ((insn & 0x7e400000) == 0x28000000) ||
    176 	    ((insn & 0x3ffffc00) == 0x089ffc00) ||	/* stlr,stlr[bh] */
    177 	    /* stlxr,stlxr[bh],stxr,stxr[bh] */
    178 	    ((insn & 0x3fe07c00) == 0x08007c00) ||
    179 	    ((insn & 0x3fe00c00) == 0x38000000) ||	/* stur,stur[bh] */
    180 	    /* str imm{pre,post}idx,str[bh] imm{pre,post}idx */
    181 	    ((insn & 0x3fe00400) == 0x38000400) ||
    182 	    /* str reg,str[bh] reg,sttr,sttr[bh] */
    183 	    ((insn & 0x3fc00c00) == 0x38000800) ||
    184 	    /* str immunsign,str[bh] immunsign */
    185 	    ((insn & 0x3fc00000) == 0x39000000);
    186 }
    187 
    188 #define SOFTWARE_SSTEP
    189 
    190 #ifdef SOFTWARE_SSTEP
    191 
    192 static inline bool
    193 inst_branch(db_expr_t insn)
    194 {
    195 	LE32TOH(insn);
    196 	return
    197 	    ((insn & 0xff000010) == 0x54000000) ||	/* b.cond */
    198 	    ((insn & 0xfc000000) == 0x14000000) ||	/* b imm */
    199 	    ((insn & 0xfffffc1f) == 0xd61f0000) ||	/* br */
    200 	    ((insn & 0x7f000000) == 0x35000000) ||	/* cbnz */
    201 	    ((insn & 0x7f000000) == 0x34000000) ||	/* cbz */
    202 	    ((insn & 0x7f000000) == 0x37000000) ||	/* tbnz */
    203 	    ((insn & 0x7f000000) == 0x36000000);	/* tbz */
    204 }
    205 
    206 bool db_inst_unconditional_flow_transfer(db_expr_t);
    207 db_addr_t db_branch_taken(db_expr_t, db_addr_t, db_regs_t *);
    208 
    209 #define next_instr_address(pc, bd)		\
    210 	    ((bd) ? (pc) : ((pc) + 4))
    211 #define branch_taken(ins, pc, regs)		\
    212 	    db_branch_taken((ins), (pc), (regs))
    213 #define inst_unconditional_flow_transfer(ins)	\
    214 	    db_inst_unconditional_flow_transfer(ins)
    215 
    216 #endif /* SOFTWARE_SSTEP */
    217 
    218 #define DB_MACHINE_COMMANDS
    219 
    220 #ifdef _KERNEL
    221 void db_pteinfo(vaddr_t, void (*)(const char *, ...) __printflike(1, 2));
    222 void db_pte_print(pt_entry_t, int, void (*)(const char *, ...) __printflike(1, 2));
    223 void db_ttbrdump(bool, vaddr_t, void (*pr)(const char *, ...) __printflike(1, 2));
    224 void db_machdep_cpu_init(void);
    225 void db_machdep_init(struct cpu_info * const);
    226 
    227 /* hardware breakpoint/watchpoint functions */
    228 void aarch64_breakpoint_set(int, vaddr_t);
    229 void aarch64_watchpoint_set(int, vaddr_t, u_int, u_int);
    230 #define WATCHPOINT_ACCESS_LOAD		0x01
    231 #define WATCHPOINT_ACCESS_STORE		0x02
    232 #define WATCHPOINT_ACCESS_LOADSTORE	0x03
    233 #define WATCHPOINT_ACCESS_MASK		0x03
    234 #endif
    235 
    236 void dump_trapframe(struct trapframe *, void (*)(const char *, ...) __printflike(1, 2));
    237 
    238 void dump_switchframe(struct trapframe *, void (*)(const char *, ...) __printflike(1, 2));
    239 const char *strdisasm(vaddr_t, uint64_t);
    240 
    241 #define DB_ELF_SYMBOLS
    242 
    243 #elif defined(__arm__)
    244 
    245 #include <arm/db_machdep.h>
    246 
    247 #endif
    248 
    249 #endif /* _AARCH64_DB_MACHDEP_H_ */
    250