diff -r 000000000000 -r a41df078684a kernel/eka/include/drivers/resmanus_trace.h --- /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__ +