switch to new MPL based Fraunhofer FOKUS Public License
[senf.git] / senf / Socket / NetdeviceController.hh
index 4ff1187..7c146f7 100644 (file)
@@ -2,23 +2,28 @@
 //
 // Copyright (C) 2007
 // Fraunhofer Institute for Open Communication Systems (FOKUS)
-// Competence Center NETwork research (NET), St. Augustin, GERMANY
-//     Thorsten Horstmann <tho@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):
+//   Thorsten Horstmann <tho@berlios.de>
 
 /** \file
     \brief NetdeviceController public header
 // Custom includes
 #include <string>
 #include <boost/shared_ptr.hpp>
-#include <boost/weak_ptr.hpp>
-#include <senf/Socket/Protocols/Raw/MACAddress.hh>
-
 
 //#include "NetdeviceController.mpp"
-///////////////////////////////hh.p////////////////////////////////////////
+//-/////////////////////////////////////////////////////////////////////////////////////////////////
 
 struct ifreq;
 
 namespace senf {
 
+    class MACAddress;
+
+
     /** \brief Netdevice Controller
 
         This controller provides an interface which can be used to configure network
@@ -58,7 +63,7 @@ namespace senf {
         int interfaceIndex() const;     ///< return the interface index
         MACAddress hardwareAddress() const;
                                         ///< return hardware address
-        void hardwareAddress(const MACAddress &newAddress);
+        void hardwareAddress(MACAddress const & newAddress);
                                         ///< set hardware address
                                         /**< Changes the hardware address of the interface.
                                              Note, that setting the hardware address is a privileged
@@ -67,21 +72,27 @@ namespace senf {
                                              SystemException to be thrown. */
         std::string interfaceName() const;
                                         ///< return interface name
-        void interfaceName(const std::string &newName);
+        void interfaceName(std::string const & newName);
                                         ///< set interface name
                                         /**< Changes the name of the interface.
-                                             Note, that setting the name is a privileged operation. 
-                                             It is only allowed when the interface is not up. If 
-                                             the interface is up, this call will cause an 
+                                             Note, that setting the name is a privileged operation.
+                                             It is only allowed when the interface is not up. If
+                                             the interface is up, this call will cause an
                                              SystemException to be thrown. */
 
         int mtu() const;                ///< return the Maximum Transmission Unit
         void mtu(int new_mtu);          ///< set the Maximum Transmission Unit
                                         /**< Set the MTU (Maximum Transfer Unit) of the device.
                                              Note, that this is a privileged operation.
-                                             Setting the MTU to too small values may cause kernel 
+                                             Setting the MTU to too small values may cause kernel
                                              crashes. */
 
+        int txqueuelen() const;         ///< return the Tx Queue Length
+        void txqueuelen(int new_mtu);   ///< set the Tx Queue Length
+                                        /**< Set the Tx Queue Length (in Packets) MTU of the device.
+                                             Note, that this is a privileged operation. */
+
+
         bool promisc() const;           ///< return \c true if interface is in promiscuous mode
         void promisc(bool mode);        ///< enable/disable promiscuous mode of the interface
                                         /**< Note, that this is a privileged operation. */
@@ -100,22 +111,21 @@ namespace senf {
         static SockFd::ptr sockfd();
 
     private:
-        void doIoctl(ifreq& ifr, int request) const;
-        void ifrName(ifreq& ifr) const;
+        void ifrName(ifreq & ifr) const;
         SockFd::ptr sockfd_;
         int ifindex_;
     };
 
 }
 
-///////////////////////////////hh.e////////////////////////////////////////
+//-/////////////////////////////////////////////////////////////////////////////////////////////////
 //#include "NetdeviceController.cci"
 //#include "NetdeviceController.ct"
 //#include "NetdeviceController.cti"
 //#include "NetdeviceController.mpp"
 #endif
 
-
+\f
 // Local Variables:
 // mode: c++
 // fill-column: 100