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 UDPv4SocketHandle and UDPv6SocketHandle public header
26 \todo Implement possibly non-blocking connect and SO_ERROR in the
30 #ifndef HH_UDPSocketHandle_
31 #define HH_UDPSocketHandle_ 1
34 #include "INetProtocol.hh"
35 #include "UDPProtocol.hh"
36 #include "Socket/Protocols/BSDSocketProtocol.hh"
37 #include "Socket/FramingPolicy.hh"
38 #include "Socket/CommunicationPolicy.hh"
39 #include "Socket/ReadWritePolicy.hh"
40 #include "Socket/BufferingPolicy.hh"
41 #include "Socket/ProtocolClientSocketHandle.hh"
43 //#include "UDPSocketHandle.mpp"
44 ///////////////////////////////hh.p////////////////////////////////////////
48 /// \addtogroup concrete_protocol_group
51 typedef MakeSocketPolicy<
52 INet4AddressingPolicy,
53 DatagramFramingPolicy,
54 UnconnectedCommunicationPolicy,
58 >::policy UDPv4Socket_Policy; ///< Socket Policy of the UDPv4 Protocol
60 /** \brief IPv4 UDP Socket Protocol
62 \par Socket Handle typedefs:
63 \ref UDPv4ClientSocketHandle (ProtocolClientSocketHandle)
65 \par Policy Interface:
66 ClientSocketHandle::read(), ClientSocketHandle::write(), ClientSocketHandle::bind(),
67 ClientSocketHandle::local(), ClientSocketHandle::connect(), ClientSocketHandle::peer(),
68 ClientSocketHandle::rcvbuf(), ClientSocketHandle::sndbuf()
73 UDPv4SocketProtocol provides an internet protocol stream socket based on the UDP protocol
76 This class is utilized as the protocol class of the ProtocolClientSocketHandle
77 via the Socket Handle typedefs above.
79 \see UDPv6SocketProtocol
81 class UDPv4SocketProtocol
82 : public ConcreteSocketProtocol<UDPv4Socket_Policy>,
85 public BSDSocketProtocol,
86 public AddressableBSDSocketProtocol,
87 public senf::pool_alloc_mixin<UDPv4SocketProtocol>
90 ///////////////////////////////////////////////////////////////////////////
96 void init_client() const; ///< Create unconnected client socket
97 /**< \note This member is implicitly called from the
98 ProtocolClientSocketHandle::ProtocolClientSocketHandle()
100 void init_client(INet4SocketAddress const & address) const;
101 ///< Create client socket and connect
102 /**< Creates a new client socket and connects to the given
105 \param[in] address remote address to connect to */
106 /**< \note This member is implicitly called from the
107 ProtocolClientSocketHandle::ProtocolClientSocketHandle()
111 ///\name Abstract Interface Implementation
113 std::auto_ptr<SocketProtocol> clone() const;
118 typedef ProtocolClientSocketHandle<UDPv4SocketProtocol> UDPv4ClientSocketHandle;
120 typedef MakeSocketPolicy<
122 INet6AddressingPolicy
123 >::policy UDPv6Socket_Policy;
125 /** \brief IPv6 UDP Socket Protocol
127 \par Socket Handle typedefs:
128 \ref UDPv6ClientSocketHandle (ProtocolClientSocketHandle)
130 \par Policy Interface:
131 ClientSocketHandle::read(), ClientSocketHandle::write(), ClientSocketHandle::bind(),
132 ClientSocketHandle::local(), ClientSocketHandle::connect(), ClientSocketHandle::peer(),
133 ClientSocketHandle::rcvbuf(), ClientSocketHandle::sndbuf()
138 UDPv6SocketProtocol provides an internet protocol stream socket based on the UDP protocol
141 This class is utilized as the protocol class of the ProtocolClientSocketHandle
142 via the Socket Handle typedefs above.
144 \see UDPv4SocketProtocol
146 class UDPv6SocketProtocol
147 : public ConcreteSocketProtocol<UDPv6Socket_Policy>,
150 public BSDSocketProtocol,
151 public AddressableBSDSocketProtocol,
152 public senf::pool_alloc_mixin<UDPv6SocketProtocol>
155 ///////////////////////////////////////////////////////////////////////////
156 // internal interface
158 ///\name Constructors
161 void init_client() const; ///< Create unconnected client socket
162 /**< \note This member is implicitly called from the
163 ProtocolClientSocketHandle::ProtocolClientSocketHandle()
165 void init_client(INet6SocketAddress const & address) const;
166 ///< Create client socket and connect
167 /**< Creates a new client socket and connects to the given
170 \param[in] address remote address to connect to */
171 /**< \note This member is implicitly called from the
172 ProtocolClientSocketHandle::ProtocolClientSocketHandle()
176 ///\name Abstract Interface Implementation
178 std::auto_ptr<SocketProtocol> clone() const;
183 typedef ProtocolClientSocketHandle<UDPv6SocketProtocol> UDPv6ClientSocketHandle;
189 ///////////////////////////////hh.e////////////////////////////////////////
190 //#include "UDPSocketHandle.cci"
191 //#include "UDPSocketHandle.ct"
192 //#include "UDPSocketHandle.cti"
199 // c-file-style: "senf"
200 // indent-tabs-mode: nil
201 // ispell-local-dictionary: "american"
202 // compile-command: "scons -u test"
203 // comment-column: 40