/**
* Copyright (C) 2021 Saturneric
*
* This file is part of GpgFrontend.
*
* GpgFrontend is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* GpgFrontend 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with GpgFrontend. If not, see .
*
* The initial version of the source code is inherited from
* the gpg4usb project, which is under GPL-3.0-or-later.
*
* All the source code of GpgFrontend was modified and released by
* Saturneric starting on May 12, 2021.
*
* SPDX-License-Identifier: GPL-3.0-or-later
*
*/
#ifndef GPGFRONTEND_ZH_CN_TS_BASICOPERATOR_H
#define GPGFRONTEND_ZH_CN_TS_BASICOPERATOR_H
#include "core/GpgConstants.h"
#include "core/GpgContext.h"
#include "core/GpgFunctionObject.h"
#include "core/GpgModel.h"
namespace GpgFrontend {
/**
* @brief Basic operation collection
*
*/
class GPGFRONTEND_CORE_EXPORT GpgBasicOperator
: public SingletonFunctionObject {
public:
/**
* @brief Construct a new Basic Operator object
*
* @param channel Channel corresponding to the context
*/
explicit GpgBasicOperator(
int channel = SingletonFunctionObject::GetDefaultChannel());
/**
* @brief Call the interface provided by gpgme for encryption operation
*
* All incoming data pointers out_buffer will be replaced with new valid
* values
*
* @param keys list of public keys
* @param in_buffer data that needs to be encrypted
* @param out_buffer encrypted data
* @param result the result of the operation
* @return error code
*/
gpg_error_t Encrypt(KeyListPtr keys, BypeArrayRef in_buffer,
ByteArrayPtr& out_buffer, GpgEncrResult& result);
/**
* @brief Call the interface provided by GPGME to symmetrical encryption
*
* @param in_buffer Data for encryption
* @param out_buffer Encrypted data
* @param result Encrypted results
* @return gpg_error_t
*/
gpg_error_t EncryptSymmetric(BypeArrayRef in_buffer, ByteArrayPtr& out_buffer,
GpgEncrResult& result);
/**
*
* @brief Call the interface provided by gpgme to perform encryption and
* signature operations at the same time.
*
* @param keys List of public keys
* @param signers Private key for signatures
* @param in_buffer Data for operation
* @param out_buffer Encrypted data
* @param encr_result Encrypted results
* @param sign_result Signature result
* @return
*/
gpgme_error_t EncryptSign(KeyListPtr keys, KeyListPtr signers,
BypeArrayRef in_buffer, ByteArrayPtr& out_buffer,
GpgEncrResult& encr_result,
GpgSignResult& sign_result);
/**
* @brief Call the interface provided by gpgme for decryption operation
*
* @param in_buffer data that needs to be decrypted
* @param out_buffer decrypted data
* @param result the result of the operation
* @return error code
*/
gpgme_error_t Decrypt(BypeArrayRef in_buffer, ByteArrayPtr& out_buffer,
GpgDecrResult& result);
/**
* @brief Call the interface provided by gpgme to perform decryption and
* verification operations at the same time.
*
* @param in_buffer data to be manipulated
* @param out_buffer data resulting from decryption operation
* @param decrypt_result the result of the decrypting operation
* @param verify_result the result of the verifying operation
* @return error code
*/
gpgme_error_t DecryptVerify(BypeArrayRef in_buffer, ByteArrayPtr& out_buffer,
GpgDecrResult& decrypt_result,
GpgVerifyResult& verify_result);
/**
* @brief Call the interface provided by gpgme for verification operation
*
* @param in_buffer data that needs to be verified
* @param out_buffer verified data
* @param result the result of the operation
* @return error code
*/
gpgme_error_t Verify(BypeArrayRef in_buffer, ByteArrayPtr& sig_buffer,
GpgVerifyResult& result) const;
/**
* @brief Call the interface provided by gpgme for signing operation
*
* The signing modes are as follows:
* `GPGME_SIG_MODE_NORMAL'
* A normal signature is made, the output includes the plaintext and the
* signature.
* `GPGME_SIG_MODE_DETACH'
* A detached signature is made.
* `GPGME_SIG_MODE_CLEAR'
* A clear text signature is made. The ASCII armor and text mode settings
* of the context are ignored.
*
* @param signers private keys for signing operations
* @param in_buffer data that needs to be signed
* @param out_buffer verified data
* @param mode signing mode
* @param result the result of the operation
* @return error code
*/
gpg_error_t Sign(KeyListPtr signers, BypeArrayRef in_buffer,
ByteArrayPtr& out_buffer, gpgme_sig_mode_t mode,
GpgSignResult& result);
/**
* @brief Set the private key for signatures, this operation is a global
* operation.
*
* @param keys
*/
void SetSigners(KeyArgsList& signers);
/**
* @brief Get a global signature private keys that has been set.
*
* @return Intelligent pointer pointing to the private key list
*/
std::unique_ptr GetSigners();
private:
GpgContext& ctx_ = GpgContext::GetInstance(
SingletonFunctionObject::GetChannel()); ///< Corresponding context
};
} // namespace GpgFrontend
#endif // GPGFRONTEND_ZH_CN_TS_BASICOPERATOR_H