/usr/include/KF5/ModemManagerQt/sim.h is in modemmanager-qt-dev 5.44.0-0ubuntu1.
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 | /*
Copyright 2008,2011 Will Stephenson <wstephenson@kde.org>
Copyright 2010-2011 Lamarque Souza <lamarque@kde.org>
Copyright 2013 Lukas Tinkl <ltinkl@redhat.com>
Copyright 2013-2015 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 MODEMMANAGERQT_SIM_H
#define MODEMMANAGERQT_SIM_H
#include <modemmanagerqt_export.h>
#include <QObject>
#include <QSharedPointer>
#include <QDBusPendingReply>
namespace ModemManager
{
class SimPrivate;
/**
* @brief The Sim class
*
* The SIM class handles communication with SIM, USIM, and RUIM (CDMA SIM) cards.
*/
class MODEMMANAGERQT_EXPORT Sim : public QObject
{
Q_OBJECT
Q_DECLARE_PRIVATE(Sim)
public:
typedef QSharedPointer<Sim> Ptr;
typedef QList<Ptr> List;
explicit Sim(const QString &path, QObject *parent = nullptr);
~Sim();
/**
* @return An obfuscated SIM identifier based on the IMSI or the ICCID.
*
* This may be available before the PIN has been entered depending on the device itself.
*/
QString simIdentifier() const;
/**
* @return The IMSI of the SIM card, if any.
*/
QString imsi() const;
/**
* @return The ID of the network operator, as given by the SIM card, if known.
*/
QString operatorIdentifier() const;
/**
* @return The name of the network operator, as given by the SIM card, if known.
*/
QString operatorName() const;
/**
* Send the PIN to unlock the SIM card.
* @param pin A string containing the PIN code.
*/
QDBusPendingReply<> sendPin(const QString &pin);
/**
* Send the PUK and a new PIN to unlock the SIM card.
* @param puk A string containing the PUK code.
* @param pin A string containing the PIN code.
*/
QDBusPendingReply<> sendPuk(const QString &puk, const QString &pin);
/**
* Enable or disable the PIN checking.
* @param pin A string containing the PIN code.
* @param enabled TRUE to enable PIN checking, FALSE otherwise.
*/
QDBusPendingReply<> enablePin(const QString &pin, bool enabled);
/**
* Change the PIN code.
* @param oldPin A string containing the current PIN code.
* @param newPin A string containing the new PIN code.
*/
QDBusPendingReply<> changePin(const QString &oldPin, const QString &newPin);
QString uni() const;
Q_SIGNALS:
void simIdentifierChanged(const QString &identifier);
void imsiChanged(const QString &imsi);
void operatorIdentifierChanged(const QString &identifier);
void operatorNameChanged(const QString &name);
private:
SimPrivate *const d_ptr;
};
} // namespace ModemManager
#endif
|