PPI/Setup.hh

   1 // $Id$
   2 //
   3 // Copyright (C) 2007
   4 // Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
   5 // Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
   6 //     Stefan Bund <g0dil@berlios.de>
   7 //
   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.
  12 //
  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.
  17 //
  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.
  22
  23 /** \file
  24     \brief Setup public header */
  25
  26 #ifndef HH_Setup_
  27 #define HH_Setup_ 1
  28
  29 // Custom includes
  30 #include <boost/type_traits.hpp>
  31 #include <boost/utility/enable_if.hpp>
  32 #include "predecl.hh"
  33
  34 //#include "Setup.mpp"
  35 ///////////////////////////////hh.p////////////////////////////////////////
  36
  37 namespace senf {
  38 namespace ppi {
  39
  40 #ifndef DOXYGEN
  41
  42     void connect(connector::ActiveOutput & source, connector::PassiveInput & target);
  43     void connect(connector::PassiveOutput & source, connector::ActiveInput & target);
  44
  45     template <class T, class C>
  46     void connect(T & source, C & target,
  47                  typename boost::disable_if< boost::is_base_of<connector::Connector, T> >::type * = 0,
  48                  typename boost::enable_if< boost::is_base_of<connector::Connector, C> >::type * = 0);
  49
  50     template <class C, class T>
  51     void connect(C & source, T & target,
  52                  typename boost::enable_if< boost::is_base_of<connector::Connector, C> >::type * = 0,
  53                  typename boost::disable_if< boost::is_base_of<connector::Connector,T> >::type * = 0);
  54
  55     template <class T1, class T2>
  56     void connect(T1 & source, T2 & target,
  57                  typename boost::disable_if< boost::is_base_of<connector::Connector, T1> >::type * = 0,
  58                  typename boost::disable_if< boost::is_base_of<connector::Connector, T2> >::type * = 0);
  59
  60 #else
  61
  62     /** \brief Connect modules
  63
  64         senf::ppi::connect() establishes a connection between two modules or, to be more precise,
  65         between two connectors. It will connect any input to any output connector as long as one is
  66         active and the other passive.
  67
  68         If a module has an output connector called \c output, the module may be directly specified
  69         as \a source argument. In the same way, if a module has an input connector called \c input,
  70         the module may be given directly as \a target argument. This simplifies the most common case
  71         of a module with one input and one output connector.
  72
  73         \see \ref ppi_connections
  74      */
  75     void connect(connector::ActiveInput & source, connector::PassiveOutput & target);
  76
  77     /** \brief Connect modules
  78         \see connect() */
  79     void connect(connector::PassiveInput & source, connector::ActiveOutput & target);
  80
  81 #endif
  82
  83     /** \brief Start the network
  84
  85         Calling senf::ppi::run() will start processing the network. The main event loop is managed
  86         by the Scheduler. Before starting the Scheduler main loop, all Module init() members are
  87         called.
  88
  89         senf::ppi::run() will return when no more work is to be done, that is when no events are
  90         enabled (Since the events are enabled and disabled by the throttle notifications which
  91         depend among other things on the packet queues, this is the same as checking for packets in
  92         any queue). It is Ok to call senf::ppi::run() multiple times during the program lifetime.
  93
  94         \see \ref ppi_run
  95      */
  96     void run();
  97
  98     /** \brief Manually initialize the network
  99
 100         For debugging purposes, it is sometimes simpler to not use senf::ppi::run() but instead
 101         drive the network via explicit calls using the debug modules. However, it is still necessary
 102         to initialize the network. This operation is performed by senf::ppi::init().
 103      */
 104     void init();
 105
 106 }}
 107
 108 ///////////////////////////////hh.e////////////////////////////////////////
 109 #include "Setup.cci"
 110 //#include "Setup.ct"
 111 #include "Setup.cti"
 112 #endif
 113
 114 \f
 115 // Local Variables:
 116 // mode: c++
 117 // fill-column: 100
 118 // comment-column: 40
 119 // c-file-style: "senf"
 120 // indent-tabs-mode: nil
 121 // ispell-local-dictionary: "american"
 122 // compile-command: "scons -u test"
 123 // End: