diff -r 000000000000 -r 2c201484c85f crypto/weakcrypto/inc/msymmetriccipher.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/crypto/weakcrypto/inc/msymmetriccipher.h Wed Jul 08 11:25:26 2009 +0100 @@ -0,0 +1,115 @@ +/* +* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "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: +* csymmetriccipher.h +* ** IMPORTANT ** PublishedPartner API's in this file are published to 3rd party developers via the +* Symbian website. Changes to these API's should be treated as PublishedAll API changes and the Security TA should be consulted. +* CSymmetricCipher class implementation +* +*/ + + + + +/** + @file + @publishedPartner + @released +*/ + +#ifndef __CSYMMETRICCIPHER_H__ +#define __CSYMMETRICCIPHER_H__ + +#include + +/** + * Top-level interface designed to collate the behaviour of all symmetric + * ciphers under one interface. + * + * See the Cryptography api-guide documentation. + * + * @publishedPartner + * @released + */ +class CSymmetricCipher : public CBase + { +public: + /** + * Runs the underlying transformation on aInput and appends the result to + * aOutput. + * + * For incremental buffering rules see the Cryptography api-guide documentation. + * + * @param aInput The input data to be processed. + * @param aOutput The resulting processed data appended to aOutput. aOutput must + * have MaxOutputLength() empty bytes remaining in its length. + */ + virtual void Process(const TDesC8& aInput, TDes8& aOutput) = 0; + + /** + * Pads aInput to be block aligned using the underlying padding system, if any, + * and then runs the underlying transformation on aInput, and appends the result + * to aOutput. + * + * For incremental buffering rules see the Cryptography api-guide documentation. + * + * @param aInput The input data to be processed. + * @param aOutput The resulting, possibly padded, processed data appended to + * aOutput. aOutput must have MaxFinalOutputLength() empty bytes + * remaining in its length. + */ + virtual void ProcessFinalL(const TDesC8& aInput, TDes8& aOutput) = 0; + + /** + * Gets a tight upper bound on the number of bytes that would be returned by a + * call to Process() with aInputLength bytes of data. + * + * @param aInputLength The length of data to be supplied to Process() in bytes. + * @return The length of data which would result from a call to + * Process() with an aInputLength number of bytes. + */ + virtual TInt MaxOutputLength(TInt aInputLength) const = 0; + + /** + * Gets as tight an upper bound as possible on the number of bytes that would + * be returned by a call to ProcessFinalL() with aInputLength bytes of data. + * + * @param aInputLength The length of data to be supplied to Process() in bytes. + * @return An upper bound on the length of data which would result from + * a call to ProcessFinalL() with an aInputLength number of bytes. + */ + virtual TInt MaxFinalOutputLength(TInt aInputLength) const = 0; + + /** + * Resets the cipher back to its original state. Clears all its buffers. + */ + virtual void Reset() = 0; + + /** + * Gets the block size in bytes (1 for stream ciphers). + * + * @return Block size of underlying cipher in bytes. + */ + virtual TInt BlockSize() const = 0; + + /** + * Gets the key size in bits. + * + * @return Key size in bits. + */ + virtual TInt KeySize() const = 0; +}; + + +#endif // __CSYMMETRICCIPHER_H__