Aren/haiku
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* Architecture specifics live in arch/<arch>/debugger.h now.

Browse Source 
* team debug flags:
  - Added flags for team creation, thread events (creation,
    deletion), and image events (creation, deletion).
  - Got rid of B_TEAM_DEBUG_SYSCALL_FAST_TRACE. We always send the syscall
    arguments. The overhead should be neglectable.
  - Added B_TEAM_DEBUG_STOP_NEW_THREADS.
* Added debugger notification messages for signals, team, thread and
  image events.
* Added debug request B_DEBUG_MESSAGE_GET_WHY_STOPPED.
* When continuing a thread, the debugger can now specify how to deal with
  the occurred event (ignore or handle).
* More data in the signal received notification message.


git-svn-id: file:///srv/svn/repos/haiku/trunk/current@11468 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Ingo Weinhold 2005-02-24 15:43:28 +00:00
parent 1faf0c16fa
commit c3610c8098
1 changed files with 103 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

113
headers/os/kernel/debugger.h
View File

@ -5,8 +5,20 @@
#ifndef _DEBUGGER_H
#define _DEBUGGER_H
#include <signal.h>
#include <image.h>
#include <OS.h>
// include architecture specific definitions
#ifdef __INTEL__
#include <arch/x86/arch_debugger.h>
#elif __POWERPC__
#include <arch/ppc/arch_debugger.h>
#endif
typedef struct debug_cpu_state debug_cpu_state;
#ifdef __cplusplus
extern "C" {
#endif
@ -20,15 +32,17 @@ extern status_t debug_thread(thread_id thread);
enum {
// event mask: If a flag is set, any of the team's threads will stop when
// the respective event occurs. All flags are enabled by default. Always
// enabled are debugger() calls and hardware exceptions.
// enabled are debugger() calls and hardware exceptions, as well as the
// deletion of the debugged team.
B_TEAM_DEBUG_SIGNALS = 0x00010000,
B_TEAM_DEBUG_PRE_SYSCALL = 0x00020000,
B_TEAM_DEBUG_POST_SYSCALL = 0x00040000,
B_TEAM_DEBUG_TEAM_CREATION = 0x00080000,
B_TEAM_DEBUG_THREADS = 0x00100000,
B_TEAM_DEBUG_IMAGES = 0x00200000,
// syscall tracing flags (disabled by default)
B_TEAM_DEBUG_SYSCALL_FAST_TRACE = 0x00100000,
// TODO: Check, if this makes sense at all. Copying the syscall args
// shouldn't be a big deal.
// new thread handling
B_TEAM_DEBUG_STOP_NEW_THREADS = 0x01000000,
B_TEAM_DEBUG_USER_FLAG_MASK = 0xffff0000,
};
@ -52,12 +66,18 @@ enum {
typedef enum {
B_THREAD_NOT_RUNNING = 0, // thread not running (e.g. when starting to
// debug)
B_SIGNAL_RECEIVED, // thread received a signal
B_TEAM_CREATED, // thread created a new team
B_THREAD_CREATED, // thread spawned a new thread
B_IMAGE_CREATED, // thread created a new image
B_IMAGE_DELETED, // thread deleted an image
B_DEBUGGER_CALL, // thread called debugger()
B_BREAKPOINT_HIT, // thread hit a breakpoint
B_WATCHPOINT_HIT, // thread hit a memory watchpoint
B_PRE_SYSCALL_HIT, // thread starts a syscall
B_POST_SYSCALL_HIT, // thread finished a syscall
B_SINGLE_STEP, // thread is being single stepped
B_NMI, // non-masked interrupt
B_MACHINE_CHECK_EXCEPTION,
B_SEGMENT_VIOLATION,
@ -72,6 +92,16 @@ typedef enum {
B_FLOATING_POINT_EXCEPTION,
} debug_why_stopped;
// Value indicating how a stopped thread shall continue.
enum {
B_THREAD_DEBUG_HANDLE_EVENT = 0, // handle the event normally
// (e.g. a signal is delivered, a
// CPU fault kills the team,...)
B_THREAD_DEBUG_IGNORE_EVENT, // ignore the event and continue as if
// it didn't occur (e.g. a signal or
// a CPU fault will be ignored)
};
// #pragma mark -
@ -82,6 +112,7 @@ typedef enum {
B_DEBUG_MESSAGE_SET_TEAM_FLAGS, // set the team's debugging flags
B_DEBUG_MESSAGE_SET_THREAD_FLAGS, // set a thread's debugging flags
B_DEBUG_MESSAGE_RUN_THREAD, // run a thread full speed
B_DEBUG_MESSAGE_GET_WHY_STOPPED, // ask why the thread stopped
// ...
} debug_nub_message;
@ -135,9 +166,16 @@ typedef struct {
typedef struct {
thread_id thread; // the thread to be run
uint32 handle_event; // how to handle the occurred event
// TODO: CPU state?
} debug_nub_run_thread;
// B_DEBUG_MESSAGE_GET_WHY_STOPPED
typedef struct {
thread_id thread; // the thread
} debug_nub_get_why_stopped;
// union of all messages structures sent to the debug nub thread
typedef union {
debug_nub_read_memory read_memory;
@ -145,6 +183,7 @@ typedef union {
debug_nub_set_team_flags set_team_flags;
debug_nub_set_thread_flags set_thread_flags;
debug_nub_run_thread run_thread;
debug_nub_get_why_stopped get_why_stopped;
// ...
} debug_nub_message_data;
@ -159,7 +198,13 @@ typedef enum {
B_DEBUGGER_MESSAGE_PRE_SYSCALL, // begin of a syscall
B_DEBUGGER_MESSAGE_POST_SYSCALL, // end of a syscall
B_DEBUGGER_MESSAGE_SIGNAL_RECEIVED, // thread received a signal
B_DEBUGGER_MESSAGE_TEAM_CREATED, // the debugged team created a new
// one
B_DEBUGGER_MESSAGE_TEAM_DELETED, // the debugged team is gone
B_DEBUGGER_MESSAGE_THREAD_CREATED, // a thread has been created
B_DEBUGGER_MESSAGE_THREAD_DELETED, // a thread has been deleted
B_DEBUGGER_MESSAGE_IMAGE_CREATED, // an image has been created
B_DEBUGGER_MESSAGE_IMAGE_DELETED, // an image has been deleted
} debug_debugger_message;
// B_DEBUGGER_MESSAGE_THREAD_STOPPED
@ -169,8 +214,8 @@ typedef struct {
team_id team; // the thread's team
debug_why_stopped why; // reason for contacting debugger
port_id nub_port; // port to debug nub for this team
// cpu_state cpu; // cpu state
// void *data; // additional data
debug_cpu_state cpu_state; // cpu state
void *data; // additional data
} debug_thread_stopped;
// B_DEBUGGER_MESSAGE_PRE_SYSCALL
@ -197,24 +242,72 @@ typedef struct {
// B_DEBUGGER_MESSAGE_SIGNAL_RECEIVED
typedef struct {
thread_id thread; // thread
team_id team; // the thread's team
int signal; // the signal
thread_id thread; // thread
team_id team; // the thread's team
int signal; // the signal
struct sigaction handler; // the signal handler
bool deadly; // true, if handling the signal will kill
// the team
} debug_signal_received;
// B_DEBUGGER_MESSAGE_TEAM_CREATED
typedef struct {
thread_id thread; // the thread responsible for creating the team
team_id team; // the thread's team
team_id new_team; // the newly created team
} debug_team_created;
// B_DEBUGGER_MESSAGE_TEAM_DELETED
typedef struct {
team_id team; // the team
} debug_team_deleted;
// B_DEBUGGER_MESSAGE_THREAD_CREATED
typedef struct {
thread_id thread; // the thread responsible for creating the new
// thread
team_id team; // the thread's team
team_id new_thread; // the newly created thread
} debug_thread_created;
// B_DEBUGGER_MESSAGE_THREAD_DELETED
typedef struct {
thread_id thread; // the thread
team_id team; // the thread's team
} debug_thread_deleted;
// B_DEBUGGER_MESSAGE_IMAGE_CREATED
typedef struct {
thread_id thread; // the thread responsible for creating the image
team_id team; // the thread's team
image_info info; // info for the image
} debug_image_created;
// B_DEBUGGER_MESSAGE_IMAGE_DELETED
typedef struct {
thread_id thread; // the thread responsible for deleting the image
team_id team; // the thread's team
image_info info; // info for the image
} debug_image_deleted;
// union of all messages structures sent to the debugger
typedef union {
debug_thread_stopped thread_stopped;
debug_pre_syscall pre_syscall;
debug_post_syscall post_syscall;
debug_signal_received signal_received;
debug_team_created team_created;
debug_team_deleted team_deleted;
debug_thread_created thread_created;
debug_thread_deleted thread_deleted;
debug_image_created image_created;
debug_image_deleted image_deleted;
// ...
} debug_debugger_message_data;