1 //==========================================================================
5 // Mbox mbox template class implementation
7 //==========================================================================
8 //####ECOSGPLCOPYRIGHTBEGIN####
9 // -------------------------------------------
10 // This file is part of eCos, the Embedded Configurable Operating System.
11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
13 // eCos is free software; you can redistribute it and/or modify it under
14 // the terms of the GNU General Public License as published by the Free
15 // Software Foundation; either version 2 or (at your option) any later version.
17 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
18 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22 // You should have received a copy of the GNU General Public License along
23 // with eCos; if not, write to the Free Software Foundation, Inc.,
24 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
26 // As a special exception, if other files instantiate templates or use macros
27 // or inline functions from this file, or you compile this file and link it
28 // with other works to produce a work based on this file, this file does not
29 // by itself cause the resulting work to be covered by the GNU General Public
30 // License. However the source code for this file must still be made available
31 // in accordance with section (3) of the GNU General Public License.
33 // This exception does not invalidate any other reasons why a work based on
34 // this file might be covered by the GNU General Public License.
36 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
37 // at http://sources.redhat.com/ecos/ecos-license/
38 // -------------------------------------------
39 //####ECOSGPLCOPYRIGHTEND####
40 //==========================================================================
41 //#####DESCRIPTIONBEGIN####
46 // Purpose: Mbox implementation
47 // Description: This file contains the implementations of the mbox class
49 //####DESCRIPTIONEND####
51 //==========================================================================
53 #include <pkgconf/kernel.h>
55 #include <cyg/kernel/ktypes.h> // base kernel types
56 #include <cyg/infra/cyg_trac.h> // tracing macros
57 #include <cyg/infra/cyg_ass.h> // assertion macros
58 #include <cyg/kernel/instrmnt.h> // instrumentation
60 #include <cyg/kernel/thread.inl> // Cyg_Thread inlines
62 #include <cyg/kernel/mbox.hxx> // our own header
64 #ifndef CYGIMP_MBOXT_INLINE // force inlining
65 #define CYGIMP_MBOXT_INLINE // of implementation
68 #ifdef CYGIMP_MBOX_USE_MBOXT_PLAIN
69 #include <cyg/kernel/mboxt.inl> // mbox template implementation
71 #include <cyg/kernel/mboxt2.inl> // mbox template implementation
74 // -------------------------------------------------------------------------
75 // This module exists to cause exactly one instance of these functions to
76 // exist; this is just like a vanilla class, except we use the template
77 // class to acquire an implementation. The template functions are inlined
78 // in each of these methods.
81 // -------------------------------------------------------------------------
88 // -------------------------------------------------------------------------
95 // -------------------------------------------------------------------------
96 // debugging/assert function
98 #ifdef CYGDBG_USE_ASSERTS
100 Cyg_Mbox::check_this(cyg_assert_class_zeal zeal) const
102 return m.check_this(zeal);
106 // -------------------------------------------------------------------------
107 // now the members themselves:
118 #ifdef CYGFUN_KERNEL_THREADS_TIMER
120 Cyg_Mbox::get( cyg_tick_count timeout )
123 if ( ! m.get( p, timeout ) )
133 if ( ! m.tryget( p ) )
138 #ifdef CYGMFN_KERNEL_SYNCH_MBOXT_PUT_CAN_WAIT
140 Cyg_Mbox::put( void *item )
142 return m.put( item );
145 #ifdef CYGFUN_KERNEL_THREADS_TIMER
147 Cyg_Mbox::put( void *item, cyg_tick_count timeout )
149 return m.put( item, timeout );
152 #endif // CYGMFN_KERNEL_SYNCH_MBOXT_PUT_CAN_WAIT
155 Cyg_Mbox::tryput( void *item )
157 return m.tryput( item );
161 Cyg_Mbox::peek_item() // Get next item to be returned
164 if ( ! m.peek_item( p ) )
169 // -------------------------------------------------------------------------