libraries/extrabtrace/inc/extrabtracek.h
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Sun, 17 Oct 2010 18:43:12 +0100
changeset 69 849a0b46c767
parent 22 30834c0f3179
permissions -rw-r--r--
Fixed lots of issues with installing a low-caps version of fshell from SIS file. * Fixed issue in CCommandFactory whereby some APIs like GetCommandInfoL could trigger allocations on the wrong heap or signals to the wrong thread. The symptoms were often seen as a crash in the which_00 thread when running ciftest. * Lots of build fixes for when FSHELL_PROTECTED_UIDS isn't defined and when all capabilities aren't available. * Added new platform.mmh macro FSHELL_OPEN_SIGNED. * Open signing of fshell SIS files is now supported for production S60 handsets. Build fshell with the FSHELL_OPEN_SIGNED macro defined (and without defining FSHELL_CAP_ALL or FSHELL_PROTECTED_UIDS) in your platform.mmh and submit \epoc32\fshell\fshell.unsigned.sis to https://www.symbiansigned.com/app/page/public/openSignedOnline.do . The following commands are not available when using Open Signing due to Platform Security restrictions: fdb; kerninfo; chunkinfo; svrinfo; objinfo; sudo; fsck; localdrive; ramdefrag; readmem; reboot; setcritical; setpriority. Others such as chkdeps, e32header, ps, and fshell itself will run but in a restricted capacity (for example, fshell will no longer allow you to modify files in the \sys\bin directory). * Removed commands objinfo, svrinfo, chunkinfo, readmem, fsck completely when memory access isn't present - previously they would still appear in the help but would give an error if you tried to run them.

// extrabtracek.h
// 
// Copyright (c) 2010 Accenture. All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the "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:
// Accenture - Initial contribution
//
#ifndef EXTRABTRACEK_H
#define EXTRABTRACEK_H

#include <fshell/extrabtrace.h>
#include <kernel/kern_priv.h>

// This class avoids exporting functions from extrabtracek.ldd - something that has proved problematic on certain platforms
class MExtraBtrace
	{
public:
	typedef void (*TCpuUsageCallback)(NThread*, NThread*); // First arg is previous thread, second is current
	virtual void SetCpuUsageSampling(TCpuUsageCallback aCallbackFn)=0;
	virtual void SetProfilingSampling(TBool aEnabled)=0;

	virtual TAny* GetVersion(TInt aVersion)=0;
	virtual void MExtraBtrace_Close()=0;
	};


class DCpuSampler;
class DExtraBtraceEventHandler;

class DExtraBTraceFactory : public DLogicalDevice, public MExtraBtrace
	{
public:
	virtual TInt Install();
	virtual void GetCaps(TDes8& aDes) const;
	virtual TInt Create(DLogicalChannelBase*& aChannel);
	~DExtraBTraceFactory();

public: // From MExtraBtrace
	void SetCpuUsageSampling(TCpuUsageCallback aCallbackFn);
	void SetProfilingSampling(TBool aEnabled);
	TAny* GetVersion(TInt aVersion);
	void MExtraBtrace_Close();

public:
#ifndef __SMP__
	DCpuSampler* iSampler;
#endif
	DExtraBtraceEventHandler* iEventHandler;
	};


// This function avoids using WSD in extrabtracek.ldd - something that, again, has proved problematic on certain platforms
// (And it's inline because of aforementioned exports problem)

static MExtraBtrace* OpenExtraBtrace()
	{
	__ASSERT_CRITICAL;
	// Find the extrabtrace DLogicalDevice
	DLogicalDevice* ldd = NULL;
	DObjectCon* ldds = Kern::Containers()[ELogicalDevice];
	_LIT(KLogicalDeviceName, "extrabtrace");
	TKName resultname;
#ifdef FSHELL_9_1_SUPPORT
	TInt findHandle;
#else
	TFindHandle findHandle;
#endif
	TInt found = ldds->FindByName(findHandle, KLogicalDeviceName, resultname);
	if (found == KErrNone)
		{
		ldds->Wait();
#ifdef FSHELL_9_1_SUPPORT
		ldd = static_cast<DLogicalDevice*>(ldds->At(findHandle));
#else
		if (findHandle.Index() <= ldds->Count()) ldd = static_cast<DLogicalDevice*>((*ldds)[findHandle.Index()]);
#endif
		if (ldd && ldd->Open() != KErrNone) ldd = NULL;
		ldds->Signal();

		if (ldd)
			{
			return static_cast<DExtraBTraceFactory*>(ldd);
			}
		}
	return NULL;
	}

#endif