Subversion Repositories HelenOS

Rev

Rev 2818 | Rev 2833 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2801 svoboda 1 
/** @addtogroup generic
2 
 * @{
3 
 */
4 
/** @file
5 
 */
6 
 
7 
#ifndef KERN_UDEBUG_H_
8 
#define KERN_UDEBUG_H_
9 
 
2812 svoboda 10 
typedef enum { /* udebug_method_t */
11 
 
12 
/** Start debugging the recipient.
13 
 * Causes all threads in the receiving task to stop. When they
14 
 * are all stoped, an answer with retval 0 is generated.
15 
 */
16 
UDEBUG_M_BEGIN = 1,
17 
 
18 
/** Finish debugging the recipient.
19 
 * Answers all pending GO and GUARD messages.
20 
 */
21 
UDEBUG_M_END,
22 
 
23 
/** Make sure the debugged task is still there.
24 
 * This message is answered when the debugged task dies
25 
 * or the debugging session ends.
26 
 */
27 
UDEBUG_M_GUARD,
28 
 
29 
/** Run a thread until a debugging event occurs.
30 
 * This message is answered when the thread stops
31 
 * in a debugging event.
32 
 *
33 
 * - ARG2 - id of the thread to run
34 
 */
35 
UDEBUG_M_GO,
36 
 
37 
/** Stop a thread being debugged.
38 
 * Creates a special STOP event in the thread, causing
39 
 * it to answer a pending GO message (if any).
40 
 */
41 
UDEBUG_M_STOP,
42 
 
43 
/** Read arguments of a syscall.
44 
 *
45 
 * - ARG2 - thread identification
46 
 * - ARG3 - destination address in the caller's address space
47 
 * - ARG4 - size of receiving buffer in bytes
48 
 *
49 
 * on answer, the kernel will set:
50 
 *
51 
 * - ARG1 - actual size in bytes of data read
52 
 */
53 
UDEBUG_M_ARGS_READ,
54 
 
2817 svoboda 55 
/** Read thread's userspace register state (istate_t).
56 
 *
57 
 * - ARG2 - thread identification
58 
 * - ARG3 - destination address in the caller's address space
59 
 * - ARG4 - size of receiving buffer in bytes
60 
 *
61 
 * on answer, the kernel will set:
62 
 *
63 
 * - ARG1 - actual size in bytes of data read
64 
 * - ARG2 - total size in bytes of data available
65 
 *
66 
 * or, on error, retval will be
67 
 * - ENOENT - thread does not exist
68 
 * - EBUSY - register state not available
69 
 */
70 
UDEBUG_M_REGS_READ,
71 
 
72 
/** Write thread's userspace register state (istate_t).
73 
 *
74 
 * - ARG2 - thread identification
75 
 * - ARG3 - source address in the caller's address space
76 
 * - ARG4 - size of source data in bytes
77 
 *
78 
 * on answer, the kernel will set:
79 
 *
80 
 * - ARG1 - actual size in bytes of data copied
81 
 * - ARG2 - max size in bytes that could have been copied
82 
 *
83 
 * or, on error, retval will be
84 
 * - ENOENT - thread does not exist
85 
 * - EBUSY - register state not available
86 
 */
87 
UDEBUG_M_REGS_WRITE,
88 
 
2812 svoboda 89 
/** Read the list of the debugged tasks's threads.
90 
 *
91 
 * - ARG2 - destination address in the caller's address space
92 
 * - ARG3 - size of receiving buffer in bytes
93 
 *
94 
 * The kernel fills the buffer with a series of sysarg_t values
95 
 * (thread ids). On answer, the kernel will set:
96 
 *
97 
 * - ARG1 - number of bytes that were actually copied
98 
 * - ARG2 - number of bytes of the complete data
99 
 *
100 
 */
101 
UDEBUG_M_THREAD_READ,
102 
 
2818 svoboda 103 
/** Read the debugged tasks's memory.
2812 svoboda 104 
 *
105 
 * - ARG2 - destination address in the caller's address space
106 
 * - ARG3 - source address in the recipient's address space
107 
 * - ARG4 - size of receiving buffer in bytes
108 
 *
109 
 */
2818 svoboda 110 
UDEBUG_M_MEM_READ,
2812 svoboda 111 
 
2818 svoboda 112 
/** Write the debugged tasks's memory.
113 
 *
114 
 * - ARG2 - source address in the caller's address space
115 
 * - ARG3 - destination address in the recipient's address space
116 
 * - ARG4 - size of receiving buffer in bytes
117 
 *
118 
 */
119 
UDEBUG_M_MEM_WRITE
120 
 
121 
 
2812 svoboda 122 
} udebug_method_t;
123 
 
124 
 
2805 svoboda 125 
typedef enum {
126 
    UDEBUG_EVENT_SYSCALL
127 
} udebug_event_t;
128 
 
2812 svoboda 129 
#ifdef KERNEL
130 
 
2825 svoboda 131 
typedef enum {
132 
    /** Task is not being debugged */
133 
    UDEBUG_TS_INACTIVE,
134 
    /** BEGIN operation in progress (waiting for threads to stop) */
135 
    UDEBUG_TS_BEGINNING,
136 
    /** Debugger fully connected */
137 
    UDEBUG_TS_ACTIVE,
138 
    /** Task is shutting down, no more debug activities allowed */
139 
    UDEBUG_TS_SHUTDOWN
140 
} udebug_task_state_t;
141 
 
2805 svoboda 142 
void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3,
143 
    unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc);
2804 svoboda 144 
void udebug_stoppable_begin(void);
145 
void udebug_stoppable_end(void);
2801 svoboda 146 
 
147 
#endif
148 
 
2812 svoboda 149 
#endif
150 
 
2801 svoboda 151 
/** @}
152 
 */