switch to new MPL based Fraunhofer FOKUS Public License
[senf.git] / senf / Socket / CommunicationPolicy.hh
index 47dc01f..3589657 100644 (file)
@@ -2,23 +2,28 @@
 //
 // Copyright (C) 2006
 // 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
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation; either version 2 of the License, or
-// (at your option) any later version.
+// The contents of this file are subject to the Fraunhofer FOKUS Public License
+// Version 1.0 (the "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at 
+// http://senf.berlios.de/license.html
 //
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-// GNU General Public License for more details.
+// The Fraunhofer FOKUS Public License Version 1.0 is based on, 
+// but modifies the Mozilla Public License Version 1.1.
+// See the full license text for the amendments.
 //
-// You should have received a copy of the GNU General Public License
-// along with this program; if not, write to the
-// Free Software Foundation, Inc.,
-// 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+// Software distributed under the License is distributed on an "AS IS" basis, 
+// WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License 
+// for the specific language governing rights and limitations under the License.
+//
+// The Original Code is Fraunhofer FOKUS code.
+//
+// The Initial Developer of the Original Code is Fraunhofer-Gesellschaft e.V. 
+// (registered association), Hansastraße 27 c, 80686 Munich, Germany.
+// All Rights Reserved.
+//
+// Contributor(s):
+//   Stefan Bund <g0dil@berlios.de>
 
 /** \file
     \brief CommunicationPolicy public header
 #include "FileHandle.hh"
 
 //#include "CommunicationPolicy.mpp"
-///////////////////////////////hh.p////////////////////////////////////////
+//-/////////////////////////////////////////////////////////////////////////////////////////////////
 
 struct sockaddr;
 
 namespace senf {
 
     /// \addtogroup policy_impl_group
-    /// @{
+    //\{
 
     template <class SPolicy> class ServerSocketHandle;
 
@@ -53,11 +58,11 @@ namespace senf {
     {
 #       ifndef DOXYGEN
         template <class SPolicy>
-        static void listen(ServerSocketHandle<SPolicy> handle, unsigned backlog,
+        static void listen(ServerSocketHandle<SPolicy> const & handle, unsigned backlog,
                            typename IfAddressingPolicyIsNot<SPolicy,NoAddressingPolicy>::type * = 0);
 #       else
         template <class SPolicy>
-        static void listen(ServerSocketHandle<SPolicy> handle, unsigned backlog);
+        static void listen(ServerSocketHandle<SPolicy> const & handle, unsigned backlog);
                                         ///< Enable establishing new connections on the socket
                                         /**< \param[in] handle socket handle to enable reception on
                                              \param[in] backlog size of backlog queue */
@@ -65,12 +70,12 @@ namespace senf {
 
 #       ifndef DOXYGEN
         template <class SPolicy>
-        static int accept(ServerSocketHandle<SPolicy> handle,
+        static int accept(ServerSocketHandle<SPolicy> const & handle,
                           typename ServerSocketHandle<SPolicy>::Address & address,
                           typename IfAddressingPolicyIsNot<SPolicy,NoAddressingPolicy>::type * = 0);
 #       else
         template <class SPolicy>
-        static int accept(ServerSocketHandle<SPolicy> handle,
+        static int accept(ServerSocketHandle<SPolicy> const & handle,
                           typename ServerSocketHandle<SPolicy>::Address & address);
                                         ///< accept a new connection on the socket.
                                         /**< The accept() member will return a new client file
@@ -84,7 +89,7 @@ namespace senf {
                                              \returns file descriptor of new client socket */
 #       endif
 
-        static int accept(FileHandle handle);
+        static int accept(FileHandle const & handle);
                                         ///< accept a new connection on the socket.
                                         /**< The accept() member will return a new client file
                                              descriptor. This file descriptor will be used by the
@@ -95,8 +100,8 @@ namespace senf {
                                              \returns file descriptor of new client socket */
 
     private:
-        static void do_listen(FileHandle handle, unsigned backlog);
-        static int do_accept(FileHandle handle, struct sockaddr * addr, unsigned len);
+        static void do_listen(FileHandle const & handle, unsigned backlog);
+        static int do_accept(FileHandle const & handle, struct sockaddr * addr, unsigned len);
     };
 
     /** \brief CommunicationPolicy for unconnected sockets
@@ -109,12 +114,12 @@ namespace senf {
     struct UnconnectedCommunicationPolicy : public CommunicationPolicyBase
     {};
 
-    /// @}
+    //\}
 
 }
 
 
-///////////////////////////////hh.e////////////////////////////////////////
+//-/////////////////////////////////////////////////////////////////////////////////////////////////
 #include "CommunicationPolicy.cci"
 //#include "CommunicationPolicy.ct"
 #include "CommunicationPolicy.cti"