4 // Fraunhofer Institute for Open Communication Systems (FOKUS)
5 // Competence Center NETwork research (NET), St. Augustin, GERMANY
6 // Thorsten Horstmann <tho@berlios.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 NetdeviceController public header
27 #ifndef HH_SENF_Socket_NetdeviceController_
28 #define HH_SENF_Socket_NetdeviceController_ 1
32 #include <boost/shared_ptr.hpp>
33 #include <boost/weak_ptr.hpp>
34 #include <senf/Socket/Protocols/Raw/MACAddress.hh>
37 //#include "NetdeviceController.mpp"
38 ///////////////////////////////hh.p////////////////////////////////////////
44 /** \brief Netdevice Controller
46 This controller provides an interface which can be used to configure network
47 devices. Note, that some setting members are privileged operations.
49 \see manual page netdevice(7) for more informations.
51 class NetdeviceController
54 explicit NetdeviceController(std::string const & interface_name);
55 ///< Construct a new controller for the given interface name.
56 explicit NetdeviceController(int interface_index);
57 ///< Construct a new controller for the given interface index.
58 int interfaceIndex() const; ///< return the interface index
59 MACAddress hardwareAddress() const;
60 ///< return hardware address
61 void hardwareAddress(const MACAddress &newAddress);
62 ///< set hardware address
63 /**< Changes the hardware address of the interface.
64 Note, that setting the hardware address is a privileged
65 operation. It is only allowed when the interface is not
66 up. If the interface is up, this call will cause an
67 SystemException to be thrown. */
68 std::string interfaceName() const;
69 ///< return interface name
70 void interfaceName(const std::string &newName);
71 ///< set interface name
72 /**< Changes the name of the interface.
73 Note, that setting the name is a privileged operation.
74 It is only allowed when the interface is not up. If
75 the interface is up, this call will cause an
76 SystemException to be thrown. */
78 int mtu() const; ///< return the Maximum Transmission Unit
79 void mtu(int new_mtu); ///< set the Maximum Transmission Unit
80 /**< Set the MTU (Maximum Transfer Unit) of the device.
81 Note, that this is a privileged operation.
82 Setting the MTU to too small values may cause kernel
85 int txqueuelen() const; ///< return the Tx Queue Length
86 void txqueuelen(int new_mtu); ///< set the Tx Queue Length
87 /**< Set the Tx Queue Length (in Packets) MTU of the device.
88 Note, that this is a privileged operation. */
91 bool promisc() const; ///< return \c true if interface is in promiscuous mode
92 void promisc(bool mode); ///< enable/disable promiscuous mode of the interface
93 /**< Note, that this is a privileged operation. */
95 bool isUp() const; ///< return \c true if interface is up
96 void up(); ///< ifconfig up interface
97 void down(); ///< ifconfig down interface
100 typedef boost::shared_ptr<SockFd> ptr;
106 static SockFd::ptr sockfd();
109 void doIoctl(ifreq& ifr, int request) const;
110 void ifrName(ifreq& ifr) const;
117 ///////////////////////////////hh.e////////////////////////////////////////
118 //#include "NetdeviceController.cci"
119 //#include "NetdeviceController.ct"
120 //#include "NetdeviceController.cti"
121 //#include "NetdeviceController.mpp"
128 // c-file-style: "senf"
129 // indent-tabs-mode: nil
130 // ispell-local-dictionary: "american"
131 // compile-command: "scons -u test"
132 // comment-column: 40