Added the OS files

1 files changed, 160 insertions, 0 deletions

diff --git a/ecos/packages/hal/common/current/include/dbg-threads-api.h b/ecos/packages/hal/common/current/include/dbg-threads-api.h
new file mode 100644
index 0000000..777716c
--- /dev/null
+++ b/ecos/packages/hal/common/current/include/dbg-threads-api.h
@@ -0,0 +1,160 @@
+//========================================================================
+//
+//      dbg-threads-api.h
+//
+//      Supports thread-aware debugging
+//
+//========================================================================
+// ####ECOSGPLCOPYRIGHTBEGIN####                                            
+// -------------------------------------------                              
+// This file is part of eCos, the Embedded Configurable Operating System.   
+// Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
+//
+// eCos is free software; you can redistribute it and/or modify it under    
+// the terms of the GNU General Public License as published by the Free     
+// Software Foundation; either version 2 or (at your option) any later      
+// version.                                                                 
+//
+// eCos is distributed in the hope that it will be useful, but WITHOUT      
+// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or    
+// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License    
+// for more details.                                                        
+//
+// You should have received a copy of the GNU General Public License        
+// along with eCos; if not, write to the Free Software Foundation, Inc.,    
+// 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.            
+//
+// As a special exception, if other files instantiate templates or use      
+// macros or inline functions from this file, or you compile this file      
+// and link it with other works to produce a work based on this file,       
+// this file does not by itself cause the resulting work to be covered by   
+// the GNU General Public License. However the source code for this file    
+// must still be made available in accordance with section (3) of the GNU   
+// General Public License v2.                                               
+//
+// This exception does not invalidate any other reasons why a work based    
+// on this file might be covered by the GNU General Public License.         
+// -------------------------------------------                              
+// ####ECOSGPLCOPYRIGHTEND####                                              
+//========================================================================
+//#####DESCRIPTIONBEGIN####
+//
+// Author(s):     Red Hat, nickg
+// Contributors:  Red Hat, nickg
+// Date:          1998-08-25
+// Purpose:       
+// Description:   These are the calls used to extract operating system
+//                specific information used in supporting thread aware
+//                debugging. The Operating Environment being debugged
+//                needs to supply these functions.
+// Usage:         This header is not to be included by user code.
+//
+//####DESCRIPTIONEND####
+//
+//========================================================================
+
+#if !defined(DBG_THREADS_API_INCLUDED)
+#define DBG_THREADS_API_INCLUDED 1
+
+#include <cyg/infra/cyg_type.h>         /* externC */
+
+#define has_thread_void       0 
+#define has_thread_current    1
+#define has_thread_registers  2
+#define has_thread_reg_change 4
+#define has_thread_list       8
+#define has_thread_info       16
+
+typedef unsigned char threadref[8] ;
+
+struct dbg_capabilities
+{
+  unsigned long mask1  ;
+} ;
+
+
+/* fill in the list of thread aware capabilities */
+externC int dbg_thread_capabilities(struct dbg_capabilities * cbp) ;
+
+
+/* Fillin the identifier of the current thread */
+/* return 1 if defined, 0 if not defined */
+externC int dbg_currthread(threadref * varparm) ;
+
+/* Return the unique ID number of a given thread. */
+/* Return 0 if not valid. */
+externC int dbg_thread_id(threadref *threadid);
+
+/* Return the unique ID number of the current thread. */
+externC int dbg_currthread_id(void);
+
+/* get the first or next member of the list of known threads */
+externC int dbg_threadlist(int startflag,
+                           threadref * lastthreadid,
+                           threadref * next_thread
+    ) ;
+
+/* return 1 if next_threadid has been filled in with a value */
+/* return 0 if there are none or no more */
+
+/* The O.S can fill in the following information about a thread when queried.
+   The structure of thise strings is determined by the O.S.
+   It is display oriented, so figure out what the users need to see.
+   Nulls are OK but GDB will fill some not so meaningful data.
+   These pointers may be in the calles private structures, the info will
+   get copied immediatly after the call to retreive it.
+   */
+struct cygmon_thread_debug_info
+{
+  threadref thread_id ;
+  int context_exists ; /* To the point where examining its state,
+                         registers and stack makes sense to GDB */
+  char * thread_display ; /* As shown in thread status window, name, state */
+  char * unique_thread_name ; /* human readable identifier, window label */
+  char * more_display ;   /* more detailed info about thread.
+                          priority, queuedepth, state, stack usage, statistics */
+} ;
+
+
+
+
+externC int dbg_threadinfo(
+                          threadref * threadid,
+                          struct cygmon_thread_debug_info * info) ;
+
+/* Return 1 if threadid is defined and info copied, 0 otherwise */
+
+/* The O.S should fillin the array of registers using values from the
+saves context. The array MUST be in GDB register save order even if
+the saved context is different or smaller. Do not alter the values of
+registers which are NOT in the O.S. thread context. Their default values
+have already been assigned.
+*/
+
+externC int dbg_getthreadreg(
+                            threadref * osthreadid, 
+                            int regcount, /* count of registers in the array */
+                            void * regval) ; /* fillin this array */
+
+
+/* The O.S. should scan through this list of registers which are in
+GDB order and the O.S. should replace the values of all registers
+which are defined in the saved context of thread or process identified
+by osthreadid. Return 0 if the threadis does not map to a known
+process or other error. Return 1 if the setting is successful.  */
+
+externC int dbg_setthreadreg(
+                            threadref * osthreadid, 
+                            int regcount , /* number of registers */
+                            void * regval) ;
+
+/* Control over OS scheduler. With the scheduler locked it should not
+   perform any rescheduling in response to interrupts.  */
+externC int dbg_scheduler(
+                          threadref * osthreadid,
+                          int lock,     /* 0 == unlock, 1 == lock */
+                          int mode);    /* 0 == step,   1 == continue */
+
+
+
+#endif /* DBG_THREADS_API_INCLUDED */