/usr/include/NetworkManagerQt/wirelessdevice.h is in libnetworkmanagerqt-dev 0.9.8.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 | /*
Copyright 2008,2011 Will Stephenson <wstephenson@kde.org>
Copyright 2011-2013 Lamarque V. Souza <lamarque@kde.org>
Copyright 2013 Daniel Nicoletti <dantti12@gmail.com>
Copyright 2013 Jan Grulich <jgrulich@redhat.com>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) version 3, or any
later version accepted by the membership of KDE e.V. (or its
successor approved by the membership of KDE e.V.), which shall
act as a proxy defined in Section 6 of version 3 of the license.
This library 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
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef NETWORKMANAGERQT_WIRELESSDEVICE_H
#define NETWORKMANAGERQT_WIRELESSDEVICE_H
#include "NetworkManagerQt-export.h"
#include "device.h"
#include "accesspoint.h"
#include "wirelessnetwork.h"
#include <QDBusObjectPath>
#include <QDBusPendingReply>
namespace NetworkManager
{
class WirelessDevicePrivate;
/**
* A wireless network interface
*/
class NETWORKMANAGERQT_EXPORT WirelessDevice : public Device
{
Q_OBJECT
Q_ENUMS(OperationMode DeviceInterface)
public:
typedef QSharedPointer<WirelessDevice> Ptr;
typedef QList<Ptr> List;
/**
* The device's current operating mode
*/
enum OperationMode {
Unknown = 0, /**< not associated with a network */
Adhoc, /**< part of an adhoc network */
Infra, /**< a station in an infrastructure wireless network */
ApMode /**< access point in an infrastructure network */
};
/**
* Capabilities (currently all encryption/authentication related) of the device
*/
enum Capability {
NoCapability = 0x0, /**< Null capability */
Wep40 = 0x1, /**< 40 bit WEP cipher */
Wep104 = 0x2, /**< 104 bit WEP cipher */
Tkip = 0x4, /**< TKIP encryption cipher */
Ccmp = 0x8, /**< CCMP encryption cipher */
Wpa = 0x10, /**< WPA authentication protocol */
Rsn = 0x20, /**< RSN authethication protocol */
ApCap = 0x40, /**< The device supports Access Point mode. */
AdhocCap = 0x80 /**< The device supports Ad-Hoc mode. */
};
Q_DECLARE_FLAGS(Capabilities, Capability)
/**
* Creates a new WirelessDevice object.
*
* @param path the DBus path of the devise
*/
explicit WirelessDevice(const QString &path, QObject *parent = 0);
/**
* Destroys a WirelessDevice object.
*/
~WirelessDevice();
/**
* Return the type
*/
virtual Type type() const;
/**
* List of wireless networks currently visible to the hardware
*/
QStringList accessPoints() const;
/**
* Asks the device for a new scan of available wireless networks
* @param options Options of scan
* No documentation for options yet, see http://projects.gnome.org/NetworkManager/developers/api/09/spec.html#org.freedesktop.NetworkManager.Device.Wireless
*/
QDBusPendingReply<> requestScan(const QVariantMap &options = QVariantMap());
/**
* AccessPoint pointer this interface is currently associated with
*/
AccessPoint::Ptr activeAccessPoint() const;
/**
* The permanent hardware address of the network interface
*/
QString permanentHardwareAddress() const;
/**
* The hardware address currently used by the network interface
*/
QString hardwareAddress() const;
/**
* Retrieves the operation mode of this network.
*
* @return the current mode
* @see OperationMode
*/
WirelessDevice::OperationMode mode() const;
/**
* Retrieves the effective bit rate currently attainable by this device.
*
* @return the bitrate in Kbit/s
*/
int bitRate() const;
/**
* Retrieves the capabilities of this wifi network.
*
* @return the flag set describing the capabilities
* @see Capabilities
*/
WirelessDevice::Capabilities wirelessCapabilities() const;
/**
* Helper method to convert wire representation of operation mode to enum
*/
static WirelessDevice::OperationMode convertOperationMode(uint);
/**
* Helper method to convert wire representation of capabilities to enum
*/
static WirelessDevice::Capabilities convertCapabilities(uint);
/**
* Finds access point object given its Unique Network Identifier.
*
* @param uni the identifier of the AP to find from this network interface
* @returns a valid AccessPoint object if a network having the given UNI for this device is known to the system, 0 otherwise
*/
AccessPoint::Ptr findAccessPoint(const QString &uni);
/**
* Return the current list of networks
*/
WirelessNetwork::List networks() const;
/**
* Find a network with the given @p ssid, a Null object is
* returned if it can not be found
*/
WirelessNetwork::Ptr findNetwork(const QString &ssid) const;
Q_SIGNALS:
/**
* This signal is emitted when the bitrate of this network has changed.
*
* @param bitrate the new bitrate value for this network
*/
void bitRateChanged(int bitrate);
/**
* The active network changed.
*/
void activeAccessPointChanged(const QString &);
/**
* The device switched operating mode.
*/
void modeChanged(WirelessDevice::OperationMode);
/**
* The device changed its capabilities
*/
void wirelessCapabilitiesChanged(Capabilities);
/**
* The device changed its hardware address
*/
void hardwareAddressChanged(const QString &);
/**
* The device changed its permanent hardware address
*/
void permanentHardwareAddressChanged(const QString &);
/**
* The device changed its properties
*/
void wirelessPropertiesChanged(uint); // TODO this is bogus, remove
/**
* A new wireless access point appeared
*/
void accessPointAppeared(const QString &uni);
/**
* A wireless access point disappeared
*/
void accessPointDisappeared(const QString &uni);
/**
* A wireless network appeared
*/
void networkAppeared(const QString &ssid);
/**
* A wireless network disappeared
*/
void networkDisappeared(const QString &ssid);
protected:
/**
* When subclassing make sure to call the parent class method
* if the property was not useful to your new class
*/
virtual void propertyChanged(const QString &property, const QVariant &value);
protected Q_SLOTS:
void accessPointAdded(const QDBusObjectPath &);
void accessPointRemoved(const QDBusObjectPath &);
void removeNetwork(const QString &network);
private:
Q_DECLARE_PRIVATE(WirelessDevice)
};
} // namespace NetworkManager
#endif //NETWORKMANAGERQT_WIRELESSDEVICE_H
|