--- a/epoc32/include/securesocket.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/securesocket.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,197 @@
-securesocket.h
+// Copyright (c) 2001-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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// Secure Sockets
+//
+//
+
+
+
+/**
+ @file
+*/
+
+#ifndef __SECURESOCKET_H__
+#define __SECURESOCKET_H__
+
+#include <e32base.h>
+#include <e32cons.h>
+#include <c32comm.h>
+#include <es_sock.h>
+#include <ssl.h>
+
+#include <sslerr.h>
+#include <x509cert.h>
+
+#include <securesocketinterface.h>
+//Secure Socket specific panic
+_LIT(KSecureSocketPanic,"SecureSocket Panic");
+
+/**
+ * Maximum length of the protocol name.
+ *
+ * @internalComponent
+ */
+const TInt KMaxProtocolName = 32;
+
+class TSecSocketProtocol
+/**
+ * The secure socket protocol class.
+ *
+ * @internalComponent
+ *
+ * @since v7.0
+ */
+ {
+public:
+ /** Protocol name. */
+ TBuf<KMaxProtocolName> iName;
+ /** Handle to the DLL. */
+ RLibrary iLibrary;
+ static inline TInt Offset()
+ /**
+ * Gets the offset to the iSlink member.
+ *
+ * @return The offset to the iSlink member. */
+ {return _FOFF(TSecSocketProtocol,iSlink);}
+ // Moved the implementation to the cpp file
+ virtual ~TSecSocketProtocol();
+private:
+ TSglQueLink iSlink;
+ };
+
+
+class TSecureSocketGlobals
+/**
+ * Class to store the Secure Sockets Globals.
+ *
+ * @internalComponent
+ *
+ * @since v7.0
+ */
+ {
+public:
+ inline TSecureSocketGlobals():
+ iSecureSocketProtocols(TSecSocketProtocol::Offset()),
+ /** Constructor. */
+ iSecureSocketProtocolsIter(iSecureSocketProtocols),
+ iUseCount(0){};
+ /** List of supported protocols. */
+ TSglQue<TSecSocketProtocol> iSecureSocketProtocols;
+ /** A templated class that provides for iterating through the list of supported
+ * protocols. */
+ TSglQueIter<TSecSocketProtocol> iSecureSocketProtocolsIter;
+ /** Use counter. */
+ TInt iUseCount;
+ };
+
+class MGenericSecureSocket;
+
+/**
+ * Definition for the entry point function exported by Secure Socket modules.
+ *
+ * @internalComponent
+ */
+typedef TInt (*TSecSockDllLibraryFunction)( RSocket& aSocket, const TDesC& aProtocol );
+typedef TInt (*TSecSockDllLibraryGenericFunction)(MGenericSecureSocket& aSocket, const TDesC& aProtocol);
+
+/**
+ * Definition for the entry point for the cleanup function exported by secureSocket modules
+ *
+ * @internalComponent
+ */
+typedef void (*TSecSockDllUnloadFunction)( TAny* );
+
+class CSecureSocketLibraryLoader : public CBase
+/**
+ * Factory class for creating secure sockets.
+ *
+ * @internalAll
+ *
+ * @since v6.2 */
+ // Create and reference Secure Sockets
+ {
+public:
+ static TInt OpenL(const TDesC& aProtocolName,TSecSockDllLibraryFunction& anEntryPoint);
+ static TInt OpenL(const TDesC& aProtocolName, TSecSockDllLibraryGenericFunction& aEntryPoint);
+ static void FindItemInDbL(const TDesC& aProtocolName, TDes& aLibraryName);
+ IMPORT_C static void Unload();
+
+private:
+ static void OpenWithIdL(TInt aId, const TDesC& aProtocolName, TLibraryFunction& aEntryPoint);
+ };
+
+
+class CSecureSocket : public CBase
+/**
+ * Secure sockets class.
+ *
+ * @publishedAll
+ * @released
+ *
+ * @since v6.2 */
+ // New secure sockets can be created through the static CSecureSocket::NewL method.
+ // @public
+ {
+public:
+ IMPORT_C static CSecureSocket* NewL(RSocket& aSocket,const TDesC& aProtocol);
+ IMPORT_C static CSecureSocket* NewL(MGenericSecureSocket& aSocket,const TDesC& aProtocol);
+
+ /** Standard destructor. */
+ ~CSecureSocket();
+
+ // export CSecureSocket methods
+ IMPORT_C TInt AvailableCipherSuites( TDes8& aCiphers );
+ IMPORT_C void CancelAll();
+ IMPORT_C void CancelHandshake();
+ IMPORT_C void CancelRecv();
+ IMPORT_C void CancelSend();
+ IMPORT_C const CX509Certificate* ClientCert();
+ IMPORT_C TClientCertMode ClientCertMode();
+ IMPORT_C TDialogMode DialogMode();
+ IMPORT_C void Close();
+ IMPORT_C TInt CurrentCipherSuite( TDes8& aCipherSuite );
+ IMPORT_C void FlushSessionCache();
+ IMPORT_C TInt GetOpt(TUint aOptionName, TUint aOptionLevel, TDes8& aOption);
+ IMPORT_C TInt GetOpt(TUint aOptionName, TUint aOptionLevel, TInt& aOption);
+ IMPORT_C TInt Protocol(TDes& aProtocol);
+ IMPORT_C void Recv (TDes8& aDesc, TRequestStatus& aStatus );
+ IMPORT_C void RecvOneOrMore( TDes8& aDesc, TRequestStatus& aStatus, TSockXfrLength& aLen );
+ IMPORT_C void RenegotiateHandshake(TRequestStatus& aStatus );
+ IMPORT_C void Send( const TDesC8& aDesc, TRequestStatus& aStatus, TSockXfrLength& aLen );
+ IMPORT_C void Send( const TDesC8& aDesc, TRequestStatus& aStatus );
+ IMPORT_C const CX509Certificate* ServerCert();
+ IMPORT_C TInt SetAvailableCipherSuites(const TDesC8& aCiphers);
+ IMPORT_C TInt SetClientCert(const CX509Certificate& aCert);
+ IMPORT_C TInt SetClientCertMode(const TClientCertMode aClientCertMode);
+ IMPORT_C TInt SetDialogMode(const TDialogMode aDialogMode);
+ IMPORT_C TInt SetProtocol(const TDesC& aProtocol);
+ IMPORT_C TInt SetOpt(TUint aOptionName, TUint aOptionLevel, const TDesC8& aOption=TPtrC8(NULL,0));
+ IMPORT_C TInt SetOpt(TUint aOptionName, TUint aOptionLevel, TInt aOption);
+ IMPORT_C TInt SetServerCert(const CX509Certificate& aCert);
+ IMPORT_C void StartClientHandshake(TRequestStatus& aStatus);
+ IMPORT_C void StartServerHandshake(TRequestStatus& aStatus);
+
+private:
+ void ConstructL(RSocket& aSocket,const TDesC& aProtocol);
+ void ConstructL(MGenericSecureSocket& aSocket,const TDesC& aProtocol);
+
+ enum {ESecureSocketStateOpen, ESecureSocketStateClosed};
+
+ TUint iSecureSocketState;
+
+ TSecSockDllLibraryFunction iUNUSED;
+ MSecureSocket* iSecureImplementation;
+ };
+
+#endif // __SECURESOCKET_H__