--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/kernel/eka/include/drivers/resmanus_trace.h Mon Oct 19 15:55:17 2009 +0100
@@ -0,0 +1,196 @@
+// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// e32\include\drivers\resmanus_trace.h
+//
+// WARNING: This file contains some APIs which are internal and are subject
+// to change without notice. Such APIs should therefore not be used
+// outside the Kernel and Hardware Services package.
+//
+
+/**
+ @file
+ @internalComponent
+*/
+#ifndef __RESMANUSCONTROL_TRACE_H__
+#define __RESMANUSCONTROL_TRACE_H__
+#ifdef BTRACE_RESMANUS
+
+//Function to format the output.
+static void UsTraceFormatPrint(TDes8& aBuf, const char* aFmt, ...)
+ {
+ if(!(&aBuf))
+ return;
+ VA_LIST list;
+ VA_START(list,aFmt);
+ Kern::AppendFormat(aBuf,aFmt,list);
+ }
+
+//definition of subcategories.
+#define PRM_US_OPEN_CHANNEL_START BTrace::EOpenChannelUsStart
+#define PRM_US_OPEN_CHANNEL_END BTrace::EOpenChannelUsEnd
+#define PRM_US_REGISTER_CLIENT_START BTrace::ERegisterClientUsStart
+#define PRM_US_REGISTER_CLIENT_END BTrace::ERegisterClientUsEnd
+#define PRM_US_DEREGISTER_CLIENT_START BTrace::EDeRegisterClientUsStart
+#define PRM_US_DEREGISTER_CLIENT_END BTrace::EDeRegisterClientUsEnd
+#define PRM_US_GET_RESOURCE_STATE_START BTrace::EGetResourceStateUsStart
+#define PRM_US_GET_RESOURCE_STATE_END BTrace::EGetResourceStateUsEnd
+#define PRM_US_SET_RESOURCE_STATE_START BTrace::ESetResourceStateUsStart
+#define PRM_US_SET_RESOURCE_STATE_END BTrace::ESetResourceStateUsEnd
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_START BTrace::ECancelGetResourceStateUsStart
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_END BTrace::ECancelGetResourceStateUsEnd
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_START BTrace::ECancelSetResourceStateUsStart
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_END BTrace::ECancelSetResourceStateUsEnd
+
+// Macro to output identification information provided in a request to open a channel
+#define PRM_US_OPEN_CHANNEL_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_OPEN_CHANNEL_START, 0, (TInt)(iClient), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output identification information generated during a request to open a channel
+#define PRM_US_OPEN_CHANNEL_END_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_OPEN_CHANNEL_END, 0, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information provided for a request to register with the Resource Controller
+#define PRM_US_REGISTER_CLIENT_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S 0x%x %d", iUserNameUsed, (TInt)(ClientHandle()),(TInt)(stateRes[0])); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_REGISTER_CLIENT_START, (TInt)(stateRes[1]), (TInt)(stateRes[2]), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information after issuing a request to register with the Resource Controller
+#define PRM_US_REGISTER_CLIENT_END_TRACE \
+ { \
+ BTraceContext8(BTrace::EResourceManagerUs, PRM_US_REGISTER_CLIENT_END, (TInt)(ClientHandle()), r); \
+ }
+
+// Macro to output information provided for a request to de-register with the Resource Controller
+#define PRM_US_DEREGISTER_CLIENT_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_DEREGISTER_CLIENT_START, 0, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information after issuing a request to de-register with the Resource Controller
+#define PRM_US_DEREGISTER_CLIENT_END_TRACE \
+ { \
+ BTraceContext4(BTrace::EResourceManagerUs, PRM_US_DEREGISTER_CLIENT_END, (TInt)(ClientHandle())); \
+ }
+
+// Macro to output information provided for a request to get the state of a resource
+#define PRM_US_GET_RESOURCE_STATE_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_GET_RESOURCE_STATE_START, resourceId, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information on completion of a request to get the state of a resource
+#define PRM_US_GET_RESOURCE_STATE_END_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%d %d", aClient, aResult); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_GET_RESOURCE_STATE_END, aResourceId, aLevel, printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information provided for a request to set the state of a resource
+#define PRM_US_SET_RESOURCE_STATE_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S %d", iUserNameUsed, (TInt)(ClientHandle())); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_SET_RESOURCE_STATE_START, resourceId, newState, printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information on completion of a request to set the state of a resource
+#define PRM_US_SET_RESOURCE_STATE_END_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%d %d", aClient, aResult); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_SET_RESOURCE_STATE_END, aResourceId, aLevel, printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information provided for a request to cancel the get resource state requests for a resource
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_CANCEL_GET_RESOURCE_STATE_START, aResourceId, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information on completion of a request to cancel the get resource state requests for a resource
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_END_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_CANCEL_GET_RESOURCE_STATE_END, aResourceId, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information provided for a request to cancel the set resource state requests for a resource
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_START_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_CANCEL_SET_RESOURCE_STATE_START, aResourceId, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+// Macro to output information on completion of a request to cancel the get resource state requests for a resource
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_END_TRACE \
+ { \
+ TBuf8<256> printBuf; \
+ printBuf.Zero(); \
+ UsTraceFormatPrint(printBuf, "%S ", iUserNameUsed); \
+ BTraceContextN(BTrace::EResourceManagerUs, PRM_US_CANCEL_SET_RESOURCE_STATE_END, aResourceId, (TInt)(ClientHandle()), printBuf.Ptr(), printBuf.Length()); \
+ }
+
+
+#else
+
+#define PRM_US_OPEN_CHANNEL_START_TRACE
+#define PRM_US_OPEN_CHANNEL_END_TRACE
+#define PRM_US_REGISTER_CLIENT_START_TRACE
+#define PRM_US_REGISTER_CLIENT_END_TRACE
+#define PRM_US_DEREGISTER_CLIENT_START_TRACE
+#define PRM_US_DEREGISTER_CLIENT_END_TRACE
+#define PRM_US_GET_RESOURCE_STATE_START_TRACE
+#define PRM_US_GET_RESOURCE_STATE_END_TRACE
+#define PRM_US_SET_RESOURCE_STATE_START_TRACE
+#define PRM_US_SET_RESOURCE_STATE_END_TRACE
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_START_TRACE
+#define PRM_US_CANCEL_GET_RESOURCE_STATE_END_TRACE
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_START_TRACE
+#define PRM_US_CANCEL_SET_RESOURCE_STATE_END_TRACE
+
+#endif //BTRACE_RESMANUS
+
+#endif //__RESMANUSCONTROL_TRACE_H__
+