diff -r 675a964f4eb5 -r 35751d3474b7 crypto/weakcryptospi/inc/spi/randomplugin.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/crypto/weakcryptospi/inc/spi/randomplugin.h Thu Sep 10 14:01:51 2009 +0300 @@ -0,0 +1,73 @@ +/* +* Copyright (c) 2006-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: +* Random generator interface +* +*/ + + +/** + @file + @publishedPartner + @released +*/ + +#ifndef __CRYPTOAPI_RANDOMPLUGIN_H__ +#define __CRYPTOAPI_RANDOMPLUGIN_H__ + +#include + +namespace CryptoSpi + { + /** + A cryptographically secure pseudo-random number generator (CSPRNG) + Generates random numbers derived from entropy obtained from another + source, usually a hardware random number generator or if unavailable, + from a combination variety of unpredictable system variables, added + to an entropy pool which is used for seeding. This might include + keypresses generated by a user, hardware interrupts, etc. + */ + class MRandom : public MPlugin + { + public: + /** + Generate enough random bytes to fill the supplied descriptor + If there is not enough entropy available, or another error + occurs (e.g. out of memory) then this method may leave. + @param aDest The returned generated random bytes + */ + virtual void GenerateRandomBytesL(TDes8& aDest) = 0; + }; + + + class MAsyncRandom : public MPlugin + { + public: + /** + Generate enough random bytes to fill the supplied descriptor + If there is not enough entropy available, or another error + occurs (e.g. out of memory) then this method may leave. + @param aDest The returned generated random bytes + */ + virtual void GenerateRandomBytesL(TDes8& aDest, TRequestStatus& aStatus) = 0; + + /** + Cancel an outstanding request + */ + virtual void Cancel() = 0; + }; + + } + +#endif // __CRYPTOAPI_RANDOMPLUGIN_H__