-rw-r--r-- | libopie2/opienet/onetwork.h | 18 |
1 files changed, 12 insertions, 6 deletions
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,28 +1,28 @@ | |||
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 | ||
@@ -39,49 +39,49 @@ | |||
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. |
@@ -103,49 +103,49 @@ class ONetwork : public QObject | |||
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 ); |
@@ -213,49 +213,49 @@ class ONetworkInterface : public QObject | |||
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. |
@@ -273,49 +273,49 @@ class OChannelHopper : public QObject | |||
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. |
@@ -393,48 +393,54 @@ class OWirelessNetworkInterface : public ONetworkInterface | |||
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 | ||