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