WebSVN – HelenOS – Blame – //branches/tracing/kernel/generic/include/udebug/udebug.h

Rev	Author	Line No.	Line
2894	svoboda	1	/*
		2	* Copyright (c) 2008 Jiri Svoboda
		3	* All rights reserved.
		4	*
		5	* Redistribution and use in source and binary forms, with or without
		6	* modification, are permitted provided that the following conditions
		7	* are met:
		8	*
		9	* - Redistributions of source code must retain the above copyright
		10	* notice, this list of conditions and the following disclaimer.
		11	* - Redistributions in binary form must reproduce the above copyright
		12	* notice, this list of conditions and the following disclaimer in the
		13	* documentation and/or other materials provided with the distribution.
		14	* - The name of the author may not be used to endorse or promote products
		15	* derived from this software without specific prior written permission.
		16	*
		17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
		18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
		19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
		20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
		21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
		22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
		23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
		24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
		25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
		26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
		27	*/
		28
2801	svoboda	29	/** @addtogroup generic
		30	* @{
		31	*/
		32	/** @file
		33	*/
		34
		35	#ifndef KERN_UDEBUG_H_
		36	#define KERN_UDEBUG_H_
		37
2812	svoboda	38	typedef enum { /* udebug_method_t */
		39
		40	/** Start debugging the recipient.
		41	* Causes all threads in the receiving task to stop. When they
		42	* are all stoped, an answer with retval 0 is generated.
		43	*/
		44	UDEBUG_M_BEGIN = 1,
		45
		46	/** Finish debugging the recipient.
		47	* Answers all pending GO and GUARD messages.
		48	*/
		49	UDEBUG_M_END,
		50
		51	/** Make sure the debugged task is still there.
		52	* This message is answered when the debugged task dies
		53	* or the debugging session ends.
		54	*/
		55	UDEBUG_M_GUARD,
		56
		57	/** Run a thread until a debugging event occurs.
		58	* This message is answered when the thread stops
		59	* in a debugging event.
		60	*
		61	* - ARG2 - id of the thread to run
		62	*/
		63	UDEBUG_M_GO,
		64
		65	/** Stop a thread being debugged.
		66	* Creates a special STOP event in the thread, causing
		67	* it to answer a pending GO message (if any).
		68	*/
		69	UDEBUG_M_STOP,
		70
		71	/** Read arguments of a syscall.
		72	*
		73	* - ARG2 - thread identification
		74	* - ARG3 - destination address in the caller's address space
		75	*
		76	*/
		77	UDEBUG_M_ARGS_READ,
		78
2817	svoboda	79	/** Read thread's userspace register state (istate_t).
		80	*
		81	* - ARG2 - thread identification
		82	* - ARG3 - destination address in the caller's address space
		83	* - ARG4 - size of receiving buffer in bytes
		84	*
		85	* on answer, the kernel will set:
		86	*
		87	* - ARG1 - actual size in bytes of data read
		88	* - ARG2 - total size in bytes of data available
		89	*
		90	* or, on error, retval will be
		91	* - ENOENT - thread does not exist
		92	* - EBUSY - register state not available
		93	*/
		94	UDEBUG_M_REGS_READ,
		95
		96	/** Write thread's userspace register state (istate_t).
		97	*
		98	* - ARG2 - thread identification
		99	* - ARG3 - source address in the caller's address space
		100	* - ARG4 - size of source data in bytes
		101	*
		102	* on answer, the kernel will set:
		103	*
		104	* - ARG1 - actual size in bytes of data copied
		105	* - ARG2 - max size in bytes that could have been copied
		106	*
		107	* or, on error, retval will be
		108	* - ENOENT - thread does not exist
		109	* - EBUSY - register state not available
		110	*/
		111	UDEBUG_M_REGS_WRITE,
		112
2812	svoboda	113	/** Read the list of the debugged tasks's threads.
		114	*
		115	* - ARG2 - destination address in the caller's address space
		116	* - ARG3 - size of receiving buffer in bytes
		117	*
		118	* The kernel fills the buffer with a series of sysarg_t values
		119	* (thread ids). On answer, the kernel will set:
		120	*
2885	svoboda	121	* - ARG2 - number of bytes that were actually copied
		122	* - ARG3 - number of bytes of the complete data
2812	svoboda	123	*
		124	*/
		125	UDEBUG_M_THREAD_READ,
		126
2818	svoboda	127	/** Read the debugged tasks's memory.
2812	svoboda	128	*
		129	* - ARG2 - destination address in the caller's address space
		130	* - ARG3 - source address in the recipient's address space
		131	* - ARG4 - size of receiving buffer in bytes
		132	*
		133	*/
2818	svoboda	134	UDEBUG_M_MEM_READ,
2812	svoboda	135
2818	svoboda	136	/** Write the debugged tasks's memory.
		137	*
		138	* - ARG2 - source address in the caller's address space
		139	* - ARG3 - destination address in the recipient's address space
		140	* - ARG4 - size of receiving buffer in bytes
		141	*
		142	*/
		143	UDEBUG_M_MEM_WRITE
		144
		145
2812	svoboda	146	} udebug_method_t;
		147
2838	svoboda	148
2805	svoboda	149	typedef enum {
2866	svoboda	150	UDEBUG_EVENT_FINISHED = 1, /*< Debuging session has finished /
2898	svoboda	151	UDEBUG_EVENT_STOP, /*< Stopped on DEBUG_STOP request /
2867	svoboda	152	UDEBUG_EVENT_SYSCALL, /*< A syscall has been executed /
		153	UDEBUG_EVENT_NEW_THREAD /*< The task created a new thread /
2805	svoboda	154	} udebug_event_t;
		155
2812	svoboda	156	#ifdef KERNEL
		157
2825	svoboda	158	typedef enum {
		159	/** Task is not being debugged */
		160	UDEBUG_TS_INACTIVE,
		161	/** BEGIN operation in progress (waiting for threads to stop) */
		162	UDEBUG_TS_BEGINNING,
		163	/** Debugger fully connected */
		164	UDEBUG_TS_ACTIVE,
		165	/** Task is shutting down, no more debug activities allowed */
		166	UDEBUG_TS_SHUTDOWN
		167	} udebug_task_state_t;
		168
2870	svoboda	169	struct task;
		170	struct thread;
		171
2805	svoboda	172	void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3,
		173	unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc);
2867	svoboda	174	void udebug_new_thread_event(struct thread *t);
		175
2804	svoboda	176	void udebug_stoppable_begin(void);
		177	void udebug_stoppable_end(void);
2801	svoboda	178
2870	svoboda	179	int udebug_task_cleanup(struct task *ta);
		180
2801	svoboda	181	#endif
		182
2812	svoboda	183	#endif
		184
2801	svoboda	185	/** @}
		186	*/

Subversion Repositories HelenOS

(root)//branches/tracing/kernel/generic/include/udebug/udebug.h – Rev 2898