summaryrefslogtreecommitdiff
path: root/libopie2/opienet/onetwork.h
Unidiff
Diffstat (limited to 'libopie2/opienet/onetwork.h') (more/less context) (show whitespace changes)
-rw-r--r--libopie2/opienet/onetwork.h2
1 files changed, 2 insertions, 0 deletions
diff --git a/libopie2/opienet/onetwork.h b/libopie2/opienet/onetwork.h
index 2553a61..00d1ebb 100644
--- a/libopie2/opienet/onetwork.h
+++ b/libopie2/opienet/onetwork.h
@@ -291,96 +291,98 @@ class OChannelHopper : public QObject
291 */ 291 */
292 void hopped( int ); 292 void hopped( int );
293 293
294 protected: 294 protected:
295 virtual void timerEvent( QTimerEvent* ); 295 virtual void timerEvent( QTimerEvent* );
296 296
297 private: 297 private:
298 OWirelessNetworkInterface* _iface; 298 OWirelessNetworkInterface* _iface;
299 int _interval; 299 int _interval;
300 int _tid; 300 int _tid;
301 QValueList<int> _channels; 301 QValueList<int> _channels;
302 QValueList<int>::Iterator _channel; 302 QValueList<int>::Iterator _channel;
303}; 303};
304 304
305 305
306/*====================================================================================== 306/*======================================================================================
307 * OWirelessNetworkInterface 307 * OWirelessNetworkInterface
308 *======================================================================================*/ 308 *======================================================================================*/
309 309
310/** 310/**
311 * @brief A network interface wrapper for interfaces supporting the wireless extensions protocol. 311 * @brief A network interface wrapper for interfaces supporting the wireless extensions protocol.
312 * 312 *
313 * This class provides a high-level encapsulation of the Linux wireless extension API. 313 * This class provides a high-level encapsulation of the Linux wireless extension API.
314 * 314 *
315 * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> 315 * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de>
316 */ 316 */
317class OWirelessNetworkInterface : public ONetworkInterface 317class OWirelessNetworkInterface : public ONetworkInterface
318{ 318{
319 friend class OMonitoringInterface; 319 friend class OMonitoringInterface;
320 friend class OCiscoMonitoringInterface; 320 friend class OCiscoMonitoringInterface;
321 friend class OWlanNGMonitoringInterface; 321 friend class OWlanNGMonitoringInterface;
322 friend class OHostAPMonitoringInterface; 322 friend class OHostAPMonitoringInterface;
323 friend class OOrinocoMonitoringInterface; 323 friend class OOrinocoMonitoringInterface;
324 324
325 friend class OPrivateIOCTL; 325 friend class OPrivateIOCTL;
326 326
327 public: 327 public:
328 /** 328 /**
329 * Constructor. 329 * Constructor.
330 */ 330 */
331 OWirelessNetworkInterface( QObject* parent, const char* name ); 331 OWirelessNetworkInterface( QObject* parent, const char* name );
332 /** 332 /**
333 * Destructor. 333 * Destructor.
334 */ 334 */
335 virtual ~OWirelessNetworkInterface(); 335 virtual ~OWirelessNetworkInterface();
336 /** 336 /**
337 * Setting the @a channel of the interface changes the radio frequency (RF) 337 * Setting the @a channel of the interface changes the radio frequency (RF)
338 * of the corresponding wireless network device. 338 * of the corresponding wireless network device.
339 * @note Common channel range is within [1-14]. A value of 0 is not allowed.
340 * @see channels()
339 */ 341 */
340 virtual void setChannel( int channel ) const; 342 virtual void setChannel( int channel ) const;
341 /** 343 /**
342 * @returns the channel index of the current radio frequency. 344 * @returns the channel index of the current radio frequency.
343 */ 345 */
344 virtual int channel() const; 346 virtual int channel() const;
345 /** 347 /**
346 * @returns the current radio frequency (in MHz). 348 * @returns the current radio frequency (in MHz).
347 */ 349 */
348 virtual double frequency() const; 350 virtual double frequency() const;
349 /** 351 /**
350 * @returns the number of radio frequency channels for the 352 * @returns the number of radio frequency channels for the
351 * corresponding wireless network device. 353 * corresponding wireless network device.
352 * @note European devices usually have 14 channels, while American typically feature 11 channels. 354 * @note European devices usually have 14 channels, while American typically feature 11 channels.
353 */ 355 */
354 virtual int channels() const; 356 virtual int channels() const;
355 /** 357 /**
356 * Set the IEEE 802.11 operation @a mode. 358 * Set the IEEE 802.11 operation @a mode.
357 * Valid values are <ul><li>adhoc<li>managed<li>monitor<li>master 359 * Valid values are <ul><li>adhoc<li>managed<li>monitor<li>master
358 * @warning Not all drivers support the all modes. 360 * @warning Not all drivers support the all modes.
359 * @note You might have to change the SSID to get the operation mode change into effect. 361 * @note You might have to change the SSID to get the operation mode change into effect.
360 */ 362 */
361 virtual void setMode( const QString& mode ); 363 virtual void setMode( const QString& mode );
362 /** 364 /**
363 * @returns the current IEEE 802.11 operation mode. 365 * @returns the current IEEE 802.11 operation mode.
364 * Possible values are <ul><li>adhoc<li>managed<li>monitor<li>master or <li>unknown 366 * Possible values are <ul><li>adhoc<li>managed<li>monitor<li>master or <li>unknown
365 */ 367 */
366 virtual QString mode() const; 368 virtual QString mode() const;
367 /** 369 /**
368 * Setting the monitor mode on a wireless network interface enables 370 * Setting the monitor mode on a wireless network interface enables
369 * listening to IEEE 802.11 data and management frames which normally 371 * listening to IEEE 802.11 data and management frames which normally
370 * are handled by the device firmware. This can be used to detect 372 * are handled by the device firmware. This can be used to detect
371 * other wireless network devices, e.g. Access Points or Ad-hoc stations. 373 * other wireless network devices, e.g. Access Points or Ad-hoc stations.
372 * @warning Standard wireless network drives don't support the monitor mode. 374 * @warning Standard wireless network drives don't support the monitor mode.
373 * @warning You need a patched driver for this to work. 375 * @warning You need a patched driver for this to work.
374 * @note Enabling the monitor mode is highly driver dependent and requires 376 * @note Enabling the monitor mode is highly driver dependent and requires
375 * the proper @ref OMonitoringInterface to be associated with the interface. 377 * the proper @ref OMonitoringInterface to be associated with the interface.
376 * @see OMonitoringInterface 378 * @see OMonitoringInterface
377 */ 379 */
378 virtual void setMonitorMode( bool ); //FIXME: ==> setMode( "monitor" ); 380 virtual void setMonitorMode( bool ); //FIXME: ==> setMode( "monitor" );
379 /** 381 /**
380 * @returns true if the device is listening in IEEE 802.11 monitor mode 382 * @returns true if the device is listening in IEEE 802.11 monitor mode
381 */ 383 */
382 virtual bool monitorMode() const; //FIXME: ==> mode() 384 virtual bool monitorMode() const; //FIXME: ==> mode()
383 /** 385 /**
384 * Set the channel hopping @a interval. An @a interval of 0 disables channel hopping. 386 * Set the channel hopping @a interval. An @a interval of 0 disables channel hopping.
385 * @see OChannelHopper 387 * @see OChannelHopper
386 */ 388 */