--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/libraries/ltkutils/inc/ltkutils.h	Wed Jun 23 15:52:26 2010 +0100
@@ -0,0 +1,105 @@
+// ltkutils.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 FSHELL_UTILS
+#define FSHELL_UTILS
+
+#include <e32base.h>
+class RIoWriteHandle;
+class RFs;
+
+namespace LtkUtils
+	{
+	/* This function makes the object allocated at aPtr be ignored by __UHEAP_MARK/__UHEAP_MARK_END etc
+	 * This is useful for objects whose lifetime is carefully managed (ie they really aren't leaked) but have
+	 * no suitable place to be cleaned up. Objects stored in TLS are a good example.
+	 * Has no effect if run against a UREL euser.dll
+	 */
+	IMPORT_C void MakeHeapCellInvisible(TAny* aPtr);
+
+	IMPORT_C TInt InjectRawKeyEvent(TInt aScanCode, TInt aModifiers, TInt aRepeatCount);
+
+	IMPORT_C HBufC* HexDumpL(const TDesC8& aBuf);
+	IMPORT_C void HexDumpToOutput(const TDesC8& aBuf, RIoWriteHandle& aHandle);
+	IMPORT_C void HexDumpToOutput(const TDesC8& aBuf, RIoWriteHandle& aHandle, TInt& aOffset);
+	IMPORT_C void HexDumpToRDebug(const TDesC8& aBuf);
+	IMPORT_C void HexDumpToRDebug(const TDesC8& aBuf, TInt& aOffset);
+	IMPORT_C void RawPrint(const TDesC8& aDes); // 9.1 doesn't have the 8-bit overload
+
+	IMPORT_C void GetFriendlyThreadName(RThread aThread, TFullName& aFriendly);
+	IMPORT_C void MakeThreadNameFriendly(TFullName& aFullThreadName);
+	IMPORT_C void GetFriendlyProcessName(const RProcess& aProcess, TDes& aFriendly);
+	IMPORT_C void MakeProcessNameFriendly(TDes& aFullProcessName);
+
+	IMPORT_C TUint HexLexL(TLex16& aLex);
+	IMPORT_C TInt HexLex(TLex16& aLex, TUint& aResult);
+	IMPORT_C TUint HexLexL(TLex8& aLex);
+	IMPORT_C TInt HexLex(TLex8& aLex, TUint& aResult);
+
+	IMPORT_C TBool HasPrefix(const TDesC16& aDes, const TDesC16& aPrefix);
+	IMPORT_C TBool HasPrefix(const TDesC8& aDes, const TDesC8& aPrefix);
+
+	/* Replace all occurences of aFrom with aTo, in aDescriptor. Returns number of replacements,
+	 * or KErrOverflow if aDescriptor was not big enough to hold all the replacements
+	 */
+	IMPORT_C TInt ReplaceText(TDes& aDescriptor, const TDesC& aFrom, const TDesC& aTo);
+
+	IMPORT_C HBufC8* Utf8L(const TDesC& aString); // For more control see LtkUtils::RLtkBuf8::CopyAsUtf8L()
+	IMPORT_C HBufC16* DecodeUtf8L(const TDesC8& aUtf8EncodedText); // For more control see LtkUtils::RLtkBuf16::AppendUtf8L()
+
+	IMPORT_C void FormatSize(TDes16& aBuf, TInt64 aSizeInBytes);
+	IMPORT_C void FormatSize(TDes8& aBuf, TInt64 aSizeInBytes);
+
+	/* Some cleanup stack helper functions (defined in ltkutils.inl)
+	 */
+	template <class T>
+	inline void CleanupResetAndDestroyPushL(T& aRef);
+	template <class T>
+	inline void CleanupResetPushL(T& aRef);
+
+	/****
+	 * The functions below are not available if you're linking against ltkutils-tcb.dll. They
+	 * rely on being able to link against All -TCB dlls.
+	 ****/
+
+	/* W32CrackL loads our btrace-compatible wserv logging engine, dlogev.dll, into the existing wserv process. 
+	 * This enables Autometric to capture i/o events like key & pointer presses, and text drawn to screen.
+	 * It also enables btrace logging of windowgroup names. Does nothing if dlogev is already loaded.
+	 */
+	const TUid KW32CrackCategory = { 0x10003B20 };
+	const TInt KW32CrackKey = 0x102864C5;
+	IMPORT_C void W32CrackL();
+	IMPORT_C TBool W32CrackIsEnabled();
+
+	/* These functions convert a resource identifier (of the format given in the rez.exe docs) into
+	 * the localised equivalent.
+	 */
+	IMPORT_C HBufC* RezL(const TDesC& aIdentifier, RFs* aFs = NULL, HBufC** aError=NULL);
+	IMPORT_C HBufC* RezLC(const TDesC& aIdentifier, RFs* aFs = NULL, HBufC** aError=NULL);
+	IMPORT_C HBufC8* Rez8L(const TDesC& aIdentifier, RFs* aFs = NULL, HBufC** aError=NULL);
+	IMPORT_C HBufC8* Rez8LC(const TDesC& aIdentifier, RFs* aFs = NULL, HBufC** aError=NULL);
+
+	IMPORT_C void CopyToClipboardL(const TDesC& aText, RFs* aFs = NULL);
+	IMPORT_C HBufC* GetFromClipboardL(RFs* aFs = NULL);
+
+	
+	/* Programatically cause a breakpoint to occur. On emulator this translates to a call to __BREAKPOINT,
+	 * on target this will break if fdb is installed, otherwise will crash the thread.
+	 */
+	IMPORT_C void Breakpoint();
+
+	IMPORT_C void BreakpointPushL(); // Push a TCleanupItem onto the CleanupStack that calls LtkUtils::Breakpoint() if a leave occurs
+	IMPORT_C TLinAddr BreakpointAddr(); // Internal helper function, only for use by fdb.exe
+	}
+
+#include <fshell/ltkutils.inl>
+
+#endif