-// Copyright (C) 2007
-// Fraunhofer Institute for Open Communication Systems (FOKUS)
-// Competence Center NETwork research (NET), St. Augustin, GERMANY
+// $Id$
+//
+// Copyright (C) 2007
+// Fraunhofer Institute for Open Communication Systems (FOKUS)
+// Competence Center NETwork research (NET), St. Augustin, GERMANY
// Stefan Bund <g0dil@berlios.de>
//
// This program is free software; you can redistribute it and/or modify
/** \file
\brief SocketSink public header */
-#ifndef HH_SocketSink_
-#define HH_SocketSink_ 1
+#ifndef HH_SENF_PPI_SocketSink_
+#define HH_SENF_PPI_SocketSink_ 1
// Custom includes
#include "../Packets/Packets.hh"
#include "../Socket/CommunicationPolicy.hh"
#include "Module.hh"
#include "Connectors.hh"
+#include "../Socket/Protocols/INet/INetAddressing.hh"
+#include "IOEvent.hh"
//#include "SocketSink.mpp"
///////////////////////////////hh.p////////////////////////////////////////
namespace senf {
namespace ppi {
- /** \brief Write helper for module::ActiveSocketSink / module::PassiveSocketSink
-
- This write helper will write the packets completely as datagrams to the given socket.
+ /** \brief Writer for module::ActiveSocketSink / module::PassiveSocketSink
+
+ This writer will write the packets completely as datagrams to the given socket which must be connected.
*/
- class PacketSink
+ class ConnectedDgramWriter
{
public:
typedef senf::ClientSocketHandle<
senf::DatagramFramingPolicy,
senf::ConnectedCommunicationPolicy>::policy > Handle;
///< Handle type supported by this writer
-
+
void operator()(Handle handle, Packet packet);
///< Write \a packet to \a handle
/**< Write the complete \a packet as a datagram to \a
\param[in] packet Packet to write */
};
+ class IPv4SourceForcingDgramWriter : ConnectedDgramWriter
+ {
+ public:
+ IPv4SourceForcingDgramWriter();
+ IPv4SourceForcingDgramWriter(senf::INet4Address sourceAddr, senf::INet4SocketAddress destAddr);
+ typedef senf::ClientSocketHandle<
+ senf::MakeSocketPolicy< senf::WriteablePolicy,
+ senf::DatagramFramingPolicy>::policy > Handle;
+ ///< Handle type supported by this writer
+
+ void source(senf::INet4Address & source);
+ senf::INet4Address source();
+ void destination(senf::INet4SocketAddress & dest);
+ senf::INet4SocketAddress destination();
+
+ void operator()(Handle handle, Packet packet);
+ ///< Write \a packet to \a handle
+ /**< Write the complete \a packet as a datagram to \a
+ handle.
+ \param[in] handle Handle to write data to
+ \param[in] packet Packet to write */
+ private:
+ int sendtoandfrom(int sock, const void *data, size_t dataLen, const in_addr *dst, int port, const in_addr *src);
+ senf::INet4Address source_;
+ senf::INet4Address destination_;
+ unsigned int protocolId_;
+ };
+
+ class IPv6SourceForcingDgramWriter : ConnectedDgramWriter
+ {
+ public:
+ IPv6SourceForcingDgramWriter();
+ IPv6SourceForcingDgramWriter(senf::INet6Address sourceAddr, senf::INet6SocketAddress destAddr);
+ typedef senf::ClientSocketHandle<
+ senf::MakeSocketPolicy< senf::WriteablePolicy,
+ senf::DatagramFramingPolicy>::policy > Handle;
+ ///< Handle type supported by this writer
+
+ void source(senf::INet6Address & source);
+ senf::INet6Address source();
+ void destination(senf::INet6SocketAddress & dest);
+ senf::INet6SocketAddress destination();
+
+ void operator()(Handle handle, Packet packet);
+ ///< Write \a packet to \a handle
+ /**< Write the complete \a packet as a datagram to \a
+ handle.
+ \param[in] handle Handle to write data to
+ \param[in] packet Packet to write */
+ private:
+ int sendtoandfrom(int sock, const void *data, size_t dataLen, const in6_addr *dst, int port, const in6_addr *src);
+ senf::INet6Address source_;
+ senf::INet6Address destination_;
+ unsigned int protocolId_;
+};
+
+
}}
namespace senf {
namespace ppi {
namespace module {
- /** \brief Output module writing data to arbitrary FileHandle
-
- This output module will write data to a FileHandle object using a given \a Sink. This
- output module is active. This requires the file handle to be able to signal its readiness to
+ /** \brief Output %module writing data to a FileHandle using the provided Writer.
+ If using the default ConnectedDgramWriter the filehandle must be writable, connected and
+ able to handle complete datagrams.
+
+ This output %module will write data to a FileHandle object using a given \a Writer. This
+ output %module is active. This requires the file handle to be able to signal its readiness to
accept more data via the Scheduler.
- The default \a Sink is senf::ppi::PacketSink which will write out the complete packet to
+ The default \a Writer is senf::ppi::ConnectedDgramWriter which will write out the complete packet to
the file handle.
- A \a Sink must fulfill the following interface:
+ A \a Writer must fulfill the following interface:
\code
- class SomeSink
+ class SomeWriter
{
public:
typedef unspecified Handle; // type of handle requested
- SomeSink(); // EITHER default constructible OR
- SomeSink(SomeSink const & other); // copy constructible
+ SomeWriter(); // EITHER default constructible OR
+ SomeWriter(SomeWriter const & other); // copy constructible
void operator()(Handle handle, Packet packet); // insertion function
};
\endcode
- Whenever a packet is received for sending, the \a Sink's \c operator() is called.
+ Whenever a packet is received for sending, the \a Writer's \c operator() is called.
\ingroup io_modules
*/
- template <class Sink=PacketSink>
+ template <class Writer=ConnectedDgramWriter>
class ActiveSocketSink : public Module
{
SENF_PPI_MODULE(ActiveSocketSink);
public:
- typedef typename Sink::Handle Handle; ///< Handle type requested by writer
+ typedef typename Writer::Handle Handle; ///< Handle type requested by writer
+
+ connector::ActiveInput<> input; ///< Input connector from which data is received
- connector::ActiveInput input; ///< Input connector from which data is received
-
ActiveSocketSink(Handle handle); ///< Create new writer for the given handle
- /**< Data will be written to \a handle using \a Sink.
- \pre Requires \a Sink to be default constructible
+ /**< Data will be written to \a handle using \a Writer.
+ \pre Requires \a Writer to be default constructible
\param[in] handle Handle to write data to */
- ActiveSocketSink(Handle handle, Sink const & sink);
+ ActiveSocketSink(Handle handle, Writer const & writer);
///< Create new writer for the given handle
- /**< Data will be written to \a handle using \a Sink.
- \pre Requires \a Sink to be copy constructible
- \param[in] handle Handle to write data to
- \param[in] sink Sink helper writing packet date to the
+ /**< Data will be written to \a handle using \a Writer.
+ \pre Requires \a Writer to be copy constructible
+ \param[in] handle Handle to write data to
+ \param[in] writer Writer helper writing packet date to the
socket */
- Sink & sink(); ///< Access the sink helper
-
+ Writer & writer(); ///< Access the Writer
private:
void write();
Handle handle_;
IOEvent event_;
- Sink writer_;
+ Writer writer_;
};
- /** \brief Output module writing data to arbitrary FileHandle
-
- This output module will write data to a FileHandle object using a given \a Sink. This
+ /** \brief Output module writing data to a FileHandle using the provided \a Writer.
+ If using the default ConnectedDgramWriter the filehandle must be writable, connected and
+ able to handle complete datagrams.
+
+ This output module will write data to a FileHandle object using a given \a Writer. This
output module is passive. This implies, that the output handle may not block. This also
implies, that data will probably get lost if written to fast for the underlying transport
mechanism. Either this is desired (like for a UDP socket) or some additional bandwidth
shaping needs to be used.
- The default \a Sink is senf::ppi::PacketSink which will write out the complete packet to
+ The default \a Writer is senf::ppi::ConnectedDgramWriter which will write out the complete packet to
the file handle.
- The \a Sink must fulfill the following interface:
+ The \a Writer must fulfill the following interface:
\code
- class SomeSink
+ class SomeWriter
{
public:
typedef unspecified Handle; // type of handle requested
- SomeSink(); // EITHER default constructible
- SomeSink(SomeSink const & other); // OR copy constructible
+ SomeWriter(); // EITHER default constructible
+ SomeWriter(SomeWriter const & other); // OR copy constructible
void operator()(Handle handle, Packet packet); // insertion function
};
\endcode
- Whenever a packet is received for sending, the \a Sink's \c operator() is called.
+ Whenever a packet is received for sending, the \a Writer's \c operator() is called.
\ingroup io_modules
*/
- template <class Sink=PacketSink>
+ template <class Writer=ConnectedDgramWriter>
class PassiveSocketSink : public Module
{
SENF_PPI_MODULE(PassiveSocketSink);
public:
- typedef typename Sink::Handle Handle; ///< Handle type requested by writer
+ typedef typename Writer::Handle Handle; ///< Handle type requested by writer
+
+ connector::PassiveInput<> input; ///< Input connector from which data is received
- connector::PassiveInput input; ///< Input connector from which data is received
-
PassiveSocketSink(Handle handle); ///< Create new writer for the given handle
- /**< Data will be written to \a handle using \a Sink.
- \pre Requires \a Sink to be default constructible
+ /**< Data will be written to \a handle using \a Writer.
+ \pre Requires \a Writer to be default constructible
\param[in] handle Handle to write data to */
- PassiveSocketSink(Handle handle, Sink const & sink);
+ PassiveSocketSink(Handle handle, Writer const & writer);
///< Create new writer for the given handle
- /**< Data will be written to \a handle using \a Sink.
- \pre Requires \a Sink to be copy constructible
+ /**< Data will be written to \a handle using \a Writer.
+ \pre Requires \a Writer to be copy constructible
\param[in] handle Handle to write data to */
- Sink & sink(); ///< Access the sink helper
+ Writer & writer(); ///< Access the Writer
+ Handle & handle(); /**< Access the handle. This is intendet to be mainly used to reconnect
+ the underlying socket. */
+ /* void reconnect(senf::SocketAddress newAddress);
+ ///< Reconnect the handle to which the packets are written
+ */
+ void replaceHandle(Handle newHandle);
+ /**< Replace the handle to which the packets are written
+ * Normally you should access the handle and call connect with
+ * the new address. This also works for other
+ * (active) ConnectedSocketSinks/Sources */
private:
void write();
Handle handle_;
- Sink writer_;
+ Writer writer_;
};
}}}
#include "SocketSink.cti"
#endif
-\f
+
// Local Variables:
// mode: c++
// fill-column: 100
projects / senf.git / blobdiff