epoc32/include/in_chk.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@2
     1
// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2
     2
// All rights reserved.
williamr@2
     3
// This component and the accompanying materials are made available
williamr@4
     4
// under the terms of "Eclipse Public License v1.0"
williamr@2
     5
// which accompanies this distribution, and is available
williamr@4
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2
     7
//
williamr@2
     8
// Initial Contributors:
williamr@2
     9
// Nokia Corporation - initial contribution.
williamr@2
    10
//
williamr@2
    11
// Contributors:
williamr@2
    12
//
williamr@2
    13
// Description:
williamr@2
    14
// in_chk.h - IPv6/IPv4 checksum module
williamr@2
    15
// Raw Internet Checksum computation from RMBufChain.
williamr@2
    16
//
williamr@2
    17
williamr@2
    18
williamr@2
    19
williamr@2
    20
/**
williamr@2
    21
 @file in_chk.h
williamr@2
    22
 @publishedAll
williamr@2
    23
 @released
williamr@2
    24
*/
williamr@2
    25
williamr@2
    26
#ifndef __IN_CHK_H__
williamr@2
    27
#define __IN_CHK_H__
williamr@2
    28
williamr@2
    29
#include "in_pkt.h"
williamr@4
    30
class RMBufChain;
williamr@4
    31
class RMBufPktInfo;
williamr@2
    32
williamr@2
    33
/** Checksum calculation.
williamr@2
    34
williamr@2
    35
@publishedAll
williamr@2
    36
@released
williamr@2
    37
*/
williamr@2
    38
class TChecksum {
williamr@2
    39
public:
williamr@2
    40
        // TChecksum can be initialized with an old inverted checksum
williamr@4
    41
        TChecksum(TUint16 aSum = ~0) : iSum((TUint16)~aSum) {}
williamr@2
    42
	inline void Init(TUint16 aSum = ~0);
williamr@2
    43
williamr@2
    44
	inline TUint32 Sum();
williamr@2
    45
        inline TUint32 Sum32();
williamr@2
    46
        inline void Fold();
williamr@2
    47
        inline void Reverse();
williamr@2
    48
williamr@2
    49
        // Complex Add methods
williamr@2
    50
        IMPORT_C void Add(RMBufChain &aPacket, TInt aOffset);
williamr@2
    51
        IMPORT_C void Add(RMBufChain &aPacket, const RMBufPktInfo *aInfo, TInt aOffset);
williamr@2
    52
williamr@2
    53
        // Inline Add methods
williamr@2
    54
        inline void Add(const TUint16 *aPtr, TInt aLength);
williamr@2
    55
        inline void AddHi(TUint8 aByte);
williamr@2
    56
        inline void AddLo(TUint8 aByte);
williamr@2
    57
        inline void Add(TUint16 aHalfWord);
williamr@2
    58
        inline void Add(TUint32 aWord);
williamr@2
    59
        inline void AddH(TUint16 aHalfWord);
williamr@2
    60
        inline void AddH(TUint32 aWord);
williamr@2
    61
williamr@2
    62
        // Static methods
williamr@2
    63
        static inline TUint32 Fold(TUint32 aSum);
williamr@2
    64
        static inline TUint16 ComplementedFold(TUint32 aSum);
williamr@2
    65
        IMPORT_C static TUint32 Calculate(const TUint16 *aPtr, TInt aLength);
williamr@2
    66
williamr@2
    67
private:
williamr@2
    68
	TUint32	iSum;   // 32-bit sum in network byte order
williamr@2
    69
};
williamr@2
    70
williamr@2
    71
williamr@2
    72
/**
williamr@2
    73
// TInet6Checksum Template.
williamr@2
    74
//
williamr@2
    75
//		This template class provides utilitlies to compute and check
williamr@2
    76
//		IPv6 Upper Layer Checksums
williamr@2
    77
//		These are not merged with the TInet6Packet class, because that
williamr@2
    78
//		class is intended (and is used) for all headers, not just upper
williamr@2
    79
//		layers.
williamr@2
    80
//
williamr@2
    81
//	The template parameter (Header class) must
williamr@2
    82
//		- have Checksum() method
williamr@2
    83
//		- have SetChecksum() method
williamr@2
    84
//		- the checkum in header must be aligned to 16 bit word
williamr@2
    85
//
williamr@2
    86
// @publishedAll
williamr@2
    87
// @released
williamr@2
    88
*/
williamr@2
    89
template <class T>
williamr@2
    90
class TInet6Checksum : public TInet6Packet<T>
williamr@2
    91
	{
williamr@2
    92
public:
williamr@2
    93
	TInet6Checksum() {}
williamr@2
    94
	TInet6Checksum(RMBufChain &aPacket) : TInet6Packet<T>(aPacket) {}
williamr@2
    95
	TInet6Checksum(RMBufChain &aPacket, TInt aOffset) : TInet6Packet<T>(aPacket, aOffset) {}
williamr@2
    96
	void ComputeChecksum(RMBufChain &aPacket, const RMBufPktInfo *aInfo, TInt aOffset = 0);
williamr@2
    97
	TBool VerifyChecksum(RMBufChain &aPacket, const RMBufPktInfo *aInfo, TInt aOffset = 0);
williamr@2
    98
	void ComputeChecksum();
williamr@2
    99
	TBool VerifyChecksum();
williamr@2
   100
	};
williamr@2
   101
williamr@2
   102
//
williamr@2
   103
// Inline methods for TChecksum
williamr@2
   104
//
williamr@2
   105
williamr@2
   106
inline void TChecksum::Init(TUint16 aSum)
williamr@2
   107
{
williamr@2
   108
        iSum = ~aSum & 0xffff;
williamr@2
   109
}
williamr@2
   110
williamr@2
   111
inline void TChecksum::Add(const TUint16 *aPtr, TInt aLength)
williamr@2
   112
{
williamr@2
   113
	iSum += Calculate(aPtr, aLength);
williamr@2
   114
}
williamr@2
   115
williamr@2
   116
inline void TChecksum::AddHi(TUint8 aByte)
williamr@2
   117
{
williamr@2
   118
        iSum += (aByte << 8);
williamr@2
   119
}
williamr@2
   120
williamr@2
   121
inline void TChecksum::AddLo(TUint8 aByte)
williamr@2
   122
{
williamr@2
   123
        iSum += aByte;
williamr@2
   124
}
williamr@2
   125
williamr@2
   126
// Add halfword in network byte order
williamr@2
   127
inline void TChecksum::Add(TUint16 aHalfWord)
williamr@2
   128
{
williamr@2
   129
        iSum += aHalfWord;
williamr@2
   130
}
williamr@2
   131
williamr@2
   132
// Add word in network byte order
williamr@2
   133
inline void TChecksum::Add(TUint32 aWord)
williamr@2
   134
{
williamr@2
   135
	iSum += aWord >> 16;
williamr@2
   136
        iSum += aWord & 0xffff;
williamr@2
   137
}
williamr@2
   138
williamr@2
   139
// Add halfword in host byte order
williamr@2
   140
inline void TChecksum::AddH(TUint16 aHalfWord)
williamr@2
   141
{
williamr@2
   142
		__DEBUG_ONLY (const TInt one = 1;)
williamr@2
   143
		ASSERT(*(TUint8*)&one); //check that we are little-endian
williamr@2
   144
williamr@2
   145
		iSum += ((aHalfWord << 8) | (aHalfWord >> 8)) & 0xffff;
williamr@2
   146
}
williamr@2
   147
williamr@2
   148
// Add word in host byte order
williamr@2
   149
inline void TChecksum::AddH(TUint32 aWord)
williamr@2
   150
{
williamr@2
   151
		__DEBUG_ONLY (const TInt one = 1;)
williamr@2
   152
		ASSERT(*(TUint8*)&one); //check that we are little-endian
williamr@2
   153
williamr@2
   154
        iSum += (aWord >> 24);          // add octet  3
williamr@2
   155
        iSum += (aWord >> 8) & 0xffff,  // add octets 2-1
williamr@2
   156
        iSum += (aWord << 8) & 0xff00;  // add octet  0
williamr@2
   157
}
williamr@2
   158
williamr@2
   159
// Fold 32-bit sum into 16 bits
williamr@2
   160
inline void TChecksum::Fold()
williamr@2
   161
{
williamr@2
   162
        iSum = Fold(iSum);
williamr@2
   163
}
williamr@2
   164
williamr@2
   165
// Return 16-bit inverted checksum
williamr@2
   166
inline TUint32 TChecksum::Sum()
williamr@2
   167
{
williamr@2
   168
        return Fold(iSum) ^ 0xffff;
williamr@2
   169
}
williamr@2
   170
williamr@2
   171
// Return 32-bit intermediate sum
williamr@2
   172
inline TUint32 TChecksum::Sum32()
williamr@2
   173
{
williamr@2
   174
        return iSum;
williamr@2
   175
}
williamr@2
   176
williamr@2
   177
// Reverse checksum direction. Can be used to back out partial sums.
williamr@2
   178
inline void TChecksum::Reverse()
williamr@2
   179
{
williamr@2
   180
        iSum = Sum();
williamr@2
   181
}
williamr@2
   182
williamr@2
   183
inline TUint32 TChecksum::Fold(TUint32 aSum)
williamr@2
   184
{
williamr@2
   185
	aSum = (aSum >> 16) + (aSum & 0xffff);  // Max: 0x0001fffe
williamr@2
   186
	aSum += (aSum >> 16);                   // Max: 0x0001ffff
williamr@2
   187
        return aSum & 0xffff;                   // Truncate to 16 bits
williamr@2
   188
}
williamr@2
   189
williamr@2
   190
inline TUint16 TChecksum::ComplementedFold(TUint32 aSum)
williamr@2
   191
{
williamr@2
   192
        return (TUint16)~Fold(aSum);
williamr@2
   193
}
williamr@2
   194
williamr@2
   195
template <class T>
williamr@2
   196
void TInet6Checksum<T>::ComputeChecksum(RMBufChain &aPacket, const RMBufPktInfo *aInfo, TInt aOffset)
williamr@2
   197
	{
williamr@2
   198
        TChecksum sum;
williamr@2
   199
	this->iHdr->SetChecksum(0);
williamr@2
   200
        sum.Add(aPacket, aInfo, aOffset);
williamr@2
   201
	this->iHdr->SetChecksum(sum.Sum());
williamr@2
   202
	}
williamr@2
   203
williamr@2
   204
template <class T>
williamr@2
   205
TBool TInet6Checksum<T>::VerifyChecksum(RMBufChain &aPacket, const RMBufPktInfo *aInfo, TInt aOffset)
williamr@2
   206
	{
williamr@2
   207
        TChecksum sum;
williamr@2
   208
        sum.Add(aPacket, aInfo, aOffset);
williamr@2
   209
        return !sum.Sum();
williamr@2
   210
	}
williamr@2
   211
//
williamr@2
   212
// The following are mainly for the IPv4 Header checksum
williamr@2
   213
//
williamr@2
   214
template <class T>
williamr@2
   215
void TInet6Checksum<T>::ComputeChecksum()
williamr@2
   216
	{
williamr@2
   217
        TChecksum sum;
williamr@2
   218
	this->iHdr->SetChecksum(0);
williamr@2
   219
        sum.Add((TUint16 *)(this->iHdr), this->iHdr->HeaderLength());
williamr@2
   220
	this->iHdr->SetChecksum(sum.Sum());
williamr@2
   221
	}
williamr@2
   222
williamr@2
   223
template <class T>
williamr@2
   224
TBool TInet6Checksum<T>::VerifyChecksum()
williamr@2
   225
	{
williamr@2
   226
        TChecksum sum;
williamr@2
   227
        sum.Add((TUint16*)(this->iHdr), this->iHdr->HeaderLength());
williamr@2
   228
        return !sum.Sum();
williamr@2
   229
	}
williamr@2
   230
williamr@2
   231
#endif