1 /*

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

     3 * All rights reserved.

     4 *

     5 * Redistribution and use in source and binary forms, with or without

     6 * modification, are permitted provided that the following conditions are met:

     7 *

     8 * - Redistributions of source code must retain the above copyright notice,

     9 *   this list of conditions and the following disclaimer.

    10 * - Redistributions in binary form must reproduce the above copyright notice,

    11 *   this list of conditions and the following disclaimer in the documentation

    12 *   and/or other materials provided with the distribution.

    13 * - Neither the name of Nokia Corporation nor the names of its contributors

    14 *   may be used to endorse or promote products derived from this software

    15 *   without specific prior written permission.

    16 *

    17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

    18 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

    19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

    20 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE

    21 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

    22 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

    23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

    24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

    25 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

    26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

    27 * POSSIBILITY OF SUCH DAMAGE.

    28 * 

    29 * Initial Contributors:

    30 * Nokia Corporation - initial contribution.

    31 *

    32 * Contributors:

    33 *

    34 * Description: 

    35 *

    36 */

    37 

    38 using System;

    39 using System.Collections;

    40 using System.Collections.Generic;

    41 using System.Text;

    42 using SymbianUtils.RawItems;

    43 using SymbianUtils.Utilities;

    44 using HeapLib.Cells;

    45 

    46 namespace HeapLib.Relationships

    47 {

    48     public class RelationshipInfo

    49     {

    50         #region Constructors & destructor

    51         public RelationshipInfo()

    52         {

    53         }

    54 

    55         public RelationshipInfo( HeapCell aFromCell, RawItem aRawItemInFromCell, HeapCell aToCell )

    56         {

    57             FromCell = aFromCell;

    58             FromCellRawItem = aRawItemInFromCell;

    59             ToCell = aToCell;

    60         }

    61         #endregion

    62 

    63         #region Properties

    64         // <summary>

    65         //  The cell which contains the emebdded reference

    66         // </summary>

    67         public HeapCell FromCell

    68         {

    69             get { return iFromCell; }

    70             set { iFromCell = value; }

    71         }

    72 

    73         // <summary>

    74         // The cell to which the embedded reference points

    75         // </summary>

    76         public HeapCell ToCell

    77         {

    78             get { return iToCell; }

    79             set { iToCell = value; }

    80         }

    81 

    82         // <summary>

    83         // The raw item in the 'from' cell that points to

    84         // the 'to' cell.

    85         // </summary>

    86         public RawItem FromCellRawItem

    87         {

    88             get { return iFromCellRawItem; }

    89             set { iFromCellRawItem = value; }

    90         }

    91 

    92         // <summary>

    93         // A clean link, is one that goes from within 'from cell' to

    94         // the very start of 'to cell's' payload section

    95         // </summary>

    96         public bool IsCleanLink

    97         {

    98             get

    99             {

   100                 RawItem rawItemInFromCell = FromCellRawItem;

   101                 uint exactMatchAddress = rawItemInFromCell.Data - HeapCell.AllocatedCellHeaderSize;

   102                 uint destinationAddress = ToCell.Address;

   103                 bool cleanMatch = ( destinationAddress == exactMatchAddress );

   104                 //

   105                 return cleanMatch;

   106             }

   107         }

   108 

   109         // <summary>

   110         // This is the offset, in bytes into the 'from' cell that contains

   111         // the raw item that points to the 'to' cell.

   112         // </summary>

   113         public uint LinkAddressOffsetWithinFromCell

   114         {

   115             get

   116             {

   117                 uint ret = FromCellRawItem.Address - FromCell.Address;

   118                 return ret;

   119             }

   120         }

   121         #endregion

   122 

   123         #region From System.Object

   124         public override string ToString()

   125         {

   126             return ToCell.ToStringExtended();

   127         }

   128         #endregion

   129 

   130         #region Data members

   131         private HeapCell iFromCell = new HeapCell();

   132         private HeapCell iToCell = new HeapCell();

   133         private RawItem iFromCellRawItem = new RawItem();

   134         #endregion

   135     }

   136 }