/usr/include/solid/control/wirelessaccesspoint.h is in kde-workspace-dev 4:4.8.4-6.
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 | /*
Copyright 2008 Will Stephenson <wstephenson@kde.org>
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 SOLID_CONTROL_WIRELESSAP_H
#define SOLID_CONTROL_WIRELESSAP_H
#include <QtCore/QObject>
#include "wirelessnetworkinterface.h"
namespace Solid
{
namespace Control
{
class AccessPointPrivate;
class SOLIDCONTROL_EXPORT AccessPoint : public QObject
{
Q_OBJECT
Q_DECLARE_PRIVATE(AccessPoint)
Q_FLAGS(Capabilities WpaFlags)
public:
/**
* General capabilities of an access point
*/
enum Capability { Privacy = 0x1 };
/**
* Flags describing the access point's capabilities according to WPA (Wifi Protected Access)
*/
enum WpaFlag { PairWep40 = 0x1, PairWep104 = 0x2, PairTkip = 0x4, PairCcmp = 0x8,
GroupWep40 = 0x10, GroupWep104 = 0x20, GroupTkip = 0x40, GroupCcmp = 0x80,
KeyMgmtPsk = 0x100, KeyMgmt8021x = 0x200 };
Q_DECLARE_FLAGS(Capabilities, Capability)
Q_DECLARE_FLAGS(WpaFlags, WpaFlag)
/**
* Creates a new Network object.
*
* @param backendObject the network object provided by the backend
*/
AccessPoint(QObject *backendObject = 0);
/**
* Copy ctor
*/
AccessPoint(const AccessPoint &);
virtual ~AccessPoint();
/**
* Opaque and unique string identifier for this access point
*/
QString uni() const;
/**
* Flags describing the capabilities of the access point
*/
Solid::Control::AccessPoint::Capabilities capabilities() const;
/**
* Flags describing the access point's capabilities according to WPA (Wifi Protected Access)
*/
Solid::Control::AccessPoint::WpaFlags wpaFlags() const;
/**
* Flags describing the access point's capabilities according to RSN (Robust Secure Network)
* aka WPA2
*/
Solid::Control::AccessPoint::WpaFlags rsnFlags() const;
/**
* The Service Set Identifier of the access point
*/
QString ssid() const;
/**
* The raw bytes of the Service Set Identifier of the access point
*/
QByteArray rawSsid() const;
/**
* Retrieves the frequency in MHz of the radio channel that this access point is operating on
*
* @return the frequency
*/
uint frequency() const;
/**
* The hardware address assigned to the access point's wireless interface
*/
QString hardwareAddress() const;
/**
* Retrieves the maximum bit rate currently attainable with this access point
*
* @return the maximum bitrate in kilobit/s
*/
uint maxBitRate() const;
/**
* Retrieves the operation mode of this access point
*
* @return the current mode
* @see Solid::Control::WirelessNetworkInterface::OperationMode
*/
Solid::Control::WirelessNetworkInterface::OperationMode mode() const;
/**
* Retrieves the current signal strength of this access point
*
* @return the signal strength as a percentage
*/
int signalStrength() const;
Q_SIGNALS:
/**
* This signal is emitted when the signal strength of this access point has changed.
*
* @param strength the new signal strength value for this access point.
*/
void signalStrengthChanged(int strength);
/**
* This signal is emitted when the bitrate of this access point has changed.
*
* @param bitrate the new bitrate value for this access point
*/
void bitRateChanged(int bitrate);
/**
* This signal is emitted when the WPA flags in use by this access point change
*
* @param flags the new flags
*/
void wpaFlagsChanged(Solid::Control::AccessPoint::WpaFlags flags) const;
/**
* This signal is emitted when the RSN(WPA2) flags in use by this access point change
*
* @param flags the new flags
*/
void rsnFlagsChanged(Solid::Control::AccessPoint::WpaFlags flags) const;
/**
* This signal is emitted when the ssid of this Access Point changes
*
* @param ssid the new SSID
*/
void ssidChanged(const QString & ssid) const;
/**
* This signal is emitted when the frequency used by this Access Point changes
*
* @param frequency the new frequency
*/
void frequencyChanged(uint frequency) const;
protected:
/**
* @internal
*/
AccessPoint(AccessPointPrivate &dd, QObject *backendObject);
/**
* @internal
*/
AccessPoint(AccessPointPrivate &dd, const AccessPoint & ap);
AccessPointPrivate * d_ptr;
private Q_SLOTS:
void _k_destroyed(QObject *object);
};
typedef QStringList AccessPointList;
} // Control
} // Solid
Q_DECLARE_OPERATORS_FOR_FLAGS(Solid::Control::AccessPoint::Capabilities)
Q_DECLARE_OPERATORS_FOR_FLAGS(Solid::Control::AccessPoint::WpaFlags)
#endif // SOLID_CONTROL_WIRELESSAP_H
|