1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Interface definition for locating code lines using memory addresses.

    15 *

    16 */

    17 #ifndef __IADDRESSTOLINE_H__

    18 #define __IADDRESSTOLINE_H__

    19 

    20 #include "ATCommonDefines.h"

    21 

    22 class CATMemoryAddress;

    23 

    24 class IAddressToLine

    25 {

    26 public:

    27 	IAddressToLine() {};

    28 	virtual ~IAddressToLine() {};

    29 	/**

    30 	* Open binary.

    31 	* @sString

    32 	* @iNumber

    33 	* @return true if successful.

    34 	*/

    35 	virtual bool Open( const string& sString, const unsigned long iLong) = 0;

    36 	

    37 	/**

    38 	* Get error string. In case of any method failed use this to acquire details on error.

    39 	* @return error string.

    40 	*/

    41 	virtual string GetError( void ) = 0;

    42 

    43 	/**

    44 	* Close binary.

    45 	* @return true if succesful.

    46 	*/

    47 	virtual bool Close( void ) = 0;

    48 

    49 	/**

    50 	* Locate code line and file for given address.

    51 	* @result

    52 	* @return true if successful.

    53 	*/

    54 	virtual bool AddressToLine( CATMemoryAddress* result ) = 0;

    55 };

    56 #endif