--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/comms-infras/es_sap.h	Wed Mar 31 12:33:34 2010 +0100
@@ -0,0 +1,131 @@
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "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:
+//
+
+/**
+ @file
+ @internalTechnology
+ @released
+*/
+
+#if !defined(__ES_SAP_H__)
+#define __ES_SAP_H__
+
+#define SYMBIAN_NETWORKING_UPS
+
+#include <es_prot.h>
+#include <es_sock.h>
+#include <comms-infras/ss_subconnflow.h>
+#include <comms-infras/ss_flowbinders.h>
+#include <comms-infras/ss_nodemessages_dataclient.h>
+
+namespace ESock
+{
+
+class CNetworkFlow : public CSubConnectionFlowBase, protected MSessionData, protected MSessionControl,
+                        protected MFlowBinderControl
+/** Service Access Point for SAPs that have a seperate control side.
+
+Provides transport services to a single protocol. Several of the calls to
+CServProviderBase have pre-conditions attached to them - for example
+a connection oriented protocol must have its local address set (either by
+a SetLocalName() or AutoBind()) before it is opened. If the socket server
+calls the CServProviderBase in such an erroneous way, the protocol should panic.
+
+It also provides an interface towards subconnection providers to allow
+SAPs to work with a seperate control path.
+
+@internalTechnology
+@released Since 9.0 */
+	{
+	friend class ProtocolManager;
+
+public:
+
+	IMPORT_C virtual ~CNetworkFlow();
+
+protected:
+	void SetLocalName(TSockAddr& anAddr);
+	TInt SetRemName(TSockAddr& anAddr);
+	TUint Write(const TDesC8& aDesc,TUint aOptions, TSockAddr* anAddr);
+	TInt Write(RMBufChain& aData, TUint aOptions, TSockAddr* anAddr);
+    void BindToL(const TCFDataClient::TBindTo& aBindTo);
+    NetInterfaces::TInterfaceControl* FetchInterfaceControlL(TSupportedCommsApiExt aInterfaceId);
+
+protected:
+
+	virtual MFlowBinderControl* DoGetBinderControlL();
+	//MFlowBinderControl
+	virtual MSessionControl* GetControlL(TInt aSessionType,MSessionControlNotify& aSessionControlNotify);
+	virtual void Unbind();
+	virtual MSessionData* BindL(MSessionDataNotify& aNotify);
+	virtual CSubConnectionFlowBase* Flow(); //returns its own flow
+
+    TBool IsBoundToSession() const
+        {
+        return  iSessionControlNotify || iSessionDataNotify;
+        }
+
+	void ProcessDCIdleState();
+
+	
+protected:
+	IMPORT_C CNetworkFlow(CSubConnectionFlowFactoryBase& aFactory, const Messages::TNodeId& aSubConn, CProtocolIntfBase* aProtocolIntf);
+	void UpdateDestinationAddress(const TSockAddr& aDest);
+
+    #define SAP_FLAG_FUNCTIONS(name, flag) \
+		inline TBool name() { return iStateFlags & flag; } \
+		inline void Set##name() { iStateFlags |= flag; }	\
+		inline void Clear##name() { iStateFlags &= ~flag; }
+
+#ifdef SYMBIAN_NETWORKING_UPS
+	virtual TBool ActivityRunning() = 0;
+#endif
+
+
+protected:
+	TSockAddr iLocalAddress;
+	TSockAddr iRemoteAddress;
+
+	//upper flow
+	MSessionControlNotify* iSessionControlNotify;
+	MSessionDataNotify* iSessionDataNotify;
+	//lower flow
+	MFlowBinderControl* iLowerFlow;
+	MLowerControl* iLowerControl; //just to keep the lower flow up
+
+	enum TStateFlag
+		{
+		ELocalAddressSet = 0x00000001,
+		ERemoteAddressSet = 0x00000002,
+		ENoBearerRunning = 0x00000004,
+		EStarted = 0x00000008,
+		EIdle = 0x00000080,
+		EIdleSent = 0x00000100
+		};
+	SAP_FLAG_FUNCTIONS(LocalAddressSet, ELocalAddressSet)
+	SAP_FLAG_FUNCTIONS(RemoteAddressSet, ERemoteAddressSet)
+	SAP_FLAG_FUNCTIONS(NoBearerGuard, ENoBearerRunning)
+	SAP_FLAG_FUNCTIONS(Started, EStarted)
+	SAP_FLAG_FUNCTIONS(Idle, EIdle)
+	SAP_FLAG_FUNCTIONS(IdleSent, EIdleSent)
+		
+	TUint iStateFlags;
+	};
+
+} //namespace ESock
+
+#endif	// __ES_SAP_H__
+
+