4 // Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
5 // Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
6 // Stefan Bund <stefan.bund@fokus.fraunhofer.de>
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 2 of the License, or
11 // (at your option) any later version.
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the
20 // Free Software Foundation, Inc.,
21 // 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 \brief ProtocolServerSocketHandle public header
27 #ifndef HH_ProtocolServerSocketHandle_
28 #define HH_ProtocolServerSocketHandle_ 1
31 #include "ServerSocketHandle.hh"
33 #include "ProtocolServerSocketHandle.mpp"
34 ///////////////////////////////hh.p////////////////////////////////////////
38 /// \addtogroup handle_group
41 template <class Protocol> class ProtocolClientSocketHandle;
43 /** \brief Protocol specific socket handle (server interface)
45 The ProtocolServerSocketHandle is the server interface leaf class of the handle
46 hierarchy. This is the class to instantiate to open a new socket. This is also the \e only
47 class, which can be used to open a server socket.
49 The \a Protocol template argument defines the protocol of the socket. This protocol provides
50 the protocol interface of the socket as well as the complete socket policy of this protocol.
52 The ProtocolServerSocketHandle adds the protocol interface as an additional interface to the
53 socket handle. This interface is only accessible via the protocol class. All socket
54 functionality not available through the policy interface (see ServerSocketHandle) is
55 accessible via the protocol() member.
57 A ProtocolServerSocketHandle is only meaningful for connection oriented addressable
58 protocols (CommunicationPolicy is ConnectedCommunicationPolicy and AddressingPolicy is not
61 \see \ref protocol_group
63 template <class SocketProtocol>
64 class ProtocolServerSocketHandle
65 : public ServerSocketHandle<typename SocketProtocol::Policy>
68 ///////////////////////////////////////////////////////////////////////////
71 typedef SocketProtocol Protocol; ///< The socket protocol
73 ///////////////////////////////////////////////////////////////////////////
74 ///\name Structors and default members
77 /** \brief Create new server socket
79 This constructor is one of the possible constructors. The exact Signature of the
80 constructor (or constructors) is defined by the \c init_server() member (or members) of
81 the \a Protocol class. ProtocolClientSocketHandle defines a number of constructors
82 taking up to 9 arguments which just forward to a corresponding \a Protocol\c
83 ::init_server() member. See the documentation of the respective Protocol class for a
84 detailed documentation of that protocols constructors.
87 ProtocolServerSocketHandle();
89 # define BOOST_PP_ITERATION_PARAMS_1 (4, (1, 9, "Socket/ProtocolServerSocketHandle.mpp", 1))
90 # include BOOST_PP_ITERATE()
93 ///////////////////////////////////////////////////////////////////////////
95 Protocol const & protocol(); ///< Access the protocol interface
96 /**< The returned protocol class reference gives access to
97 the complete protocol interface as defined by that
98 class. See the respective protocol class documentation.
99 \returns \a Protocol class reference */
101 ProtocolClientSocketHandle<SocketProtocol> accept();
103 static ProtocolServerSocketHandle cast_static(FileHandle handle);
104 static ProtocolServerSocketHandle cast_dynamic(FileHandle handle);
106 void state(SocketStateMap & map, unsigned lod=0);
107 std::string dumpState(unsigned lod=0);
110 ProtocolServerSocketHandle(FileHandle other, bool isChecked);
119 ///////////////////////////////hh.e////////////////////////////////////////
120 //#include "ProtocolServerSocketHandle.cci"
121 //#include "ProtocolServerSocketHandle.ct"
122 #include "ProtocolServerSocketHandle.cti"
129 // c-file-style: "senf"
130 // indent-tabs-mode: nil
131 // ispell-local-dictionary: "american"