xref: /trunk/main/framework/inc/macros/debug/mutex.hxx (revision f8e07b45)
1*f8e07b45SAndrew Rist /**************************************************************
2cdf0e10cSrcweir  *
3*f8e07b45SAndrew Rist  * Licensed to the Apache Software Foundation (ASF) under one
4*f8e07b45SAndrew Rist  * or more contributor license agreements.  See the NOTICE file
5*f8e07b45SAndrew Rist  * distributed with this work for additional information
6*f8e07b45SAndrew Rist  * regarding copyright ownership.  The ASF licenses this file
7*f8e07b45SAndrew Rist  * to you under the Apache License, Version 2.0 (the
8*f8e07b45SAndrew Rist  * "License"); you may not use this file except in compliance
9*f8e07b45SAndrew Rist  * with the License.  You may obtain a copy of the License at
10*f8e07b45SAndrew Rist  *
11*f8e07b45SAndrew Rist  *   http://www.apache.org/licenses/LICENSE-2.0
12*f8e07b45SAndrew Rist  *
13*f8e07b45SAndrew Rist  * Unless required by applicable law or agreed to in writing,
14*f8e07b45SAndrew Rist  * software distributed under the License is distributed on an
15*f8e07b45SAndrew Rist  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*f8e07b45SAndrew Rist  * KIND, either express or implied.  See the License for the
17*f8e07b45SAndrew Rist  * specific language governing permissions and limitations
18*f8e07b45SAndrew Rist  * under the License.
19*f8e07b45SAndrew Rist  *
20*f8e07b45SAndrew Rist  *************************************************************/
21*f8e07b45SAndrew Rist 
22*f8e07b45SAndrew Rist 
23cdf0e10cSrcweir 
24cdf0e10cSrcweir #ifndef __FRAMEWORK_MACROS_DEBUG_MUTEX_HXX_
25cdf0e10cSrcweir #define __FRAMEWORK_MACROS_DEBUG_MUTEX_HXX_
26cdf0e10cSrcweir 
27cdf0e10cSrcweir //*****************************************************************************************************************
28cdf0e10cSrcweir //	special macros for mutex handling
29cdf0e10cSrcweir //*****************************************************************************************************************
30cdf0e10cSrcweir 
31cdf0e10cSrcweir #ifdef	ENABLE_MUTEXDEBUG
32cdf0e10cSrcweir 
33cdf0e10cSrcweir 	//_____________________________________________________________________________________________________________
34cdf0e10cSrcweir 	//	includes
35cdf0e10cSrcweir 	//_____________________________________________________________________________________________________________
36cdf0e10cSrcweir 
37cdf0e10cSrcweir 	#ifndef _RTL_STRBUF_HXX_
38cdf0e10cSrcweir 	#include <rtl/strbuf.hxx>
39cdf0e10cSrcweir 	#endif
40cdf0e10cSrcweir 
41cdf0e10cSrcweir 	/*_____________________________________________________________________________________________________________
42cdf0e10cSrcweir 		LOGFILE_MUTEX
43cdf0e10cSrcweir 
44cdf0e10cSrcweir 		For follow macros we need a special log file. If user forget to specify anyone, we must do it for him!
45cdf0e10cSrcweir 	_____________________________________________________________________________________________________________*/
46cdf0e10cSrcweir 
47cdf0e10cSrcweir 	#ifndef	LOGFILE_MUTEX
48cdf0e10cSrcweir         #define LOGFILE_MUTEX   "mutex.log"
49cdf0e10cSrcweir 	#endif
50cdf0e10cSrcweir 
51cdf0e10cSrcweir 	/*_____________________________________________________________________________________________________________
52cdf0e10cSrcweir         LOG_LOCKTYPE( _EFALLBACK, _ECURRENT )
53cdf0e10cSrcweir 
54cdf0e10cSrcweir         Write informations about current set lock type for whole framework project to special file.
55cdf0e10cSrcweir 	_____________________________________________________________________________________________________________*/
56cdf0e10cSrcweir 
57cdf0e10cSrcweir     #define LOG_LOCKTYPE( _EFALLBACK, _ECURRENT )                                                               \
58cdf0e10cSrcweir                 /* new scope to prevent us against multiple definitions of variables ... */                     \
59cdf0e10cSrcweir                 {                                                                                               \
60cdf0e10cSrcweir                     ::rtl::OStringBuffer _sBuffer( 256 );                                                       \
61cdf0e10cSrcweir                     _sBuffer.append( "Set framework lock type to fallback: \"" );                               \
62cdf0e10cSrcweir                     switch( _EFALLBACK )                                                                        \
63cdf0e10cSrcweir                     {                                                                                           \
64cdf0e10cSrcweir                         case E_NOTHING      :   _sBuffer.append( "E_NOTHING"    );                              \
65cdf0e10cSrcweir                                                 break;                                                          \
66cdf0e10cSrcweir                         case E_OWNMUTEX     :   _sBuffer.append( "E_OWNMUTEX"   );                              \
67cdf0e10cSrcweir                                                 break;                                                          \
68cdf0e10cSrcweir                         case E_SOLARMUTEX   :   _sBuffer.append( "E_SOLARMUTEX" );                              \
69cdf0e10cSrcweir                                                 break;                                                          \
70cdf0e10cSrcweir                         case E_FAIRRWLOCK   :   _sBuffer.append( "E_FAIRRWLOCK" );                              \
71cdf0e10cSrcweir                                                 break;                                                          \
72cdf0e10cSrcweir                     }                                                                                           \
73cdf0e10cSrcweir                     _sBuffer.append( "\"\n" );                                                                  \
74cdf0e10cSrcweir                     if( _EFALLBACK != _ECURRENT )                                                               \
75cdf0e10cSrcweir                     {                                                                                           \
76cdf0e10cSrcweir                         _sBuffer.append( "... environment overwrite framework lock type with: \"" );            \
77cdf0e10cSrcweir                         switch( _ECURRENT )                                                                     \
78cdf0e10cSrcweir                         {                                                                                       \
79cdf0e10cSrcweir                             case E_NOTHING      :   _sBuffer.append( "E_NOTHING"    );                          \
80cdf0e10cSrcweir                                                     break;                                                      \
81cdf0e10cSrcweir                             case E_OWNMUTEX     :   _sBuffer.append( "E_OWNMUTEX"   );                          \
82cdf0e10cSrcweir                                                     break;                                                      \
83cdf0e10cSrcweir                             case E_SOLARMUTEX   :   _sBuffer.append( "E_SOLARMUTEX" );                          \
84cdf0e10cSrcweir                                                     break;                                                      \
85cdf0e10cSrcweir                             case E_FAIRRWLOCK   :   _sBuffer.append( "E_FAIRRWLOCK" );                          \
86cdf0e10cSrcweir                                                     break;                                                      \
87cdf0e10cSrcweir                         }                                                                                       \
88cdf0e10cSrcweir                         _sBuffer.append( "\"\n" );                                                              \
89cdf0e10cSrcweir                     }                                                                                           \
90cdf0e10cSrcweir                     else                                                                                        \
91cdf0e10cSrcweir                     {                                                                                           \
92cdf0e10cSrcweir                         _sBuffer.append( "... use fallback, because user don't set another value!\n" );         \
93cdf0e10cSrcweir                     }                                                                                           \
94cdf0e10cSrcweir                     WRITE_LOGFILE( LOGFILE_MUTEX, _sBuffer.makeStringAndClear() )                               \
95cdf0e10cSrcweir                 }
96cdf0e10cSrcweir 
97cdf0e10cSrcweir #else	// #ifdef ENABLE_MUTEXDEBUG
98cdf0e10cSrcweir 
99cdf0e10cSrcweir 	/*_____________________________________________________________________________________________________________
100cdf0e10cSrcweir 		If right testmode is'nt set - implements these macro with normal functionality!
101cdf0e10cSrcweir 		We need the guard but not the log mechanism.
102cdf0e10cSrcweir 	_____________________________________________________________________________________________________________*/
103cdf0e10cSrcweir 
104cdf0e10cSrcweir 	#undef	LOGFILE_MUTEX
105cdf0e10cSrcweir     #define LOG_LOCKTYPE( _EFALLBACK, _ECURRENT )
106cdf0e10cSrcweir 
107cdf0e10cSrcweir #endif	// #ifdef ENABLE_MUTEXDEBUG
108cdf0e10cSrcweir 
109cdf0e10cSrcweir //*****************************************************************************************************************
110cdf0e10cSrcweir //	end of file
111cdf0e10cSrcweir //*****************************************************************************************************************
112cdf0e10cSrcweir 
113cdf0e10cSrcweir #endif	// #ifndef __FRAMEWORK_MACROS_DEBUG_MUTEX_HXX_
114