diff --git a/lang/cpp/src/global.h b/lang/cpp/src/global.h index 7d9f9d66..d7430e2b 100644 --- a/lang/cpp/src/global.h +++ b/lang/cpp/src/global.h @@ -1,226 +1,226 @@ /* global.h - global gpgme functions and enums Copyright (C) 2003, 2007 Klarälvdalens Datakonsult AB 2016 Bundesamt für Sicherheit in der Informationstechnik Software engineering by Intevation GmbH This file is part of GPGME++. GPGME++ is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. GPGME++ 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 Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with GPGME++; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ // -*- c++ -*- #ifndef __GPGMEPP_GLOBAL_H__ #define __GPGMEPP_GLOBAL_H__ #include "gpgmefw.h" #include "gpgmepp_export.h" #include #include namespace GpgME { class Error; class EngineInfo; class Context; } struct _GIOChannel; typedef struct _GIOChannel GIOChannel; class QIODevice; namespace GpgME { GPGMEPP_EXPORT void initializeLibrary(); /*! Initializes the library, returns Error::code() == GPG_ERR_USER_1 if underlying gpgme is too old. */ GPGMEPP_EXPORT Error initializeLibrary(int); enum Protocol { OpenPGP, CMS, UnknownProtocol }; enum Engine { GpgEngine, GpgSMEngine, GpgConfEngine, UnknownEngine, AssuanEngine, G13Engine, SpawnEngine }; enum KeyListMode { Local = 0x1, Extern = 0x2, Locate = 0x3, Signatures = 0x4, SignatureNotations = 0x8, Validate = 0x10, Ephemeral = 0x20, WithTofu = 0x40, WithKeygrip = 0x80, WithSecret = 0x100 }; enum SignatureMode { NormalSignatureMode, Detached, Clearsigned }; GPGMEPP_EXPORT std::ostream &operator<<(std::ostream &os, Protocol proto); GPGMEPP_EXPORT std::ostream &operator<<(std::ostream &os, Engine eng); GPGMEPP_EXPORT std::ostream &operator<<(std::ostream &os, KeyListMode mode); GPGMEPP_EXPORT std::ostream &operator<<(std::ostream &os, SignatureMode mode); GPGMEPP_EXPORT Error setDefaultLocale(int category, const char *value); GPGMEPP_EXPORT Context *wait(Error &e, bool hang = true); typedef void (*IdleFunction)(void); GPGMEPP_EXPORT IdleFunction registerIdleFunction(IdleFunction idleFunction); typedef void (*IOCallback)(void *data, int fd); GPGMEPP_EXPORT EngineInfo engineInfo(Protocol proto); GPGMEPP_EXPORT EngineInfo engineInfo(Engine engine); /** Wrapper around gpgme_get_dirinfo. What can be: homedir, sysconfdir, bindir, libexecdir, libdir, datadir, localedir, agent-socket, agent-ssh-socket, dirmngr-socket, uiserver-socket, gpgconf-name, gpg-name, -gpgsm-name, g13-name +gpgsm-name, g13-name, socketdir. This may be extended in the future. */ GPGMEPP_EXPORT const char *dirInfo(const char *what); GPGMEPP_EXPORT Error checkEngine(Protocol proto); GPGMEPP_EXPORT Error checkEngine(Engine engine); /* Wrapper for gpgme_set_global_flag */ GPGMEPP_EXPORT int setGlobalFlag(const char *name, const char *value); GPGMEPP_EXPORT GIOChannel *getGIOChannel(int fd); GPGMEPP_EXPORT QIODevice *getQIODevice(int fd); enum Feature { ValidatingKeylistModeFeature = 0x00000001, CancelOperationFeature = 0x00000002, WrongKeyUsageFeature = 0x00000004, DefaultCertificateInclusionFeature = 0x00000008, GetSetEngineInfoFeature = 0x00000010, EngineInfoHomeDirFeature = 0x00000020, NoEncryptToEncryptionFlagFeature = 0x00000040, EphemeralKeylistModeFeature = 0x00000080, SetDataFileNameFeeature = 0x00000100, VerificationResultFileNameFeature = 0x00000200, DecryptionResultFileNameFeature = 0x00000400, DecryptionResultRecipientsFeature = 0x00000800, AuditLogFeature = 0x00001000, GpgConfEngineFeature = 0x00002000, CancelOperationAsyncFeature = 0x00004000, AssuanEngineFeature = 0x00008000, ClearAddGetSignatureNotationsFeature = 0x00010000, SignatureNotationsKeylistModeFeature = 0x00020000, KeySignatureNotationsFeature = 0x00040000, SignatureNotationsFlagsFeature = 0x00080000, SignatureNotationsCriticalFlagFeature = 0x00100000, SignatureNotationsHumanReadableFlagFeature = 0x00200000, CardKeyFeature = 0x00400000, ImportFromKeyserverFeature = 0x00800000, KeyIsQualifiedFeature = 0x01000200, SubkeyIsQualifiedFeature = 0x02000000, SignaturePkaFieldsFeature = 0x04000000, SignatureAlgorithmFieldsFeature = 0x08000000, FdPointerFeature = 0x10000000, G13VFSFeature = 0x20000000, PasswdFeature = 0x40000000, // gpgme >= 1.3.0 // unusable (max value) FeatureMaxValue = 0x80000000 }; enum Feature2 { BinaryAndFineGrainedIdentify = 0x00000001, // gpgme >= 1.7.0 Feature2MaxValue = 0x80000000 }; // use hasFeature( unsigned long, unsigned long ) instead GPGMEPP_DEPRECATED_EXPORT bool hasFeature(unsigned long feature); GPGMEPP_EXPORT bool hasFeature(unsigned long feature, unsigned long feature2); } // namespace GpgME # ifndef GPGMEPP_MAKE_STD_SWAP_SPECIALIZATION # define GPGMEPP_MAKE_STD_SWAP_SPECIALIZATION( Class ) \ namespace std { template <> inline void swap< GpgME::Class >( GpgME::Class & lhs, GpgME::Class & rhs ) { lhs.swap( rhs ); } } # endif # ifndef GPGMEPP_MAKE_SAFE_BOOL_OPERATOR # define GPGMEPP_MAKE_SAFE_BOOL_OPERATOR( Cond ) \ private: \ struct __safe_bool_dummy__ { void nonnull() {} }; \ typedef void ( __safe_bool_dummy__::*unspecified_bool_type )(); \ public: \ operator unspecified_bool_type() const { return ( Cond ) ? &__safe_bool_dummy__::nonnull : nullptr; } # endif inline int _gpgmepp_strcmp(const char *s1, const char *s2) { return s1 ? s2 ? std::strcmp(s1, s2) : 1 : s2 ? -1 : 0; } #define _GPGMEPP_MAKE_STRCMP( Name, expr, cmp ) \ template