tracesrv/tracecore/btrace_handler/inc/BTraceKernelCategoryHandler.h
changeset 56 aa2539c91954
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tracesrv/tracecore/btrace_handler/inc/BTraceKernelCategoryHandler.h	Fri Oct 08 14:56:39 2010 +0300
@@ -0,0 +1,175 @@
+// Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "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:
+// Handler for BTrace kernel categories 
+//
+
+#ifndef __BTRACEKERNELCATEGORYHANDLER_H__
+#define __BTRACEKERNELCATEGORYHANDLER_H__
+
+
+// Include files
+#include <kernel/kernel.h>
+#include "BTraceCategoryHandler.h"
+#include "TraceCoreActivation.h"
+
+
+// Forward declarations
+class DBTraceOstCategoryBitmap;
+
+
+/**
+ * Category handler for Symbian BTrace categories.
+ */
+NONSHARABLE_CLASS( DBTraceKernelCategoryHandler ) : public DBTraceCategoryHandler, public MTraceCoreActivationNotification
+    {
+public:
+
+    /**
+     * Constructor
+     */
+    DBTraceKernelCategoryHandler();
+     
+     /**
+      * Destructor
+      */
+    ~DBTraceKernelCategoryHandler();
+        
+    /**
+     * Initializes this handler
+     * 
+     * @return one of the standard error codes
+     */
+    TInt Init();
+
+    /**
+     * Called before writer is changed
+     *
+     * @param aWriter The new writer
+     */
+    void PrepareSetWriter( DTraceCoreWriter* aWriter );
+    
+	/**
+ 	 * Primes the BTrace kernel categories    
+ 	 */
+	void PrimeKernelCategories();
+
+private:
+
+    /**
+     * Notification that the activation state has changed
+     * 
+     * @param aActivation the activation interface that was updated
+     * @param aFromSettings ETrue if activation was due to settings read, EFalse if from some other source
+     * @param aComponentId Component ID of the activation
+     */
+    void ActivationChanged( MTraceCoreActivation& aActivation, TBool aFromSettings,
+            TUint32 aComponentId);
+    
+    /**
+     * MTraceCoreBTraceCategoryHandler implementation for Symbian-specific BTrace categories
+     *
+     * @param aHeader BTrace header
+     * @param aHeader2 Extra header data
+     * @param aContext The thread context in which this function was called
+     * @param a1 The first trace parameter
+     * @param a2 The second trace parameter
+     * @param a3 The third trace parameter
+     * @param aExtra Extra trace data
+     * @param aPc The program counter value
+     * @return ETrue if trace was processed
+     */
+    TBool HandleFrame( TUint32 aHeader, TUint32 aHeader2, const TUint32 aContext, 
+                       const TUint32 a1, const TUint32 a2, const TUint32 a3, 
+                       const TUint32 aExtra, const TUint32 aPc );
+    
+    /**
+     * Maps the BTrace category / sub-category to group / trace ID
+     * 
+     * @param aCategory The BTrace category
+     * @param aSubCategory The BTrace sub-categoory
+     * @return the group / trace ID combination
+     */
+    TUint32 MapCategoryToID( TUint8 aCategory, TUint8 aSubCategory );
+    
+    /**
+     * Dfc function to prime the kernel categories
+     * 
+     * @param aHandler pointer to this handler
+     */
+    static void PrimeDfc( TAny* aHandler );
+    
+    /**
+     * Called from the static DFC function to prime kernel categories
+     */
+    void PrimeDfc();
+
+    /**
+     * Primes a category
+     * 
+     * @param aCategory the category to be primed
+     */
+    void PrimeCategory( TUint8 aCategory );
+    
+private:
+
+    /**
+     * Handles this Multipart trace
+     *
+     * @param aHeader BTrace header
+     * @param aHeader2 Extra header data
+     * @param aContext The thread context in which this function was called
+     * @param aTotalMessageLength Total message length of this multipart message 
+     * @param aComponentId Component ID
+     * @param aData The data
+     * @param aExtra Extra trace data
+     * @param aPc The program counter value
+     */
+    TBool HandleMultiPart( TUint32 aHeader, TUint32 aHeader2, const TUint32 aContext,
+                       const TUint32 aTotalMessageLength, const TUint32 aComponentId,
+                       const TUint32 aData, const TUint32 aExtra, const TUint32 aPc );
+    
+    /**
+     * Checks if given trace is a Multipart trace
+     *
+     * @param aHeader Header data
+     * @param aHeader2 Extra header data
+     */
+    inline TBool CheckMultiPart( TUint32 aHeader, TUint32 aHeader2 );
+    
+    /**
+     * Calculates data start offset
+     *
+     * @param aHeader BTrace header
+     */
+    TUint32 CalculateDataStartOffset( TUint32 aHeader );    
+    
+    /**
+     * This uses the same bitmap as the OST category handler
+     */
+    DBTraceOstCategoryBitmap* iTraceBitmap;
+    
+    /**
+     * Dfc used when priming kernel categories
+     */
+    TDfc iPrimeDfc;
+    
+    /**
+     * Saved activation item for multipart traces
+     */ 
+    RArray< TMultiPartActivationInfo > iMultiPartActivationInfos;
+    };
+    
+#endif
+
+// End of File