-rw-r--r-- | libopie2/opienet/onetwork.cpp | 8 | ||||
-rw-r--r-- | libopie2/opienet/onetwork.h | 20 |
2 files changed, 21 insertions, 7 deletions
diff --git a/libopie2/opienet/onetwork.cpp b/libopie2/opienet/onetwork.cpp index d918193..16fa8ae 100644 --- a/libopie2/opienet/onetwork.cpp +++ b/libopie2/opienet/onetwork.cpp | |||
@@ -935,64 +935,72 @@ OStationList* OWirelessNetworkInterface::scanNetwork() | |||
935 | case SIOCGIWESSID: | 935 | case SIOCGIWESSID: |
936 | { | 936 | { |
937 | odebug << "SIOCGIWESSID" << oendl; | 937 | odebug << "SIOCGIWESSID" << oendl; |
938 | stations->last()->ssid = we->u.essid.pointer; | 938 | stations->last()->ssid = we->u.essid.pointer; |
939 | break; | 939 | break; |
940 | } | 940 | } |
941 | case SIOCGIWSENS: odebug << "SIOCGIWSENS" << oendl; break; | 941 | case SIOCGIWSENS: odebug << "SIOCGIWSENS" << oendl; break; |
942 | case SIOCGIWENCODE: odebug << "SIOCGIWENCODE" << oendl; break; | 942 | case SIOCGIWENCODE: odebug << "SIOCGIWENCODE" << oendl; break; |
943 | case IWEVTXDROP: odebug << "IWEVTXDROP" << oendl; break; /* Packet dropped to excessive retry */ | 943 | case IWEVTXDROP: odebug << "IWEVTXDROP" << oendl; break; /* Packet dropped to excessive retry */ |
944 | case IWEVQUAL: odebug << "IWEVQUAL" << oendl; break; /* Quality part of statistics (scan) */ | 944 | case IWEVQUAL: odebug << "IWEVQUAL" << oendl; break; /* Quality part of statistics (scan) */ |
945 | case IWEVCUSTOM: odebug << "IWEVCUSTOM" << oendl; break; /* Driver specific ascii string */ | 945 | case IWEVCUSTOM: odebug << "IWEVCUSTOM" << oendl; break; /* Driver specific ascii string */ |
946 | case IWEVREGISTERED: odebug << "IWEVREGISTERED" << oendl; break; /* Discovered a new node (AP mode) */ | 946 | case IWEVREGISTERED: odebug << "IWEVREGISTERED" << oendl; break; /* Discovered a new node (AP mode) */ |
947 | case IWEVEXPIRED: odebug << "IWEVEXPIRED" << oendl; break; /* Expired a node (AP mode) */ | 947 | case IWEVEXPIRED: odebug << "IWEVEXPIRED" << oendl; break; /* Expired a node (AP mode) */ |
948 | default: odebug << "unhandled event" << oendl; | 948 | default: odebug << "unhandled event" << oendl; |
949 | } | 949 | } |
950 | 950 | ||
951 | offset += we->len; | 951 | offset += we->len; |
952 | we = (struct iw_event*) &buffer[offset]; | 952 | we = (struct iw_event*) &buffer[offset]; |
953 | } | 953 | } |
954 | return stations; | 954 | return stations; |
955 | 955 | ||
956 | return stations; | 956 | return stations; |
957 | 957 | ||
958 | } | 958 | } |
959 | else | 959 | else |
960 | { | 960 | { |
961 | odebug << " - no results (timeout) :(" << oendl; | 961 | odebug << " - no results (timeout) :(" << oendl; |
962 | return stations; | 962 | return stations; |
963 | } | 963 | } |
964 | } | 964 | } |
965 | 965 | ||
966 | 966 | ||
967 | int OWirelessNetworkInterface::signalStrength() const | ||
968 | { | ||
969 | int max = _range.max_qual.level; | ||
970 | odebug << "signalStrength(): max quality seems to be " << max << "dBM" << oendl; | ||
971 | return 50; | ||
972 | } | ||
973 | |||
974 | |||
967 | bool OWirelessNetworkInterface::wioctl( int call, struct iwreq& iwreq ) const | 975 | bool OWirelessNetworkInterface::wioctl( int call, struct iwreq& iwreq ) const |
968 | { | 976 | { |
969 | #ifndef NODEBUG | 977 | #ifndef NODEBUG |
970 | int result = ::ioctl( _sfd, call, &iwreq ); | 978 | int result = ::ioctl( _sfd, call, &iwreq ); |
971 | 979 | ||
972 | if ( result == -1 ) | 980 | if ( result == -1 ) |
973 | odebug << "ONetworkInterface::wioctl (" << name() << ") call '" | 981 | odebug << "ONetworkInterface::wioctl (" << name() << ") call '" |
974 | << debugmapper->map( call ) << "' FAILED! " << result << " (" << strerror( errno ) << ")" << oendl; | 982 | << debugmapper->map( call ) << "' FAILED! " << result << " (" << strerror( errno ) << ")" << oendl; |
975 | else | 983 | else |
976 | odebug << "ONetworkInterface::wioctl (" << name() << ") call '" | 984 | odebug << "ONetworkInterface::wioctl (" << name() << ") call '" |
977 | << debugmapper->map( call ) << "' - Status: Ok." << oendl; | 985 | << debugmapper->map( call ) << "' - Status: Ok." << oendl; |
978 | 986 | ||
979 | return ( result != -1 ); | 987 | return ( result != -1 ); |
980 | #else | 988 | #else |
981 | return ::ioctl( _sfd, call, &iwreq ) != -1; | 989 | return ::ioctl( _sfd, call, &iwreq ) != -1; |
982 | #endif | 990 | #endif |
983 | } | 991 | } |
984 | 992 | ||
985 | 993 | ||
986 | bool OWirelessNetworkInterface::wioctl( int call ) const | 994 | bool OWirelessNetworkInterface::wioctl( int call ) const |
987 | { | 995 | { |
988 | strcpy( _iwr.ifr_name, name() ); | 996 | strcpy( _iwr.ifr_name, name() ); |
989 | return wioctl( call, _iwr ); | 997 | return wioctl( call, _iwr ); |
990 | } | 998 | } |
991 | 999 | ||
992 | 1000 | ||
993 | /*====================================================================================== | 1001 | /*====================================================================================== |
994 | * OMonitoringInterface | 1002 | * OMonitoringInterface |
995 | *======================================================================================*/ | 1003 | *======================================================================================*/ |
996 | 1004 | ||
997 | OMonitoringInterface::OMonitoringInterface( ONetworkInterface* iface, bool prismHeader ) | 1005 | OMonitoringInterface::OMonitoringInterface( ONetworkInterface* iface, bool prismHeader ) |
998 | :_if( static_cast<OWirelessNetworkInterface*>( iface ) ), _prismHeader( prismHeader ) | 1006 | :_if( static_cast<OWirelessNetworkInterface*>( iface ) ), _prismHeader( prismHeader ) |
diff --git a/libopie2/opienet/onetwork.h b/libopie2/opienet/onetwork.h index bc9e299..9b8a0d4 100644 --- a/libopie2/opienet/onetwork.h +++ b/libopie2/opienet/onetwork.h | |||
@@ -1,159 +1,159 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of the Opie Project | 2 | This file is part of the Opie Project |
3 | Copyright (C) 2003 by Michael 'Mickey' Lauer <mickey@Vanille.de> | 3 | Copyright (C) 2003-2004 by Michael 'Mickey' Lauer |
4 | =. | 4 | =. <mickey@Vanille.de> |
5 | .=l. | 5 | .=l. |
6 | .>+-= | 6 | .>+-= |
7 | _;:, .> :=|. This program is free software; you can | 7 | _;:, .> :=|. This program is free software; you can |
8 | .> <`_, > . <= redistribute it and/or modify it under | 8 | .> <`_, > . <= redistribute it and/or modify it under |
9 | :`=1 )Y*s>-.-- : the terms of the GNU Library General Public | 9 | :`=1 )Y*s>-.-- : the terms of the GNU Library General Public |
10 | .="- .-=="i, .._ License as published by the Free Software | 10 | .="- .-=="i, .._ License as published by the Free Software |
11 | - . .-<_> .<> Foundation; either version 2 of the License, | 11 | - . .-<_> .<> Foundation; either version 2 of the License, |
12 | ._= =} : or (at your option) any later version. | 12 | ._= =} : or (at your option) any later version. |
13 | .%`+i> _;_. | 13 | .%`+i> _;_. |
14 | .i_,=:_. -<s. This program is distributed in the hope that | 14 | .i_,=:_. -<s. This program is distributed in the hope that |
15 | + . -:. = it will be useful, but WITHOUT ANY WARRANTY; | 15 | + . -:. = it will be useful, but WITHOUT ANY WARRANTY; |
16 | : .. .:, . . . without even the implied warranty of | 16 | : .. .:, . . . without even the implied warranty of |
17 | =_ + =;=|` MERCHANTABILITY or FITNESS FOR A | 17 | =_ + =;=|` MERCHANTABILITY or FITNESS FOR A |
18 | _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU | 18 | _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU |
19 | ..}^=.= = ; Library General Public License for more | 19 | ..}^=.= = ; Library General Public License for more |
20 | ++= -. .` .: details. | 20 | ++= -. .` .: details. |
21 | : = ...= . :.=- | 21 | : = ...= . :.=- |
22 | -. .:....=;==+<; You should have received a copy of the GNU | 22 | -. .:....=;==+<; You should have received a copy of the GNU |
23 | -_. . . )=. = Library General Public License along with | 23 | -_. . . )=. = Library General Public License along with |
24 | -- :-=` this library; see the file COPYING.LIB. | 24 | -- :-=` this library; see the file COPYING.LIB. |
25 | If not, write to the Free Software Foundation, | 25 | If not, write to the Free Software Foundation, |
26 | Inc., 59 Temple Place - Suite 330, | 26 | Inc., 59 Temple Place - Suite 330, |
27 | Boston, MA 02111-1307, USA. | 27 | Boston, MA 02111-1307, USA. |
28 | 28 | ||
29 | */ | 29 | */ |
30 | 30 | ||
31 | #ifndef ONETWORK_H | 31 | #ifndef ONETWORK_H |
32 | #define ONETWORK_H | 32 | #define ONETWORK_H |
33 | 33 | ||
34 | #include "wireless.h" | 34 | #include "wireless.h" |
35 | 35 | ||
36 | /* OPIE */ | 36 | /* OPIE */ |
37 | 37 | ||
38 | #include <opie2/onetutils.h> | 38 | #include <opie2/onetutils.h> |
39 | #include <opie2/ostation.h> | 39 | #include <opie2/ostation.h> |
40 | 40 | ||
41 | /* QT */ | 41 | /* QT */ |
42 | 42 | ||
43 | #include <qvaluelist.h> | 43 | #include <qvaluelist.h> |
44 | #include <qdict.h> | 44 | #include <qdict.h> |
45 | #include <qmap.h> | 45 | #include <qmap.h> |
46 | #include <qobject.h> | 46 | #include <qobject.h> |
47 | #include <qhostaddress.h> | 47 | #include <qhostaddress.h> |
48 | 48 | ||
49 | class ONetworkInterface; | 49 | class ONetworkInterface; |
50 | class OWirelessNetworkInterface; | 50 | class OWirelessNetworkInterface; |
51 | class OChannelHopper; | 51 | class OChannelHopper; |
52 | class OMonitoringInterface; | 52 | class OMonitoringInterface; |
53 | 53 | ||
54 | /*====================================================================================== | 54 | /*====================================================================================== |
55 | * ONetwork | 55 | * ONetwork |
56 | *======================================================================================*/ | 56 | *======================================================================================*/ |
57 | 57 | ||
58 | /** | 58 | /** |
59 | * @brief A container class for all network interfaces | 59 | * @brief A container class for all network interfaces |
60 | * | 60 | * |
61 | * This class provides access to all available network interfaces of your computer. | 61 | * This class provides access to all available network interfaces of your computer. |
62 | * | 62 | * |
63 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> | 63 | * @author Michael 'Mickey' Lauer <mickey@vanille.de> |
64 | */ | 64 | */ |
65 | class ONetwork : public QObject | 65 | class ONetwork : public QObject |
66 | { | 66 | { |
67 | Q_OBJECT | 67 | Q_OBJECT |
68 | 68 | ||
69 | public: | 69 | public: |
70 | typedef QDict<ONetworkInterface> InterfaceMap; | 70 | typedef QDict<ONetworkInterface> InterfaceMap; |
71 | typedef QDictIterator<ONetworkInterface> InterfaceIterator; | 71 | typedef QDictIterator<ONetworkInterface> InterfaceIterator; |
72 | 72 | ||
73 | public: | 73 | public: |
74 | /** | 74 | /** |
75 | * @returns the number of available interfaces | 75 | * @returns the number of available interfaces |
76 | */ | 76 | */ |
77 | int count() const; | 77 | int count() const; |
78 | /** | 78 | /** |
79 | * @returns a pointer to the (one and only) @ref ONetwork instance. | 79 | * @returns a pointer to the (one and only) @ref ONetwork instance. |
80 | */ | 80 | */ |
81 | static ONetwork* instance(); | 81 | static ONetwork* instance(); |
82 | /** | 82 | /** |
83 | * @returns an iterator usable for iterating through all network interfaces. | 83 | * @returns an iterator usable for iterating through all network interfaces. |
84 | */ | 84 | */ |
85 | InterfaceIterator iterator() const; | 85 | InterfaceIterator iterator() const; |
86 | /** | 86 | /** |
87 | * @returns true, if the @a interface supports the wireless extension protocol. | 87 | * @returns true, if the @a interface supports the wireless extension protocol. |
88 | */ | 88 | */ |
89 | bool isWirelessInterface( const char* interface ) const; | 89 | bool isWirelessInterface( const char* interface ) const; |
90 | /** | 90 | /** |
91 | * @returns a pointer to the @ref ONetworkInterface object for the specified @a interface or 0, if not found. | 91 | * @returns a pointer to the @ref ONetworkInterface object for the specified @a interface or 0, if not found. |
92 | * @see ONetworkInterface | 92 | * @see ONetworkInterface |
93 | */ | 93 | */ |
94 | ONetworkInterface* interface( const QString& interface ) const; | 94 | ONetworkInterface* interface( const QString& interface ) const; |
95 | /** | 95 | /** |
96 | * @internal Rebuild the internal interface database | 96 | * @internal Rebuild the internal interface database |
97 | * @note Sometimes it might be useful to call this from client code, | 97 | * @note Sometimes it might be useful to call this from client code, |
98 | * e.g. after issuing a cardctl insert | 98 | * e.g. after issuing a cardctl insert |
99 | */ | 99 | */ |
100 | void synchronize(); | 100 | void synchronize(); |
101 | /** | 101 | /** |
102 | * @returns the wireless extension version used at compile time. | 102 | * @returns the wireless extension version used at compile time. |
103 | **/ | 103 | **/ |
104 | static short wirelessExtensionVersion(); | 104 | static short wirelessExtensionVersion(); |
105 | 105 | ||
106 | protected: | 106 | protected: |
107 | ONetwork(); | 107 | ONetwork(); |
108 | 108 | ||
109 | private: | 109 | private: |
110 | static ONetwork* _instance; | 110 | static ONetwork* _instance; |
111 | InterfaceMap _interfaces; | 111 | InterfaceMap _interfaces; |
112 | }; | 112 | }; |
113 | 113 | ||
114 | 114 | ||
115 | /*====================================================================================== | 115 | /*====================================================================================== |
116 | * ONetworkInterface | 116 | * ONetworkInterface |
117 | *======================================================================================*/ | 117 | *======================================================================================*/ |
118 | 118 | ||
119 | /** | 119 | /** |
120 | * @brief A network interface wrapper. | 120 | * @brief A network interface wrapper. |
121 | * | 121 | * |
122 | * This class provides a wrapper for a network interface. All the cumbersume details of | 122 | * This class provides a wrapper for a network interface. All the cumbersume details of |
123 | * Linux ioctls are hidden under a convenient high-level interface. | 123 | * Linux ioctls are hidden under a convenient high-level interface. |
124 | * @warning Most of the setting methods contained in this class require the appropriate | 124 | * @warning Most of the setting methods contained in this class require the appropriate |
125 | * process permissions to work. | 125 | * process permissions to work. |
126 | * | 126 | * |
127 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> | 127 | * @author Michael 'Mickey' Lauer <mickey@vanille.de> |
128 | */ | 128 | */ |
129 | class ONetworkInterface : public QObject | 129 | class ONetworkInterface : public QObject |
130 | { | 130 | { |
131 | friend class OMonitoringInterface; | 131 | friend class OMonitoringInterface; |
132 | friend class OCiscoMonitoringInterface; | 132 | friend class OCiscoMonitoringInterface; |
133 | friend class OWlanNGMonitoringInterface; | 133 | friend class OWlanNGMonitoringInterface; |
134 | friend class OHostAPMonitoringInterface; | 134 | friend class OHostAPMonitoringInterface; |
135 | friend class OOrinocoMonitoringInterface; | 135 | friend class OOrinocoMonitoringInterface; |
136 | 136 | ||
137 | public: | 137 | public: |
138 | /** | 138 | /** |
139 | * Constructor. Normally you don't create @ref ONetworkInterface objects yourself, | 139 | * Constructor. Normally you don't create @ref ONetworkInterface objects yourself, |
140 | * but access them via @ref ONetwork::interface(). | 140 | * but access them via @ref ONetwork::interface(). |
141 | */ | 141 | */ |
142 | ONetworkInterface( QObject* parent, const char* name ); | 142 | ONetworkInterface( QObject* parent, const char* name ); |
143 | /** | 143 | /** |
144 | * Destructor. | 144 | * Destructor. |
145 | */ | 145 | */ |
146 | virtual ~ONetworkInterface(); | 146 | virtual ~ONetworkInterface(); |
147 | /** | 147 | /** |
148 | * Associates a @a monitoring interface with this network interface. | 148 | * Associates a @a monitoring interface with this network interface. |
149 | * @note This is currently only useful with @ref OWirelessNetworkInterface objects. | 149 | * @note This is currently only useful with @ref OWirelessNetworkInterface objects. |
150 | */ | 150 | */ |
151 | void setMonitoring( OMonitoringInterface* monitoring ); | 151 | void setMonitoring( OMonitoringInterface* monitoring ); |
152 | /** | 152 | /** |
153 | * @returns the currently associated monitoring interface or 0, if no monitoring is associated. | 153 | * @returns the currently associated monitoring interface or 0, if no monitoring is associated. |
154 | */ | 154 | */ |
155 | OMonitoringInterface* monitoring() const; | 155 | OMonitoringInterface* monitoring() const; |
156 | /** | 156 | /** |
157 | * Setting an interface to promiscuous mode enables the device to receive | 157 | * Setting an interface to promiscuous mode enables the device to receive |
158 | * all packets on the shared medium - as opposed to packets which are addressed to this interface. | 158 | * all packets on the shared medium - as opposed to packets which are addressed to this interface. |
159 | */ | 159 | */ |
@@ -205,125 +205,125 @@ class ONetworkInterface : public QObject | |||
205 | */ | 205 | */ |
206 | QString ipV4Netmask() const; //TODO: make this return an OHostAddress | 206 | QString ipV4Netmask() const; //TODO: make this return an OHostAddress |
207 | /** | 207 | /** |
208 | * @returns the data link type currently associated with the interface. | 208 | * @returns the data link type currently associated with the interface. |
209 | * @see #include <net/if_arp.h> for possible values. | 209 | * @see #include <net/if_arp.h> for possible values. |
210 | */ | 210 | */ |
211 | int dataLinkType() const; | 211 | int dataLinkType() const; |
212 | 212 | ||
213 | protected: | 213 | protected: |
214 | const int _sfd; | 214 | const int _sfd; |
215 | mutable ifreq _ifr; | 215 | mutable ifreq _ifr; |
216 | OMonitoringInterface* _mon; | 216 | OMonitoringInterface* _mon; |
217 | 217 | ||
218 | protected: | 218 | protected: |
219 | struct ifreq& ifr() const; | 219 | struct ifreq& ifr() const; |
220 | virtual void init(); | 220 | virtual void init(); |
221 | bool ioctl( int call ) const; | 221 | bool ioctl( int call ) const; |
222 | bool ioctl( int call, struct ifreq& ) const; | 222 | bool ioctl( int call, struct ifreq& ) const; |
223 | }; | 223 | }; |
224 | 224 | ||
225 | /*====================================================================================== | 225 | /*====================================================================================== |
226 | * OChannelHopper | 226 | * OChannelHopper |
227 | *======================================================================================*/ | 227 | *======================================================================================*/ |
228 | 228 | ||
229 | /** | 229 | /** |
230 | * @brief A radio frequency channel hopper. | 230 | * @brief A radio frequency channel hopper. |
231 | * | 231 | * |
232 | * This class provides a channel hopper for radio frequencies. A channel hopper frequently | 232 | * This class provides a channel hopper for radio frequencies. A channel hopper frequently |
233 | * changes the radio frequency channel of its associated @ref OWirelessNetworkInterface. | 233 | * changes the radio frequency channel of its associated @ref OWirelessNetworkInterface. |
234 | * This is necessary when in monitoring mode and scanning for other devices, because | 234 | * This is necessary when in monitoring mode and scanning for other devices, because |
235 | * the radio frequency hardware can only detect packets sent on the same frequency. | 235 | * the radio frequency hardware can only detect packets sent on the same frequency. |
236 | * | 236 | * |
237 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> | 237 | * @author Michael 'Mickey' Lauer <mickey@vanille.de> |
238 | */ | 238 | */ |
239 | class OChannelHopper : public QObject | 239 | class OChannelHopper : public QObject |
240 | { | 240 | { |
241 | Q_OBJECT | 241 | Q_OBJECT |
242 | 242 | ||
243 | public: | 243 | public: |
244 | /** | 244 | /** |
245 | * Constructor. | 245 | * Constructor. |
246 | */ | 246 | */ |
247 | OChannelHopper( OWirelessNetworkInterface* ); | 247 | OChannelHopper( OWirelessNetworkInterface* ); |
248 | /** | 248 | /** |
249 | * Destructor. | 249 | * Destructor. |
250 | */ | 250 | */ |
251 | virtual ~OChannelHopper(); | 251 | virtual ~OChannelHopper(); |
252 | /** | 252 | /** |
253 | * @returns true, if the channel hopper is hopping channels | 253 | * @returns true, if the channel hopper is hopping channels |
254 | */ | 254 | */ |
255 | bool isActive() const; | 255 | bool isActive() const; |
256 | /** | 256 | /** |
257 | * @returns the last hopped channel | 257 | * @returns the last hopped channel |
258 | */ | 258 | */ |
259 | int channel() const; | 259 | int channel() const; |
260 | /** | 260 | /** |
261 | * Set the channel hopping @a interval. | 261 | * Set the channel hopping @a interval. |
262 | * An interval of 0 deactivates the channel hopper. | 262 | * An interval of 0 deactivates the channel hopper. |
263 | */ | 263 | */ |
264 | void setInterval( int interval ); | 264 | void setInterval( int interval ); |
265 | /** | 265 | /** |
266 | * @returns the channel hopping interval | 266 | * @returns the channel hopping interval |
267 | */ | 267 | */ |
268 | int interval() const; | 268 | int interval() const; |
269 | 269 | ||
270 | signals: | 270 | signals: |
271 | /** | 271 | /** |
272 | * This signal is emitted right after the channel hopper performed a hop | 272 | * This signal is emitted right after the channel hopper performed a hop |
273 | */ | 273 | */ |
274 | void hopped( int ); | 274 | void hopped( int ); |
275 | 275 | ||
276 | protected: | 276 | protected: |
277 | virtual void timerEvent( QTimerEvent* ); | 277 | virtual void timerEvent( QTimerEvent* ); |
278 | 278 | ||
279 | private: | 279 | private: |
280 | OWirelessNetworkInterface* _iface; | 280 | OWirelessNetworkInterface* _iface; |
281 | int _interval; | 281 | int _interval; |
282 | int _tid; | 282 | int _tid; |
283 | QValueList<int> _channels; | 283 | QValueList<int> _channels; |
284 | QValueList<int>::Iterator _channel; | 284 | QValueList<int>::Iterator _channel; |
285 | }; | 285 | }; |
286 | 286 | ||
287 | 287 | ||
288 | /*====================================================================================== | 288 | /*====================================================================================== |
289 | * OWirelessNetworkInterface | 289 | * OWirelessNetworkInterface |
290 | *======================================================================================*/ | 290 | *======================================================================================*/ |
291 | 291 | ||
292 | /** | 292 | /** |
293 | * @brief A network interface wrapper for interfaces supporting the wireless extensions protocol. | 293 | * @brief A network interface wrapper for interfaces supporting the wireless extensions protocol. |
294 | * | 294 | * |
295 | * This class provides a high-level encapsulation of the Linux wireless extension API. | 295 | * This class provides a high-level encapsulation of the Linux wireless extension API. |
296 | * | 296 | * |
297 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> | 297 | * @author Michael 'Mickey' Lauer <mickey@vanille.de> |
298 | */ | 298 | */ |
299 | class OWirelessNetworkInterface : public ONetworkInterface | 299 | class OWirelessNetworkInterface : public ONetworkInterface |
300 | { | 300 | { |
301 | friend class OMonitoringInterface; | 301 | friend class OMonitoringInterface; |
302 | friend class OCiscoMonitoringInterface; | 302 | friend class OCiscoMonitoringInterface; |
303 | friend class OWlanNGMonitoringInterface; | 303 | friend class OWlanNGMonitoringInterface; |
304 | friend class OHostAPMonitoringInterface; | 304 | friend class OHostAPMonitoringInterface; |
305 | friend class OOrinocoMonitoringInterface; | 305 | friend class OOrinocoMonitoringInterface; |
306 | 306 | ||
307 | friend class OPrivateIOCTL; | 307 | friend class OPrivateIOCTL; |
308 | 308 | ||
309 | public: | 309 | public: |
310 | /** | 310 | /** |
311 | * Constructor. | 311 | * Constructor. |
312 | */ | 312 | */ |
313 | OWirelessNetworkInterface( QObject* parent, const char* name ); | 313 | OWirelessNetworkInterface( QObject* parent, const char* name ); |
314 | /** | 314 | /** |
315 | * Destructor. | 315 | * Destructor. |
316 | */ | 316 | */ |
317 | virtual ~OWirelessNetworkInterface(); | 317 | virtual ~OWirelessNetworkInterface(); |
318 | /** | 318 | /** |
319 | * Setting the @a channel of the interface changes the radio frequency (RF) | 319 | * Setting the @a channel of the interface changes the radio frequency (RF) |
320 | * of the corresponding wireless network device. | 320 | * of the corresponding wireless network device. |
321 | * @note Common channel range is within [1-14]. A value of 0 is not allowed. | 321 | * @note Common channel range is within [1-14]. A value of 0 is not allowed. |
322 | * @see channels() | 322 | * @see channels() |
323 | */ | 323 | */ |
324 | virtual void setChannel( int channel ) const; | 324 | virtual void setChannel( int channel ) const; |
325 | /** | 325 | /** |
326 | * @returns the channel index of the current radio frequency. | 326 | * @returns the channel index of the current radio frequency. |
327 | */ | 327 | */ |
328 | virtual int channel() const; | 328 | virtual int channel() const; |
329 | /** | 329 | /** |
@@ -385,64 +385,70 @@ class OWirelessNetworkInterface : public ONetworkInterface | |||
385 | * @see OPrivateIOCTL | 385 | * @see OPrivateIOCTL |
386 | */ | 386 | */ |
387 | virtual void setPrivate( const QString& command, int number, ... ); | 387 | virtual void setPrivate( const QString& command, int number, ... ); |
388 | /** | 388 | /** |
389 | * @returns true if the interface is featuring the private IOCTL @command. | 389 | * @returns true if the interface is featuring the private IOCTL @command. |
390 | */ | 390 | */ |
391 | virtual bool hasPrivate( const QString& command ); | 391 | virtual bool hasPrivate( const QString& command ); |
392 | virtual void getPrivate( const QString& command ); //FIXME: Implement and document this | 392 | virtual void getPrivate( const QString& command ); //FIXME: Implement and document this |
393 | /** | 393 | /** |
394 | * @returns true if the interface is associated to an access point | 394 | * @returns true if the interface is associated to an access point |
395 | * @note: This information is only valid if the interface is in managed mode. | 395 | * @note: This information is only valid if the interface is in managed mode. |
396 | */ | 396 | */ |
397 | virtual bool isAssociated() const; | 397 | virtual bool isAssociated() const; |
398 | /** | 398 | /** |
399 | * @returns the MAC address of the Access Point if the device is in infrastructure mode. | 399 | * @returns the MAC address of the Access Point if the device is in infrastructure mode. |
400 | * @returns a (more or less random) cell ID address if the device is in adhoc mode. | 400 | * @returns a (more or less random) cell ID address if the device is in adhoc mode. |
401 | */ | 401 | */ |
402 | virtual OMacAddress associatedAP() const; | 402 | virtual OMacAddress associatedAP() const; |
403 | /** | 403 | /** |
404 | * Set the @a ssid (Service Set ID) string. This is used to decide | 404 | * Set the @a ssid (Service Set ID) string. This is used to decide |
405 | * which network to associate with (use "any" to let the driver decide). | 405 | * which network to associate with (use "any" to let the driver decide). |
406 | */ | 406 | */ |
407 | virtual void setSSID( const QString& ssid ); | 407 | virtual void setSSID( const QString& ssid ); |
408 | /** | 408 | /** |
409 | * @returns the current SSID (Service Set ID). | 409 | * @returns the current SSID (Service Set ID). |
410 | */ | 410 | */ |
411 | virtual QString SSID() const; | 411 | virtual QString SSID() const; |
412 | /** | 412 | /** |
413 | * Perform scanning the wireless network neighbourhood. | 413 | * Perform scanning the wireless network neighbourhood. |
414 | * @note: UNSTABLE API - UNDER CONSTRUCTION - DON'T USE! | 414 | * @note: UNSTABLE API - UNDER CONSTRUCTION - DON'T USE! |
415 | */ | 415 | */ |
416 | virtual OStationList* scanNetwork(); | 416 | virtual OStationList* scanNetwork(); |
417 | /** | ||
418 | * @return signal strength to associated neighbour (in percent). | ||
419 | * In infrastructure mode, this is the signal strength of the Access Point. | ||
420 | * In other modes the result is driver dependent. | ||
421 | */ | ||
422 | virtual int signalStrength() const; | ||
417 | /** @internal commit pending changes to the driver | 423 | /** @internal commit pending changes to the driver |
418 | * | 424 | * |
419 | */ | 425 | */ |
420 | void commit() const; | 426 | void commit() const; |
421 | 427 | ||
422 | protected: | 428 | protected: |
423 | void buildInformation(); | 429 | void buildInformation(); |
424 | void buildPrivateList(); | 430 | void buildPrivateList(); |
425 | void dumpInformation() const; | 431 | void dumpInformation() const; |
426 | virtual void init(); | 432 | virtual void init(); |
427 | struct iwreq& iwr() const; | 433 | struct iwreq& iwr() const; |
428 | bool wioctl( int call ) const; | 434 | bool wioctl( int call ) const; |
429 | bool wioctl( int call, struct iwreq& ) const; | 435 | bool wioctl( int call, struct iwreq& ) const; |
430 | 436 | ||
431 | protected: | 437 | protected: |
432 | mutable struct iwreq _iwr; | 438 | mutable struct iwreq _iwr; |
433 | QMap<int,int> _channels; | 439 | QMap<int,int> _channels; |
434 | struct iw_range _range; | 440 | struct iw_range _range; |
435 | 441 | ||
436 | private: | 442 | private: |
437 | OChannelHopper* _hopper; | 443 | OChannelHopper* _hopper; |
438 | }; | 444 | }; |
439 | 445 | ||
440 | 446 | ||
441 | /*====================================================================================== | 447 | /*====================================================================================== |
442 | * OMonitoringInterface | 448 | * OMonitoringInterface |
443 | *======================================================================================*/ | 449 | *======================================================================================*/ |
444 | 450 | ||
445 | 451 | ||
446 | class OMonitoringInterface | 452 | class OMonitoringInterface |
447 | { | 453 | { |
448 | public: | 454 | public: |