[mirror_ubuntu-bionic-kernel.git] / kernel / debug / debug_core.h

/*
 * Created by: Jason Wessel <jason.wessel@windriver.com>
 *
 * Copyright (c) 2009 Wind River Systems, Inc.  All Rights Reserved.
 *
 * This file is licensed under the terms of the GNU General Public
 * License version 2. This program is licensed "as is" without any
 * warranty of any kind, whether express or implied.
 */

#ifndef _DEBUG_CORE_H_
#define _DEBUG_CORE_H_
/*
 * These are the private implementation headers between the kernel
 * debugger core and the debugger front end code.
 */

/* kernel debug core data structures */
struct kgdb_state {
	int			ex_vector;
	int			signo;
	int			err_code;
	int			cpu;
	int			pass_exception;
	unsigned long		thr_query;
	unsigned long		threadid;
	long			kgdb_usethreadid;
	struct pt_regs		*linux_regs;
	atomic_t		*send_ready;
};

/* Exception state values */
#define DCPU_WANT_MASTER 0x1 /* Waiting to become a master kgdb cpu */
#define DCPU_NEXT_MASTER 0x2 /* Transition from one master cpu to another */
#define DCPU_IS_SLAVE    0x4 /* Slave cpu enter exception */
#define DCPU_SSTEP       0x8 /* CPU is single stepping */

struct debuggerinfo_struct {
	void			*debuggerinfo;
	struct task_struct	*task;
	int			exception_state;
	int			ret_state;
	int			irq_depth;
	int			enter_kgdb;
};

extern struct debuggerinfo_struct kgdb_info[];

/* kernel debug core break point routines */
extern int dbg_remove_all_break(void);
extern int dbg_set_sw_break(unsigned long addr);
extern int dbg_remove_sw_break(unsigned long addr);
extern int dbg_activate_sw_breakpoints(void);
extern int dbg_deactivate_sw_breakpoints(void);

/* polled character access to i/o module */
extern int dbg_io_get_char(void);

/* stub return value for switching between the gdbstub and kdb */
#define DBG_PASS_EVENT -12345
/* Switch from one cpu to another */
#define DBG_SWITCH_CPU_EVENT -123456
extern int dbg_switch_cpu;

/* gdbstub interface functions */
extern int gdb_serial_stub(struct kgdb_state *ks);
extern void gdbstub_msg_write(const char *s, int len);

/* gdbstub functions used for kdb <-> gdbstub transition */
extern int gdbstub_state(struct kgdb_state *ks, char *cmd);
extern int dbg_kdb_mode;

#ifdef CONFIG_KGDB_KDB
extern int kdb_stub(struct kgdb_state *ks);
extern int kdb_parse(const char *cmdstr);
extern int kdb_common_init_state(struct kgdb_state *ks);
extern int kdb_common_deinit_state(void);
#else /* ! CONFIG_KGDB_KDB */
static inline int kdb_stub(struct kgdb_state *ks)
{
	return DBG_PASS_EVENT;
}
#endif /* CONFIG_KGDB_KDB */

#endif /* _DEBUG_CORE_H_ */
Commit	Line	Data
53197fc4 JW	1	/*
	2	* Created by: Jason Wessel <jason.wessel@windriver.com>
	3	*
	4	* Copyright (c) 2009 Wind River Systems, Inc. All Rights Reserved.
	5	*
	6	* This file is licensed under the terms of the GNU General Public
	7	* License version 2. This program is licensed "as is" without any
	8	* warranty of any kind, whether express or implied.
	9	*/
	10
	11	#ifndef _DEBUG_CORE_H_
	12	#define _DEBUG_CORE_H_
	13	/*
	14	* These are the private implementation headers between the kernel
	15	* debugger core and the debugger front end code.
	16	*/
	17
	18	/* kernel debug core data structures */
	19	struct kgdb_state {
	20	int ex_vector;
	21	int signo;
	22	int err_code;
	23	int cpu;
	24	int pass_exception;
	25	unsigned long thr_query;
	26	unsigned long threadid;
	27	long kgdb_usethreadid;
	28	struct pt_regs *linux_regs;
8daaa5f8	29	atomic_t *send_ready;
53197fc4 JW	30	};
	31
	32	/* Exception state values */
	33	#define DCPU_WANT_MASTER 0x1 /* Waiting to become a master kgdb cpu */
	34	#define DCPU_NEXT_MASTER 0x2 /* Transition from one master cpu to another */
	35	#define DCPU_IS_SLAVE 0x4 /* Slave cpu enter exception */
	36	#define DCPU_SSTEP 0x8 /* CPU is single stepping */
	37
	38	struct debuggerinfo_struct {
	39	void *debuggerinfo;
	40	struct task_struct *task;
	41	int exception_state;
dcc78711 JW	42	int ret_state;
dcc78711 JW	43	int irq_depth;
dfee3a7b	44	int enter_kgdb;
53197fc4 JW	45	};
	46
	47	extern struct debuggerinfo_struct kgdb_info[];
	48
	49	/* kernel debug core break point routines */
	50	extern int dbg_remove_all_break(void);
	51	extern int dbg_set_sw_break(unsigned long addr);
	52	extern int dbg_remove_sw_break(unsigned long addr);
	53	extern int dbg_activate_sw_breakpoints(void);
dcc78711 JW	54	extern int dbg_deactivate_sw_breakpoints(void);
	55
	56	/* polled character access to i/o module */
	57	extern int dbg_io_get_char(void);
	58
	59	/* stub return value for switching between the gdbstub and kdb */
	60	#define DBG_PASS_EVENT -12345
	61	/* Switch from one cpu to another */
	62	#define DBG_SWITCH_CPU_EVENT -123456
	63	extern int dbg_switch_cpu;
53197fc4 JW	64
	65	/* gdbstub interface functions */
	66	extern int gdb_serial_stub(struct kgdb_state *ks);
	67	extern void gdbstub_msg_write(const char *s, int len);
	68
dcc78711 JW	69	/* gdbstub functions used for kdb <-> gdbstub transition */
dcc78711 JW	70	extern int gdbstub_state(struct kgdb_state ks, char cmd);
a0de055c	71	extern int dbg_kdb_mode;
dcc78711 JW	72
	73	#ifdef CONFIG_KGDB_KDB
	74	extern int kdb_stub(struct kgdb_state *ks);
a0de055c	75	extern int kdb_parse(const char *cmdstr);
00370b8f MK	76	extern int kdb_common_init_state(struct kgdb_state *ks);
00370b8f MK	77	extern int kdb_common_deinit_state(void);
dcc78711 JW	78	#else /* ! CONFIG_KGDB_KDB */
	79	static inline int kdb_stub(struct kgdb_state *ks)
	80	{
	81	return DBG_PASS_EVENT;
	82	}
	83	#endif /* CONFIG_KGDB_KDB */
	84
53197fc4	85	#endif /* _DEBUG_CORE_H_ */