sl@0: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // TSPConvUtil class
sl@0: // 
sl@0: //
sl@0: 
sl@0: #include <f32file.h>
sl@0: #include <e32cons.h>
sl@0: #include "D32Assert.h"
sl@0: #include "cn_util.h"
sl@0: #include "cn_main.h"
sl@0: #include "cn_cmdparse.h"
sl@0: 
sl@0: TBool TSPConvUtil::iPromptOnError = ETrue;
sl@0: 
sl@0: _LIT(KTxt0, "Program information");
sl@0: _LIT(KTxt1, "EDbSpConv version 1.0\n");
sl@0: _LIT(KTxt2, "Symbian OS text policy file/binary policy file converter\n");
sl@0: _LIT(KTxt3, "Copyright (c) 2004 Symbian Software Ltd. All rights reserved.\n");
sl@0: _LIT(KTxt4, "\nUsage:\n");
sl@0: _LIT(KTxt5, "EDbSpConv /h\n");
sl@0: _LIT(KTxt6, "EDbSpConv /f=<text file> /b=[path]\\<uid>[.spd] [/s]\n");
sl@0: _LIT(KTxt7, "\nWhere:\n");
sl@0: _LIT(KTxt8, "/h          - displays program information\n");
sl@0: _LIT(KTxt9, "<text file> - security policy text file, including path\n");
sl@0: _LIT(KTxt10,"<uid>[.spd] - security policy binary file\n");
sl@0: _LIT(KTxt11,"[path]      - optional - binary policy file path.\n");
sl@0: _LIT(KTxt12,"              By default the file will be placed in the current directory.\n");
sl@0: _LIT(KTxt13,"<uid>       - database format uid - hex\n");
sl@0: _LIT(KTxt14,"[/s]        - optional - does not wait for a button pressing in case\n");
sl@0: _LIT(KTxt15,"              of an error (when an error message is displayed).\n");
sl@0: 
sl@0: /**
sl@0: Prints program information.
sl@0: */
sl@0: static void PrintInfoL()
sl@0: 	{
sl@0: 	CConsoleBase* con = Console::NewL(KTxt0, TSize(KConsFullScreen, KConsFullScreen));
sl@0: 	CleanupStack::PushL(con);
sl@0: 	con->Printf(KTxt1);
sl@0: 	con->Printf(KTxt2);
sl@0: 	con->Printf(KTxt3);
sl@0: 	con->Printf(KTxt4);
sl@0: 	con->Printf(KTxt5);
sl@0: 	con->Printf(KTxt6);
sl@0: 	con->Printf(KTxt7);
sl@0: 	con->Printf(KTxt8);
sl@0: 	con->Printf(KTxt9);
sl@0: 	con->Printf(KTxt10);
sl@0: 	con->Printf(KTxt11);
sl@0: 	con->Printf(KTxt12);
sl@0: 	con->Printf(KTxt13);
sl@0: 	con->Printf(KTxt14);
sl@0: 	con->Printf(KTxt15);
sl@0: 	con->Getch();
sl@0: 	CleanupStack::PopAndDestroy(con);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Parses command line arguments and fills TCmdLinePrm structure with the parsed data.
sl@0: A a result of method's execution, the following items will be stored in aCmdLinePrm:
sl@0: requested action: (BIN->TXT) or (TXT->BIN), text policy file path and
sl@0: binary policy file path.
sl@0: If there is a "/s" command line argument and there are parsing errors, the error message
sl@0: will be stored in epocwind.out file only. By default (no "/s" command) the error messages 
sl@0: will be displayed on the screen and stored in epocwind.out file.
sl@0: @param aCmdLineParser A reference to a command line argument parser instance.
sl@0: @param aCmdLinePrm A reference to a TCmdLinePrm instance. Output parameter. The parsed
sl@0:                    command line arguments will be stored there.
sl@0: @leave KErrArgument Not enough command line arguments, bad argument, non-recognizable argument.
sl@0: @leave KErrNotFound Missing command line argument.
sl@0: */
sl@0: void TSPConvUtil::ParseL(const CCommandLineArguments& aCmdLineParser, 
sl@0: 						 TCmdLinePrm& aCmdLinePrm)
sl@0: 	{
sl@0: 	aCmdLinePrm.Zero();
sl@0: 	TInt prmCnt = aCmdLineParser.Count();
sl@0: 	if(prmCnt < 2)
sl@0: 		{//Print program information and exit
sl@0: 		::PrintInfoL();
sl@0: 		User::Exit(KErrNone);
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		//The comand is fixed explicitly, because now there is only one conversion:
sl@0: 		//from text policy file to binary policy file.
sl@0: 		aCmdLinePrm.iAction = TCmdLinePrm::ETxt2Bin;
sl@0: 		for(TInt i=0;i<prmCnt;++i)
sl@0: 			{
sl@0: 			TPtrC arg = aCmdLineParser.Arg(i);
sl@0: 			_LIT(KPrintInfoCmd, "/H");
sl@0: 			_LIT(KSuppressPromptCmd, "/S");
sl@0: 			_LIT(KTextFilePrm, "/F=");
sl@0: 			_LIT(KBinFilePrm, "/B=");
sl@0: 			TInt pos;
sl@0: 			if(arg == KPrintInfoCmd)
sl@0: 				{//Print program information and exit
sl@0: 				::PrintInfoL();
sl@0: 				User::Exit(KErrNone);
sl@0: 				}
sl@0: 			else if(arg == KSuppressPromptCmd)
sl@0: 				{
sl@0: 				TSPConvUtil::iPromptOnError = EFalse;
sl@0: 				}
sl@0: 			if((pos = arg.Find(KTextFilePrm)) != KErrNotFound)
sl@0: 				{
sl@0: 				if(pos != 0)
sl@0: 					{
sl@0: 					__LEAVE(KErrArgument);
sl@0: 					}
sl@0: 				aCmdLinePrm.iTxtFile.Copy(arg.Right(arg.Length() - KTextFilePrm().Length()));
sl@0: 				}
sl@0: 			else if((pos = arg.Find(KBinFilePrm)) != KErrNotFound)
sl@0: 				{
sl@0: 				if(pos != 0)
sl@0: 					{
sl@0: 					__LEAVE(KErrArgument);
sl@0: 					}
sl@0: 				aCmdLinePrm.iBinFile.Copy(arg.Right(arg.Length() - KBinFilePrm().Length()));
sl@0: 				}
sl@0: 			}//end of - for(TInt i=0;i<prmCnt;++i)
sl@0: 		}//end of else - if(prmCnt < 2)
sl@0: 	if(aCmdLinePrm.iAction == TCmdLinePrm::ENone)
sl@0: 		{
sl@0: 		_LIT(KText, "Invalid command line arguments, use \"/h\" option for help\n");
sl@0: 		TSPConvUtil::Print(KText);
sl@0: 		__LEAVE(KErrArgument);
sl@0: 		}
sl@0: 	if(aCmdLinePrm.iTxtFile.Length() == 0)
sl@0: 		{
sl@0: 		_LIT(KText, "No text file, use \"/h\" option for help\n");
sl@0: 		TSPConvUtil::Print(KText);
sl@0: 		__LEAVE(KErrArgument);
sl@0: 		}
sl@0: 	if(aCmdLinePrm.iBinFile.Length() == 0)
sl@0: 		{
sl@0: 		_LIT(KText, "No UID, use \"/h\" option for help\n");
sl@0: 		TSPConvUtil::Print(KText);
sl@0: 		__LEAVE(KErrArgument);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method checks if the file path (aFile parameter) exists.
sl@0: @param aFs File server session.
sl@0: @param aFile File path.
sl@0: @return ETrue - file exists, EFalse - file not found. EFalse may also reflect some kind of
sl@0:         file system error.
sl@0: */
sl@0: TBool TSPConvUtil::FileExists(RFs& aFs, const TDesC& aFile)
sl@0: 	{
sl@0: 	TEntry fileEntry;
sl@0: 	return aFs.Entry(aFile, fileEntry) == KErrNone;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method checks and constructs full binary policy file path from aFile parameter.
sl@0: @param aFile The expected format is:
sl@0:              1) <drive:>\<path>\<UID string>
sl@0:              2) <drive:>\<path>\<UID string>.spd
sl@0:              3) <UID string>
sl@0:              4) <UID string>.spd
sl@0: 			 '/' symbol might be used as a directory separator as well.
sl@0: 			 Output parameter - the created binary policy file path will be stored there.
sl@0: @leave KErrArgument Bad format of aFile input parameter.
sl@0: */
sl@0: void TSPConvUtil::ConstructBinFileNameL(TDes& aFile)
sl@0: 	{
sl@0: 	//Replace all '/' in aFile with '\', otherwise TParse won't work properly.
sl@0: 	TInt pos;
sl@0: 	while((pos = aFile.Locate('/')) != KErrNotFound)
sl@0: 		{
sl@0: 		aFile[pos] = '\\';
sl@0: 		}
sl@0: 	TParse fileNameParser;
sl@0: 	__LEAVE_IF_ERROR(fileNameParser.Set(aFile, NULL, NULL));
sl@0: 	TPtrC fileName = fileNameParser.Name();
sl@0: 	TUid dbUid;
sl@0: 	TLex lex(fileName);
sl@0: 	if(lex.Val(*(TUint32*)&dbUid, EHex) == KErrNone && lex.Eos())
sl@0: 		{
sl@0: 		if(dbUid != KNullUid)
sl@0: 			{
sl@0: 			_LIT(KExt, ".SPD");
sl@0: 			TPtrC fileExt = fileNameParser.Ext();
sl@0: 			if(fileExt.Length() == 0)
sl@0: 				{
sl@0: 				aFile.Append(KExt);
sl@0: 				}
sl@0: 			else if(fileExt != KExt)
sl@0: 				{
sl@0: 				_LIT(KText, "Invalid \"UID\" file extension: \"%S\"\n");
sl@0: 				TSPConvUtil::Print(KText, fileExt);
sl@0: 				__LEAVE(KErrArgument);
sl@0: 				}
sl@0: 			return;
sl@0: 			}
sl@0: 		}
sl@0: 	_LIT(KText, "Invalid \"UID\" file: \"%S\"\n");
sl@0: 	TSPConvUtil::Print(KText, aFile);
sl@0: 	__LEAVE(KErrArgument);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method extracts the UID from aFile parameter, which is expected to represent 
sl@0: binary security policy file path.
sl@0: The method asserts that the extracted UID is not KNullUid.
sl@0: @param aFile Binary policy file path
sl@0: @leave System-wide error codes from file name parsing or KErrNoMemory (from the parser creation).
sl@0: */
sl@0: TUid TSPConvUtil::UidFromFileNameL(const TDesC& aFile)
sl@0: 	{
sl@0: 	TParse* parser = new (ELeave) TParse;
sl@0: 	CleanupStack::PushL(parser);
sl@0: 	__LEAVE_IF_ERROR(parser->Set(aFile, NULL, NULL));
sl@0: 	TPtrC fileName = parser->Name();
sl@0: 	TUid domainUid;
sl@0: 	TLex lex(fileName);
sl@0: 	if(lex.Val(*(TUint32*)&domainUid, EHex) == KErrNone && lex.Eos() && domainUid != KNullUid)
sl@0: 		{
sl@0: 		}
sl@0: 	CleanupStack::PopAndDestroy(parser);
sl@0: 	__ASSERT(domainUid != KNullUid);
sl@0: 	return domainUid;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method prints aText string to epocwnd.out file and on the screen and waits for
sl@0: a button pressing.
sl@0: If "/s" command line argument is presented, the method won't wait for a button pressing.
sl@0: @param aText The text which has to be printed.
sl@0: */
sl@0: void TSPConvUtil::Print(const TDesC& aText)
sl@0: 	{
sl@0: 	RDebug::Print(aText);
sl@0: 	if(TSPConvUtil::iPromptOnError)
sl@0: 		{
sl@0: 		RNotifier notify;
sl@0: 		TInt err = notify.Connect();
sl@0: 		if(err == KErrNone)
sl@0: 			{
sl@0: 			TRequestStatus stat;
sl@0: 			TInt but;
sl@0: 			_LIT(KNotify,"EDBSPConv");
sl@0: 			_LIT(KContinue,"Continue");
sl@0: 			notify.Notify(KNotify, aText, KContinue, KNullDesC, but, stat);
sl@0: 			User::WaitForRequest(stat);
sl@0: 			notify.Close();
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			RDebug::Print(_L("Error=%d connecting notifier session!\n"), err);
sl@0: 			}
sl@0: 		}
sl@0: 	User::InfoPrint(aText);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method outputs a formatted text to epocwnd.out file and on the screen using aFormat 
sl@0: parameter as a format string and aNumber as a number which has to be printed out with 
sl@0: the supplied format string.
sl@0: If "/s" command line argument is presented, the method won't wait for a button pressing.
sl@0: @param aFormat The number format string.
sl@0: @param aNumber The number, which has to be printed together with the text. There must be a "%d"
sl@0:                format specification somewhere in aFormat parameter.
sl@0: */
sl@0: void TSPConvUtil::Print(const TDesC& aFormat, TInt aNumber)
sl@0: 	{
sl@0: 	TBuf<300> buf;
sl@0: 	buf.Format(aFormat, aNumber);
sl@0: 	TSPConvUtil::Print(buf);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method outputs a formatted text to epocwnd.out file and on the screen using aFormat 
sl@0: parameter as a format string and aText as a text which has to be printed out with the 
sl@0: supplied format string.
sl@0: If "/s" command line argument is presented, the method won't wait for a button pressing.
sl@0: @param aFormat The number format string.
sl@0: @param aText The text, which has to be formatted. There must be a "%S"
sl@0:                format specification somewhere in aFormat parameter.
sl@0: */
sl@0: void TSPConvUtil::Print(const TDesC& aFormat, const TDesC& aText)
sl@0: 	{
sl@0: 	TBuf<300> buf;
sl@0: 	buf.Format(aFormat, &aText);
sl@0: 	TSPConvUtil::Print(buf);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method outputs a formatted text to epocwnd.out file and on the screen using aFormat 
sl@0: parameter as a format string and aText1 and aText2 as texts which have to be printed 
sl@0: out with the supplied format string.
sl@0: If "/s" command line argument is presented, the method won't wait for a button pressing.
sl@0: @param aFormat The number format string.
sl@0: @param aText1 The text, which has to be printed out. There must be a "%S"
sl@0:                format specification somewhere in aFormat parameter.
sl@0: @param aText2 The text, which has to be printed out. There must be a "%S"
sl@0:                format specification somewhere in aFormat parameter.
sl@0: */
sl@0: void TSPConvUtil::Print(const TDesC& aFormat, const TDesC& aText1, const TDesC& aText2)
sl@0: 	{
sl@0: 	TBuf<500> buf;
sl@0: 	buf.Format(aFormat, &aText1, &aText2);
sl@0: 	TSPConvUtil::Print(buf);
sl@0: 	}
sl@0: