KGpgSignKey Class Reference

#include <kgpgsignkey.h>

Inheritance diagram for KGpgSignKey:

Public Member Functions
	KGpgSignKey (QObject *parent, const QString &signer, KGpgKeyNode *key, const bool local, const carefulCheck checking)
virtual	~KGpgSignKey ()
Public Member Functions inherited from KGpgEditKeyTransaction
virtual	~KGpgEditKeyTransaction ()
QString	getKeyid () const
Public Member Functions inherited from KGpgTransaction
	KGpgTransaction (QObject *parent=0, const bool allowChaining=false)
virtual	~KGpgTransaction ()
void	clearInputTransaction ()
const QString &	getDescription () const
bool	hasInputTransaction () const
void	kill ()
void	setGnuPGHome (const QString &home)
void	setInputTransaction (KGpgTransaction *ta)
void	start ()
int	waitForFinished (const int msecs=-1)
Public Member Functions inherited from KGpgSignTransactionHelper
virtual	~KGpgSignTransactionHelper ()
carefulCheck	getChecking (void) const
const KGpgKeyNode *	getKey (void) const
bool	getLocal (void) const
QString	getSigner (void) const
void	setChecking (const carefulCheck level)
void	setKey (const KGpgKeyNode *node)
void	setLocal (const bool local)
void	setSecringFile (const QString &filename)
void	setSigner (const QString &signer)

Protected Member Functions
virtual KGpgTransaction *	asTransaction ()
virtual ts_boolanswer	boolQuestion (const QString &line)
virtual bool	nextLine (const QString &line)
virtual bool	passphraseReceived ()
virtual void	replaceCmd (const QString &cmd)
Protected Member Functions inherited from KGpgEditKeyTransaction
	KGpgEditKeyTransaction (QObject *parent, const QString &keyid, const QString &command, const bool hasValue, const bool autoSave=true)
virtual bool	preStart ()
void	replaceCommand (const QString &cmd)
void	replaceValue (const QString &arg)
Protected Member Functions inherited from KGpgTransaction
int	addArgument (const QString &arg)
void	addArgumentRef (int *ref)
int	addArguments (const QStringList &args)
void	addIdHint (QString txt)
void	askNewPassphrase (const QString &text)
bool	askPassphrase (const QString &message=QString())
virtual ts_boolanswer	confirmOverwrite (KUrl &currentFile)
virtual void	finish ()
QString	getIdHints () const
GPGProc *	getProcess ()
int	getSuccess () const
virtual bool	hintLine (const ts_hintType hint, const QString &args)
void	insertArgument (const int pos, const QString &arg)
void	insertArguments (const int pos, const QStringList &args)
virtual void	newPassphraseEntered ()
virtual bool	passphraseRequested ()
virtual void	postStart ()
void	replaceArgument (const int pos, const QString &arg)
void	setDescription (const QString &description)
void	setSuccess (const int v)
void	unexpectedLine (const QString &line)
void	waitForInputTransaction ()
void	write (const QByteArray &a, const bool lf=true)
void	write (const int i)
Protected Member Functions inherited from KGpgSignTransactionHelper
	KGpgSignTransactionHelper (const QString &signer, const bool local, const carefulCheck checking)
KGpgTransaction::ts_boolanswer	boolQuestion (const QString &line)
lineParseResults	nextLine (const QString &line)

Additional Inherited Members
Public Types inherited from KGpgTransaction
enum	ts_boolanswer { BA_UNKNOWN = 0, BA_YES = 1, BA_NO = 2 }
enum	ts_hintType { HT_KEYEXPIRED = 0, HT_SIGEXPIRED = 1, HT_NOSECKEY = 2, HT_ENCTO = 3 }
enum	ts_transaction {   TS_OK = 0, TS_BAD_PASSPHRASE = 1, TS_MSG_SEQUENCE = 2, TS_USER_ABORTED = 3,   TS_INVALID_EMAIL = 4, TS_INPUT_PROCESS_ERROR = 5, TS_COMMON_END = 100 }
Public Types inherited from KGpgSignTransactionHelper
enum	carefulCheck { noAnswer = 0, notChecked = 1, normalChecking = 2, carefulChecking = 3 }
enum	lineParseResults { handledFalse, handledTrue, notHandled }
enum	ts_signuid { TS_ALREADY_SIGNED = KGpgTransaction::TS_COMMON_END + 1 }
Signals inherited from KGpgTransaction
void	done (int result)
void	infoProgress (qulonglong processedAmount, qulonglong totalAmount)
void	statusMessage (const QString &msg)
Protected Attributes inherited from KGpgSignTransactionHelper
int	m_signerPos

Detailed Description

transaction class to sign all user ids of a key

Definition at line 28 of file kgpgsignkey.h.

Constructor & Destructor Documentation

KGpgSignKey::KGpgSignKey	(	QObject *	parent,
		const QString &	signer,
		KGpgKeyNode *	key,
		const bool	local,
		const carefulCheck	checking
	)

constructor

Parameters

parent	parent object
signer	id of the key to sign with
key	node to sign
local	if signature should be local (not exportable)
checking	how carefully the identity of the key owner was checked

See setUid() for description of uid.

Definition at line 18 of file kgpgsignkey.cpp.

KGpgSignKey::~KGpgSignKey ( )

virtual

destructor

Definition at line 34 of file kgpgsignkey.cpp.

Member Function Documentation

KGpgTransaction * KGpgSignKey::asTransaction ( )

protectedvirtual

returns the transaction object to use

This should really be static_cast<>(this) as you should only use this class as one of two anchestors of a transaction.

Implements KGpgSignTransactionHelper.

Definition at line 76 of file kgpgsignkey.cpp.

KGpgTransaction::ts_boolanswer KGpgSignKey::boolQuestion ( const QString &  line )

protectedvirtual

Called for every boolean question GnuPG answers.

Parameters

line	the question GnuPG asked

Returns

what to answer GnuPG

This is called instead of nextLine() if the line contains a boolean question. Returning BA_UNKNOWN will cancel the current transaction and will set the transaction result to TS_MSG_SEQUENCE.

The default implementation will answer BA_UNKNOWN to every question.

Reimplemented from KGpgEditKeyTransaction.

Definition at line 55 of file kgpgsignkey.cpp.

bool KGpgSignKey::nextLine ( const QString &  line )

protectedvirtual

handle standard GnuPG prompts

Parameters

line	the line to handle

By default this handles passphrase questions and quits the operation when GnuPG returns to it's command prompt. The "GOOD_PASSPHRASE" line is not handled here. When you inherit this class and need to handle specific line do them first and then call this method at the end of your method to handle all standard things (if you don't want to handle them yourself). Every line sent here by GnuPG not recognised as command handled here will set a sequence error so be sure to handle your stuff first!

Reimplemented from KGpgEditKeyTransaction.

Definition at line 39 of file kgpgsignkey.cpp.

bool KGpgSignKey::passphraseReceived ( )

protectedvirtual

called when GnuPG accepted the passphrase

Returns

if the input channel to GnuPG should be closed

Return values

true	close the input channel of the GnuPG process
false	keep the GnuPG input channel open

This allows a transaction to handle passphrase success in a special way. The default implementation will just return true.

Reimplemented from KGpgTransaction.

Definition at line 69 of file kgpgsignkey.cpp.

void KGpgSignKey::replaceCmd ( const QString &  cmd )

protectedvirtual

replaces the command passed to GnuPG

Parameters

cmd	new command to use

Implements KGpgSignTransactionHelper.

Definition at line 82 of file kgpgsignkey.cpp.

---

The documentation for this class was generated from the following files:

• kgpgsignkey.h
• kgpgsignkey.cpp