File indexing completed on 2024-04-28 15:28:59

 /*
     This file is part of KNewStuff2.
     SPDX-FileCopyrightText: 2004, 2005 Andras Mantia <amantia@kde.org>
     SPDX-FileCopyrightText: 2007 Josef Spillner <spillner@kde.org>
 
     SPDX-License-Identifier: LGPL-2.1-or-later
 */
 
 #ifndef KNEWSTUFF2_SECURITY_P_H
 #define KNEWSTUFF2_SECURITY_P_H
 
 // qt includes
 #include <QMap>
 #include <QObject>
 #include <QProcess>
 
 #include "knewstuffcore_export.h"
 
 #if KNEWSTUFFCORE_ENABLE_DEPRECATED_SINCE(5, 31)
 
 struct KeyStruct {
     QString id;
     QString name;
     QString mail;
     bool trusted;
     bool secret;
 };
 
 namespace KNSCore
 {
 /**
  * Do not use this class. It is non-functional and internal.
  * @internal
  * @deprecated
  */
 class KNEWSTUFFCORE_EXPORT KNEWSTUFFCORE_DEPRECATED_VERSION(5, 31, "No longer use") Security : public QObject
 {
     Q_OBJECT
 public:
     static Security *ref()
     {
         static Security *m_ref;
         if (!m_ref) {
             m_ref = new Security();
         }
         return m_ref;
     }
     ~Security() override;
 
     /** Verifies the integrity and the signature of a tarball file.
      * @param fileName the file to be verified. It should be a tar.gz (.tgz) file. The directory where
      *               the file is should contain a "signature" and a "md5sum" file, otherwise verification will fail.
      *               The method is asynchronous and the result is signalled with @ref validityResult.
      */
     void checkValidity(const QString &fileName);
 
     /** Creates a signature and an md5sum file for the fileName and packs
      * everything into a gzipped tarball.
      * @param fileName the file with full path to sign
      *
      * The method is asynchronous and the result is signalled with @ref fileSigned.
      */
     void signFile(const QString &fileName);
 
     /** Get the key used for signing. This method is valid only if:
      *  - the checkValidity was called
      *  - the result of the validity check does not have the UNKNOWN bit set
      *
      *  @return the key used for signing the file
      */
     KeyStruct signatureKey()
     {
         return m_signatureKey;
     }
 
     enum Results {
         MD5_OK = 1, /// The MD5 sum check is OK
         SIGNED_OK = 2, /// The file is signed with a good signature
         SIGNED_BAD = 4, /// The file is signed with a bad signature
         TRUSTED = 8, /// The signature is trusted
         UNKNOWN = 16, /// The key is unknown
         SIGNED_BAD_CLEAR = 27, /// used to clear the SIGNED_BAD flag
         BAD_PASSPHRASE = 32, /// wrong passhprase entered
     };
 
 public Q_SLOTS:
 
     /** Reads the available public keys */
     void readKeys();
 
     /** Reads the available secret keys */
     void readSecretKeys();
 
     /** Verifies the integrity and the signature of a tarball file (see m_fileName).
      */
     void slotCheckValidity();
 
     /** Creates a signature and an md5sum file for the m_fileName and packs
      * everything into a gzipped tarball.
      */
     void slotSignFile();
 
 private:
     Security();
 
     enum RunMode {
         List = 0, /// read the public keys
         ListSecret, /// read the secret keys
         Verify, /// verify the signature
         Sign, /// create signature
     };
 
     KeyStruct m_signatureKey;
     int m_result;
     int m_runMode;
     bool m_gpgRunning; /// true if gpg is currently running
     bool m_keysRead; /// true if all the keys were read
     QMap<QString, KeyStruct> m_keys; /// holds information about the available key
     QString m_fileName; /// the file to sign/verify
     QString m_secretKey; /// the key used for signing
     QProcess *m_process;
 
 private Q_SLOTS:
     void slotFinished(int exitCode, QProcess::ExitStatus exitStatus);
     void slotReadyReadStandardOutput();
 
 Q_SIGNALS:
     /** Sent when the validity check is done.
      *
      *    @return the result of the check. See @ref Results
      */
     void validityResult(int result);
 
     /** Sent when the signing is done.
      *
      *    @return the result of the operation. See @ref Results
      */
     void fileSigned(int result);
 
     void signalInformation(const QString &) const;
     void signalError(const QString &) const;
 };
 
 }
 
 #endif // KNEWSTUFFCORE_ENABLE_DEPRECATED_SINCE(5, 31)
 
 #endif