1 /*        $NetBSD: db_machdep.h,v 1.18 2023/09/02 21:54:55 andvar Exp $         */
2 
3 /*
4  * Mach Operating System
5  * Copyright (c) 1991,1990 Carnegie Mellon University
6  * All Rights Reserved.
7  *
8  * Permission to use, copy, modify and distribute this software and its
9  * documentation is hereby granted, provided that both the copyright
10  * notice and this permission notice appear in all copies of the
11  * software, derivative works or modified versions, and any portions
12  * thereof, and that both notices appear in supporting documentation.
13  *
14  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
15  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
16  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
17  *
18  * Carnegie Mellon requests users of this software to return to
19  *
20  *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
21  *  School of Computer Science
22  *  Carnegie Mellon University
23  *  Pittsburgh PA 15213-3890
24  *
25  * any improvements or extensions that they make and grant Carnegie Mellon
26  * the rights to redistribute these changes.
27  */
28 
29 #ifndef   _SH3_DB_MACHDEP_H_
30 #define   _SH3_DB_MACHDEP_H_
31 
32 /*
33  * Machine-dependent defines for new kernel debugger.
34  */
35 
36 #include <sys/param.h>
37 #include <uvm/uvm_extern.h>
38 #include <sh3/exception.h>
39 #include <sh3/pcb.h>
40 
41 typedef   vaddr_t             db_addr_t;          /* address - unsigned */
42 #define   DDB_EXPR_FMT        "l"                 /* expression is long */
43 typedef   long                db_expr_t;          /* expression - signed */
44 
45 typedef struct trapframe db_regs_t;
46 extern db_regs_t    ddb_regs; /* register state */
47 #define   DDB_REGS  (&ddb_regs)
48 
49 #define   PC_REGS(regs)       ((regs)->tf_spc)
50 #define PC_ADVANCE(regs) ((regs)->tf_spc += BKPT_SIZE)
51 
52 #define   BKPT_ADDR(addr)     (addr)              /* breakpoint address */
53 #define   BKPT_INST 0xc3c3              /* breakpoint instruction */
54 #define   BKPT_SIZE 2                   /* size of breakpoint inst */
55 #define   BKPT_SET(inst, addr)          BKPT_INST
56 
57 #define   FIXUP_PC_AFTER_BREAK(regs)    ((regs)->tf_spc -= BKPT_SIZE)
58 
59 #define   IS_BREAKPOINT_TRAP(type, code)          \
60           ((type) == EXPEVT_TRAPA && (code) == _SH_TRA_BREAK)
61 #define   IS_WATCHPOINT_TRAP(type, code)          (false)
62 
63 #define   inst_load(ins)                0
64 #define   inst_store(ins)               0
65 
66 /* access capability and access macros */
67 
68 #define   DB_ACCESS_LEVEL               2         /* access any space */
69 #define   DB_CHECK_ACCESS(addr, size, task)                                     \
70           db_check_access(addr, size, task)
71 #define   DB_PHYS_EQ(task1, addr1, task2, addr2)                                \
72           db_phys_eq(task1, addr1, task2, addr2)
73 #define   DB_VALID_KERN_ADDR(addr)                                              \
74           ((addr) >= VM_MIN_KERNEL_ADDRESS &&                                   \
75            (addr) < VM_MAX_KERNEL_ADDRESS)
76 #define   DB_VALID_ADDRESS(addr, user)                                          \
77           ((!(user) && DB_VALID_KERN_ADDR(addr)) ||                             \
78            ((user) && (addr) < VM_MAX_ADDRESS))
79 
80 /* macros for printing OS server dependent task name */
81 
82 #define   DB_TASK_NAME(task)  db_task_name(task)
83 #define   DB_TASK_NAME_TITLE  "COMMAND                "
84 #define   DB_TASK_NAME_LEN    23
85 #define   DB_NULL_TASK_NAME   "?                      "
86 
87 /*
88  * Constants for KGDB.
89  */
90 typedef   long      kgdb_reg_t;
91 #define   KGDB_NUMREGS        59
92 #define   KGDB_BUFLEN         1024
93 
94 /* macro for checking if a thread has used floating-point */
95 #define   db_thread_fp_used(thread)     ((thread)->pcb->ims.ifps != 0)
96 
97 int kdb_trap(int, int, db_regs_t *);
98 bool inst_call(int);
99 bool inst_return(int);
100 bool inst_trap_return(int);
101 
102 /*
103  * We use ELF symbols in DDB.
104  *
105  */
106 #define   DB_ELF_SYMBOLS
107 
108 /*
109  * We have machine-dependent commands.
110  */
111 #define   DB_MACHINE_COMMANDS
112 
113 extern const char kgdb_devname[];
114 
115 #endif    /* !_SH3_DB_MACHDEP_H_ */
116