diff -r 3ff3fecb12fe -r 6a82cd05fb1e memana/analyzetoolclient/commandlineengine/internal/src/helps.cpp --- a/memana/analyzetoolclient/commandlineengine/internal/src/helps.cpp Thu Feb 11 15:52:57 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,205 +0,0 @@ -/* -* Copyright (c) 2009 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: Contains help texts for CLE. -* -*/ -#include "../inc/ATCommonDefines.h" - -//Function declarations -void print_help( void ); -void print_syntax_examples( void ); - -/** -* Print help info. -*/ -void print_help( void ) -{ - cout<< "S60 AnalyzeTool v"; - cout<< ATOOL_VERSION; - cout<< " - "; - cout<< ATOOL_DATE; - cout<< "\n"; - cout<< "Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).\nAll rights reserved.\n\n"; - cout<< "Usage:\n"; - cout<< "atool -e [optional parameters] abld [abld parameters]\n"; - cout<< " -me [optional parameters] abld [abld parameters]\n"; - cout<< " -mi [optional parameters] [-f data-file] sbs [sbs parameters]\n"; -#ifdef HTI_SUPPORT - cout<< " -g [data-file]\n"; -#endif - cout<< " -a data-file [output-file] [-s symbol-file] [-l#]\n"; - cout<< " -p data-file output-file\n"; -#ifdef HTI_SUPPORT - cout<< " -delete data-file\n"; -#endif - cout<< " -c\n"; - cout<< " -v\n"; - cout<< " -help\n"; - cout<< "\n"; - cout<< "Mandatory parameter to choose:\n"; - cout<< " -e Build project for analysis using external data gathering.\n"; - cout<< " -me Build project for analysis using monitored external\n"; - cout<< " data gathering.\n"; - cout<< " -mi Build project for analysis using monitored internal\n"; - cout<< " data gathering.\n"; - cout<< " abld... Use SBS v.1 build system with defined build command,\n"; - cout<< " which includes supported platform and build type.\n"; - cout<< " sbs... Use SBS v.2 (Raptor) build system with defined sbs build\n"; - cout<< " command, which includes supported platform and build type.\n"; - cout<< " -a Analyze report file.\n"; - cout<< " -c Clear AnalyzeTool changes, temporary files and releasable(s).\n"; - cout<< " -p Parse trace file to data file.\n"; -#ifdef HTI_SUPPORT - cout<< " -g Get analyze reports from device. Without the file name\n"; - cout<< " gives a list of available files. If file name * all available\n"; - cout<< " files on device are saved to current directory.\n"; - cout<< " -delete Delete datafile from the phone.\n"; -#endif - cout<< " -help Show full help including syntax examples.\n"; - cout<< " -v Print version info.\n"; - cout<< "\n"; - - cout<< "Optional parameters:\n"; - cout<< " -acs size Specifies the call stack size gathered when memory\n"; - cout<< " is allocated. Size can be between 0-256.\n"; - cout<< " -fcs size Specifies the call stack size gathered when memory is freed.\n"; - cout<< " Size can be between 0-256.\n"; - cout<< " -f data file Specifies the filename for monitored internal data gathering\n"; - cout<< " (50 chars max). Cannot contain path.\n"; - cout<< " output-file Specifies the results data file name.\n"; - cout<< " -l Logging level of analyze report(0,1,2,3), default 3.\n"; - cout<< " -s symbol-file Specifies rom/rofs symbol file(s) to be used in analyze.\n"; - cout<< " Multiple -s options can be given.\n"; - cout<< " -nobuild Instruments the project.\n"; - //cout<< " -show_debug Print debug messages to console.\n"; - //cout<< " -show_debug_all Print debug messages to console (all).\n"; - //cout<< " -show_dbgview Print debug messages to windows debug api.\n"; - //cout<< " -show_dbgview_all Print debug messages to windows debug api (all).\n"; - - /* - * Old style parameters, just for notes. - printf("Usage:\n"); - printf("atool -m [mmp-file] [mode] [data-file] [-variant variant-name] [build] [-sbs2] [-e]\n"); - printf(" -i [mmp-file] [mode] [data-file] [-variant variant-name] [build] [-sbs2] [-e]\n"); -#ifdef HTI_SUPPORT - printf(" -g [data-file]\n"); -#endif - printf(" -a [mmp-file | target-name] data-file [-s symbol-file]\n"); - printf(" [output-file] [-l#]\n"); - printf(" -p data-file [output-file]\n"); -#ifdef HTI_SUPPORT - printf(" -delete data-file\n"); -#endif - printf(" -c\n"); - //printf(" -u\n"); - printf(" -v\n"); - printf(" -help\n"); - printf("\n"); - printf("Mandatory option to choose:\n"); - printf(" -m Build project for analysis.\n"); - printf(" -i Instrument project.\n"); - printf(" -a Analyze report file.\n"); - //printf(" -u Create listing & map files.\n"); - printf(" -c Clear AnalyzeTool changes and temporary files.\n"); - printf(" -p Parse trace file.\n"); -#ifdef HTI_SUPPORT - printf(" -g Get analyze reports from phone. Without the file name\n"); - printf(" gives a list of available files.\n"); -#endif -#ifdef HTI_SUPPORT - printf(" -delete Delete datafile from the phone.\n"); -#endif - printf(" -help Show full help including syntax examples.\n"); - printf("\n"); - - printf("Optional options:\n"); - printf(" mmp-file Specifies one of the component from bld.inf which is used.\n"); - printf(" target-name Specifies the target name of binary to which create\n"); - printf(" analyze report.\n"); - printf(" mode Logging mode (XTI or S60), default XTI.\n"); - printf(" data-file Specifies the user defined data file name (50 chars max).\n"); - printf(" build Build target (udeb or urel), default udeb.\n"); - printf(" output-file Specifies the results data file name.\n"); - printf(" -l Logging level of analyze report(0,1,2,3), default 3.\n"); - printf(" -variant Specifies Symbian binary variant to be used.\n"); - printf(" variant-name Specifies the variant name to be used.\n"); - printf(" -s Specifies rom symbol file be used in analyze.\n"); - printf(" symbol-file Full path to rom symbol file used in analyze.\n"); - printf(" -sbs2 Use Symbian Build System v.2.\n"); - printf(" -winscw Build project for emulator (winscw platform).\n"); - printf(" -v Print version info.\n"); - */ -} - -void print_syntax_examples( void ) -{ -//Helper line showing width of 80 chars. -//80cout<< "12345678901234567890123456789012345678901234567890123456789012345678901234567890"; - cout<< endl; - cout<< "Building syntax examples:" << endl; - cout<< "Cmd Description" << endl; - - cout<< "atool -e abld build armv5 udeb" << endl; - cout<< " Hooks every component from bld.inf. Using external data gathering," << endl; - cout<< " udeb build type and armv5 platform." << endl; - - cout<< "atool -mi -acs 5 sbs -c winscw_udeb" << endl; - cout<< " Hooks every component from bld.inf. Using Symbian Build System v.2" << endl; - cout<< " Using monitored internal data gathering, call stack size of 5" << endl; - cout<< " in allocations, udeb build type and winscw platform." << endl; - - cout<< "atool -me abld build armv5 udeb foobar" << endl; - cout<< " Hooks only foobar.mmp component from bld.inf. Using monitored" << endl; - cout<< " external data gathering, udeb build type and armv5 platform." << endl; - - cout<< "atool -e -acs 0 -fcs 0 abld build armv5.default udeb" << endl; - cout<< " Hooks every component from bld.inf. Using default binary variant," << endl; - cout<< " external data gathering, 0 sized callstacks in allocation(s)/free(s)," << endl; - cout<< " udeb build type and armv5 platform." << endl; - - cout<< "atool -e sbs -b bld.inf -c armv5_udeb" << endl; - cout<< " Hooks every component from bld.inf. Using Symbian Build System v.2" << endl; - cout<< " , external data gathering, udeb build type and armv5 platform." << endl; - - cout<< "atool -me sbs -s system.xml --config=winscw_udeb" << endl; - cout<< " Hooks every layer defined in system.xml system model. Using Symbian Build" << endl; - cout<< " System v.2, external data gathering, udeb build type and winscw platform." << endl; - - cout<< endl; - cout<< "Instrumenting syntax examples:" << endl; - cout<< "Cmd Description" << endl; - cout<< "atool -e -nobuild abld build winscw udeb" << endl; - cout<< " Instruments every component from bld.inf. Using external data gathering,"<