summaryrefslogtreecommitdiff
path: root/cesar/ecos/packages/kernel/current/include/instrmnt.h
diff options
context:
space:
mode:
Diffstat (limited to 'cesar/ecos/packages/kernel/current/include/instrmnt.h')
-rw-r--r--cesar/ecos/packages/kernel/current/include/instrmnt.h465
1 files changed, 465 insertions, 0 deletions
diff --git a/cesar/ecos/packages/kernel/current/include/instrmnt.h b/cesar/ecos/packages/kernel/current/include/instrmnt.h
new file mode 100644
index 0000000000..d17b261d5e
--- /dev/null
+++ b/cesar/ecos/packages/kernel/current/include/instrmnt.h
@@ -0,0 +1,465 @@
+#ifndef CYGONCE_KERNEL_INSTRMNT_HXX
+#define CYGONCE_KERNEL_INSTRMNT_HXX
+
+//==========================================================================
+//
+// instrmnt.hxx
+//
+// Kernel Instrumentation mechanism
+//
+//==========================================================================
+//####ECOSGPLCOPYRIGHTBEGIN####
+// -------------------------------------------
+// This file is part of eCos, the Embedded Configurable Operating System.
+// Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, 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.,
+// 59 Temple Place, Suite 330, Boston, MA 02111-1307 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.
+//
+// This exception does not invalidate any other reasons why a work based on
+// this file might be covered by the GNU General Public License.
+//
+// Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
+// at http://sources.redhat.com/ecos/ecos-license/
+// -------------------------------------------
+//####ECOSGPLCOPYRIGHTEND####
+//==========================================================================
+//#####DESCRIPTIONBEGIN####
+//
+// Author(s): nickg
+// Contributors: nickg, andrew.lunn@ascom.ch
+// Date: 2000-05-04
+// Purpose: Define kernel instrumentation
+// Description: A set of definitions and macros used to implement an
+// instrumentation interface for the kernel.
+// NOTE: Don't use CYG_UNUSED_PARAM (or similar) here to
+// silence warnings about unused variables when using the
+// empty macro definitions. Otherwise this can cause problems
+// with volatile arguments and cause other side-effects.
+// Instead it is up to the caller to ensure that unused
+// arguments don't cause warnings
+// Usage: #include <cyg/kernel/instrmnt.hxx>
+//
+//####DESCRIPTIONEND####
+//
+//==========================================================================
+
+#include <cyg/kernel/ktypes.h>
+#include <cyg/infra/cyg_ass.h> // assertion macros
+
+// -------------------------------------------------------------------------
+// Underlying instrumentation function
+
+externC void cyg_instrument( cyg_uint32 type, CYG_ADDRWORD arg1, CYG_ADDRWORD arg2 );
+
+// -------------------------------------------------------------------------
+// The following functions are used to enable and disable specific
+// instrumentation classes and events. The class must be one of the
+// class defines below. The event may be one of the event defines below
+// or zero, in which case all of the events in the class are enabled or
+// disabled.
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_FLAGS
+
+externC void cyg_instrument_enable( cyg_uint32 cl, cyg_uint32 event );
+
+externC void cyg_instrument_disable( cyg_uint32 cl, cyg_uint32 event );
+
+externC cyg_bool cyg_instrument_state( cyg_uint32 cl, cyg_uint32 event );
+
+#endif
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_MSGS
+externC char * cyg_instrument_msg(CYG_WORD16 type);
+#endif
+
+// -------------------------------------------------------------------------
+// Instrumentation macros
+
+#ifdef CYGPKG_KERNEL_INSTRUMENT
+
+#define CYG_INSTRUMENT(_type_,_arg1_,_arg2_) cyg_instrument(_type_, (CYG_ADDRWORD)(_arg1_), (CYG_ADDRWORD)(_arg2_))
+
+#else // ifdef CYGPKG_KERNEL_INSTRUMENT
+
+#define CYG_INSTRUMENT(_type_,_arg1_,_arg2_)
+
+#endif // ifdef CYGPKG_KERNEL_INSTRUMENT
+
+// -------------------------------------------------------------------------
+// Type codes.
+// Each code is 16 bit with an event class in the top 8 bits
+// and an event code in the lower 8 bits.
+
+// Event classes
+#define CYG_INSTRUMENT_CLASS_SCHED 0x0100
+#define CYG_INSTRUMENT_CLASS_THREAD 0x0200
+#define CYG_INSTRUMENT_CLASS_INTR 0x0300
+#define CYG_INSTRUMENT_CLASS_MUTEX 0x0400
+#define CYG_INSTRUMENT_CLASS_CONDVAR 0x0500
+#define CYG_INSTRUMENT_CLASS_BINSEM 0x0600
+#define CYG_INSTRUMENT_CLASS_CNTSEM 0x0700
+#define CYG_INSTRUMENT_CLASS_CLOCK 0x0800
+#define CYG_INSTRUMENT_CLASS_ALARM 0x0900
+#define CYG_INSTRUMENT_CLASS_MBOXT 0x0a00
+#define CYG_INSTRUMENT_CLASS_SMP 0x0b00
+#define CYG_INSTRUMENT_CLASS_MLQ 0x0c00
+
+#define CYG_INSTRUMENT_CLASS_USER 0x0f00
+
+#define CYG_INSTRUMENT_CLASS_MAX CYG_INSTRUMENT_CLASS_USER
+
+// Scheduler events
+#define CYG_INSTRUMENT_EVENT_SCHED_LOCK 1
+#define CYG_INSTRUMENT_EVENT_SCHED_UNLOCK 2
+#define CYG_INSTRUMENT_EVENT_SCHED_RESCHEDULE 3
+#define CYG_INSTRUMENT_EVENT_SCHED_TIMESLICE 4
+
+// Thread events
+#define CYG_INSTRUMENT_EVENT_THREAD_SWITCH 1
+#define CYG_INSTRUMENT_EVENT_THREAD_SLEEP 2
+#define CYG_INSTRUMENT_EVENT_THREAD_WAKE 3
+#define CYG_INSTRUMENT_EVENT_THREAD_SUSPEND 4
+#define CYG_INSTRUMENT_EVENT_THREAD_RESUME 5
+#define CYG_INSTRUMENT_EVENT_THREAD_PRIORITY 6
+#define CYG_INSTRUMENT_EVENT_THREAD_DELAY 7
+#define CYG_INSTRUMENT_EVENT_THREAD_ALARM 8
+#define CYG_INSTRUMENT_EVENT_THREAD_ENTER 9
+#define CYG_INSTRUMENT_EVENT_THREAD_CHECK_STACK 10
+#define CYG_INSTRUMENT_EVENT_THREAD_ATTACH_STACK 11
+#define CYG_INSTRUMENT_EVENT_THREAD_CREATE 12
+
+// Interrupt events
+#define CYG_INSTRUMENT_EVENT_INTR_RAISE 1
+#define CYG_INSTRUMENT_EVENT_INTR_END 2
+#define CYG_INSTRUMENT_EVENT_INTR_RESTORE 3
+#define CYG_INSTRUMENT_EVENT_INTR_POST_DSR 4
+#define CYG_INSTRUMENT_EVENT_INTR_CALL_DSR 5
+#define CYG_INSTRUMENT_EVENT_INTR_ATTACH 6
+#define CYG_INSTRUMENT_EVENT_INTR_DETACH 7
+#define CYG_INSTRUMENT_EVENT_INTR_SET_VSR 8
+#define CYG_INSTRUMENT_EVENT_INTR_DISABLE 9
+#define CYG_INSTRUMENT_EVENT_INTR_ENABLE 10
+#define CYG_INSTRUMENT_EVENT_INTR_MASK 11
+#define CYG_INSTRUMENT_EVENT_INTR_UNMASK 12
+#define CYG_INSTRUMENT_EVENT_INTR_CONFIGURE 13
+#define CYG_INSTRUMENT_EVENT_INTR_ACK 14
+#define CYG_INSTRUMENT_EVENT_INTR_CHAIN_ISR 15
+#define CYG_INSTRUMENT_EVENT_INTR_SET_CPU 16
+#define CYG_INSTRUMENT_EVENT_INTR_GET_CPU 17
+
+// Mutex events
+#define CYG_INSTRUMENT_EVENT_MUTEX_LOCK 1
+#define CYG_INSTRUMENT_EVENT_MUTEX_WAIT 2
+#define CYG_INSTRUMENT_EVENT_MUTEX_LOCKED 3
+#define CYG_INSTRUMENT_EVENT_MUTEX_TRY 4
+#define CYG_INSTRUMENT_EVENT_MUTEX_UNLOCK 5
+#define CYG_INSTRUMENT_EVENT_MUTEX_WAKE 6
+#define CYG_INSTRUMENT_EVENT_MUTEX_RELEASE 7
+#define CYG_INSTRUMENT_EVENT_MUTEX_RELEASED 8
+
+// Condition variable events
+#define CYG_INSTRUMENT_EVENT_CONDVAR_WAIT 1
+#define CYG_INSTRUMENT_EVENT_CONDVAR_WOKE 2
+#define CYG_INSTRUMENT_EVENT_CONDVAR_SIGNAL 3
+#define CYG_INSTRUMENT_EVENT_CONDVAR_WAKE 4
+#define CYG_INSTRUMENT_EVENT_CONDVAR_BROADCAST 5
+#define CYG_INSTRUMENT_EVENT_CONDVAR_TIMED_WAIT 6
+
+// Binary semaphore events
+#define CYG_INSTRUMENT_EVENT_BINSEM_CLAIM 1
+#define CYG_INSTRUMENT_EVENT_BINSEM_WAIT 2
+#define CYG_INSTRUMENT_EVENT_BINSEM_WOKE 3
+#define CYG_INSTRUMENT_EVENT_BINSEM_TRY 4
+#define CYG_INSTRUMENT_EVENT_BINSEM_POST 5
+#define CYG_INSTRUMENT_EVENT_BINSEM_WAKE 6
+#define CYG_INSTRUMENT_EVENT_BINSEM_TIMEOUT 7
+
+// Counting semaphore events
+#define CYG_INSTRUMENT_EVENT_CNTSEM_CLAIM 1
+#define CYG_INSTRUMENT_EVENT_CNTSEM_WAIT 2
+#define CYG_INSTRUMENT_EVENT_CNTSEM_WOKE 3
+#define CYG_INSTRUMENT_EVENT_CNTSEM_TRY 4
+#define CYG_INSTRUMENT_EVENT_CNTSEM_POST 5
+#define CYG_INSTRUMENT_EVENT_CNTSEM_WAKE 6
+#define CYG_INSTRUMENT_EVENT_CNTSEM_TIMEOUT 7
+
+// Clock events
+#define CYG_INSTRUMENT_EVENT_CLOCK_TICK_START 1
+#define CYG_INSTRUMENT_EVENT_CLOCK_TICK_END 2
+#define CYG_INSTRUMENT_EVENT_CLOCK_ISR 3
+
+// Alarm events
+#define CYG_INSTRUMENT_EVENT_ALARM_ADD 1
+#define CYG_INSTRUMENT_EVENT_ALARM_REM 2
+#define CYG_INSTRUMENT_EVENT_ALARM_CALL 3
+#define CYG_INSTRUMENT_EVENT_ALARM_INIT 4
+#define CYG_INSTRUMENT_EVENT_ALARM_TRIGGER 5
+#define CYG_INSTRUMENT_EVENT_ALARM_INTERVAL 6
+
+// Mboxt events
+#define CYG_INSTRUMENT_EVENT_MBOXT_WAIT 1
+#define CYG_INSTRUMENT_EVENT_MBOXT_GET 2
+#define CYG_INSTRUMENT_EVENT_MBOXT_GOT 3
+#define CYG_INSTRUMENT_EVENT_MBOXT_TIMEOUT 4
+#define CYG_INSTRUMENT_EVENT_MBOXT_WAKE 5
+#define CYG_INSTRUMENT_EVENT_MBOXT_TRY 6
+#define CYG_INSTRUMENT_EVENT_MBOXT_PUT 7
+
+// SMP events
+#define CYG_INSTRUMENT_EVENT_SMP_LOCK_INC 1
+#define CYG_INSTRUMENT_EVENT_SMP_LOCK_ZERO 2
+#define CYG_INSTRUMENT_EVENT_SMP_LOCK_SET 3
+#define CYG_INSTRUMENT_EVENT_SMP_CPU_START 4
+#define CYG_INSTRUMENT_EVENT_SMP_LOCK_WAIT 5
+#define CYG_INSTRUMENT_EVENT_SMP_LOCK_GOT 6
+#define CYG_INSTRUMENT_EVENT_SMP_RESCHED_SEND 8
+#define CYG_INSTRUMENT_EVENT_SMP_RESCHED_RECV 9
+
+// MLQ scheduler events
+
+#define CYG_INSTRUMENT_EVENT_MLQ_SCHEDULE 1
+#define CYG_INSTRUMENT_EVENT_MLQ_RESCHEDULE 2
+#define CYG_INSTRUMENT_EVENT_MLQ_ADD 3
+#define CYG_INSTRUMENT_EVENT_MLQ_REM 4
+#define CYG_INSTRUMENT_EVENT_MLQ_TIMESLICE 5
+#define CYG_INSTRUMENT_EVENT_MLQ_YIELD 6
+#define CYG_INSTRUMENT_EVENT_MLQ_ENQUEUE 7
+#define CYG_INSTRUMENT_EVENT_MLQ_DEQUEUE 8
+#define CYG_INSTRUMENT_EVENT_MLQ_REMOVE 9
+
+
+// User events
+
+#define CYG_INSTRUMENT_EVENT_USER_1 1
+#define CYG_INSTRUMENT_EVENT_USER_2 2
+#define CYG_INSTRUMENT_EVENT_USER_3 3
+#define CYG_INSTRUMENT_EVENT_USER_4 4
+#define CYG_INSTRUMENT_EVENT_USER_5 5
+#define CYG_INSTRUMENT_EVENT_USER_6 6
+#define CYG_INSTRUMENT_EVENT_USER_7 7
+#define CYG_INSTRUMENT_EVENT_USER_8 8
+#define CYG_INSTRUMENT_EVENT_USER_9 9
+#define CYG_INSTRUMENT_EVENT_USER_10 10
+#define CYG_INSTRUMENT_EVENT_USER_11 11
+#define CYG_INSTRUMENT_EVENT_USER_12 12
+#define CYG_INSTRUMENT_EVENT_USER_13 13
+#define CYG_INSTRUMENT_EVENT_USER_14 14
+#define CYG_INSTRUMENT_EVENT_USER_15 15
+#define CYG_INSTRUMENT_EVENT_USER_16 16
+#define CYG_INSTRUMENT_EVENT_USER_17 17
+#define CYG_INSTRUMENT_EVENT_USER_18 18
+#define CYG_INSTRUMENT_EVENT_USER_19 19
+
+// -------------------------------------------------------------------------
+// Handy-dandy macro to make event codes.
+// Note that this relies on the definitions above
+// having a well defined form.
+
+#define CYGINST_EVENT(_class_,_event_) \
+((CYG_INSTRUMENT_CLASS_##_class_)|(CYG_INSTRUMENT_EVENT_##_class_##_##_event_))
+
+// -------------------------------------------------------------------------
+// Scheduler instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_SCHED
+
+#define CYG_INSTRUMENT_SCHED(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(SCHED,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_SCHED(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Thread instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_THREAD
+
+#define CYG_INSTRUMENT_THREAD(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(THREAD,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_THREAD(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Interrupt instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_INTR
+
+#define CYG_INSTRUMENT_INTR(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(INTR,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_INTR(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Mutex instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_MUTEX
+
+#define CYG_INSTRUMENT_MUTEX(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(MUTEX,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_MUTEX(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Condition variable instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_CONDVAR
+
+#define CYG_INSTRUMENT_CONDVAR(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(CONDVAR,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_CONDVAR(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Binary semaphore instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_BINSEM
+
+#define CYG_INSTRUMENT_BINSEM(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(BINSEM,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_BINSEM(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Counting semaphore instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_CNTSEM
+
+#define CYG_INSTRUMENT_CNTSEM(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(CNTSEM,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_CNTSEM(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Clock instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_CLOCK
+
+#define CYG_INSTRUMENT_CLOCK(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(CLOCK,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_CLOCK(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Alarm instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_ALARM
+
+#define CYG_INSTRUMENT_ALARM(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(ALARM,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_ALARM(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// Mboxt instrumentation macros
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_MBOXT
+
+#define CYG_INSTRUMENT_MBOXT(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(MBOXT,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_MBOXT(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// SMP instrumentation
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_SMP
+
+#define CYG_INSTRUMENT_SMP(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(SMP,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_SMP(_event_,_arg1_,_arg2_)
+
+#endif
+
+
+// -------------------------------------------------------------------------
+// MLQ instrumentation
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_MLQ
+
+#define CYG_INSTRUMENT_MLQ(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT(CYGINST_EVENT(MLQ,_event_),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_MLQ(_event_,_arg1_,_arg2_)
+
+#endif
+
+// -------------------------------------------------------------------------
+// User instrumentation
+
+#ifdef CYGDBG_KERNEL_INSTRUMENT_USER
+
+#define CYG_INSTRUMENT_USER(_event_,_arg1_,_arg2_) \
+ CYG_INSTRUMENT((CYG_INSTRUMENT_CLASS_USER|(_event_)),_arg1_,_arg2_)
+
+#else
+
+#define CYG_INSTRUMENT_USER(_event_,_arg1_,_arg2_)
+
+#endif
+
+
+// -------------------------------------------------------------------------
+#endif // ifndef CYGONCE_KERNEL_INSTRMNT_HXX
+// EOF instrmnt.h