core/src/command_factory.h
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Sun, 17 Oct 2010 18:43:12 +0100
changeset 69 849a0b46c767
parent 0 7f656887cf89
child 78 b3ffff030d5c
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.

// command_factory.h
// 
// Copyright (c) 2006 - 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 __COMMAND_FACTORY_H__
#define __COMMAND_FACTORY_H__

#include <e32base.h>
#include "command_constructors.h"
#include "error.h"

class RFs;
class MCommand;
class CCommandSet;

class CCommandFactory : public CActive
	{
public:
	static CCommandFactory* NewL(RFs& aFs);
	~CCommandFactory();
	MCommand* CreateCommandL(const TDesC& aCommandName, TError& aErrorContext, const TDesC& aArguments);
	void ListCommandsL(RArray<TPtrC>& aList);
	TInt CountUniqueCommandsL();
	void GetCommandInfoL(const TDesC& aCommand, RLtkBuf16& aDescriptionBuf);
private:
	CCommandFactory(RFs& aFs);
	void ConstructL();
	void WatchFileSystem();
	void AddCommandL(CCommandConstructorBase* aCommandConstructor);
	void AddThreadCommandL(TCommandConstructor aConstructor, TUint aFlags = 0);
	void AddThreadCommandL(const TDesC& aCommandName, TCommandConstructor aConstructor, TUint aAttributes, TUint aFlags = 0);
	void AddAliasCommandL(const TDesC& aAliasName, TCommandConstructor aConstructor, const TDesC* aAdditionalArguments, const TDesC* aReplacementArguments, TUint aAttributes, TUint aFlags = 0);
	void CheckExternalCommands();
	void FindExternalCommandsL();
	void AppendExternalCommandsL(const TUidType& aUidType, const TDesC& aExtension);
	void DoAppendExternalCommandsL(const TEntry& aEntry, const TUidType& aUidType, const TDesC& aExtension);
	void WaitLC() const;
	TInt FindCommandL(const TDesC& aCommandName);
	MCommand* DoCreateCommandL(const TDesC& aCommandName, const TDesC& aArguments, RProcess& aProcess);
	static void Signal(TAny* aSelf);
private: // From CActive.
	virtual void RunL();
	virtual void DoCancel();
	virtual TInt RunError(TInt aError);
private:
	RFs& iFs;
	mutable RMutex iLock;
	RPointerArray<CCommandConstructorBase> iCommands;
	TDriveList iDriveList;
	TBool iFileSystemScanned;
	TBool iFailedToScanFileSystem;
	TThreadId iFactoryThreadId; // The one the CCommandFactory active object lives in
	RAllocator* iFactoryAllocator;
	};


#endif // __COMMAND_FACTORY_H__