knewstuff Library API Documentation

KNS::Security Class Reference

Inheritance diagram for KNS::Security:

Inheritance graph
[legend]
Collaboration diagram for KNS::Security:

Collaboration graph
[legend]
List of all members.

Public Types

enum  Results {
  MD5_OK = 1, SIGNED_OK = 2, SIGNED_BAD = 4, TRUSTED = 8,
  UNKNOWN = 16, SIGNED_BAD_CLEAR = 27, BAD_PASSPHRASE = 32
}

Public Slots

void readKeys ()
void readSecretKeys ()
void slotCheckValidity ()
void slotSignFile ()

Signals

void validityResult (int result)
void fileSigned (int result)

Public Member Functions

 ~Security ()
void checkValidity (const QString &fileName)
void signFile (const QString &fileName)
KeyStruct signatureKey ()

Static Public Member Functions

static Security *const ref ()

Detailed Description

Definition at line 44 of file security.h.


Member Enumeration Documentation

enum KNS::Security::Results
 

Enumerator:
SIGNED_OK  The MD5 sum check is OK.
SIGNED_BAD  The file is signed with a good signature.
TRUSTED  The file is signed with a bad signature.
UNKNOWN  The signature is trusted.
SIGNED_BAD_CLEAR  The key is unknown.
BAD_PASSPHRASE  used to clear the SIGNED_BAD flag

Definition at line 79 of file security.h.


Member Function Documentation

void Security::checkValidity const QString fileName  ) 
 

Verifies the integrity and the signature of a tarball file.

Parameters:
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 validityResult.

Definition at line 199 of file security.cpp.

References slotCheckValidity().

Referenced by KNewStuffSecure::install().

void Security::signFile const QString fileName  ) 
 

Creates a signature and an md5sum file for the fileName and packs everything into a gzipped tarball.

Parameters:
fileName the file with full path to sign
The method is asynchronous and the result is signalled with fileSigned.

Definition at line 263 of file security.cpp.

References slotSignFile().

Referenced by KNewStuffSecure::uploadResource().

KeyStruct KNS::Security::signatureKey  )  [inline]
 

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

Returns:
the key used for signing the file

Definition at line 77 of file security.h.

void Security::readKeys  )  [slot]
 

Reads the available public keys.

Definition at line 49 of file security.cpp.

References QMap::clear(), QObject::connect(), and QTimer::singleShot().

void Security::readSecretKeys  )  [slot]
 

Reads the available secret keys.

Definition at line 68 of file security.cpp.

References QObject::connect(), and QTimer::singleShot().

void Security::slotCheckValidity  )  [slot]
 

Verifies the integrity and the signature of a tarball file (.

See also:
m_fileName).

Definition at line 205 of file security.cpp.

References QFile::close(), QObject::connect(), QMap::count(), QFileInfo::dirPath(), KeyStruct::id, QString::isEmpty(), KeyStruct::mail, KeyStruct::name, QFile::open(), QFile::readLine(), QFile::setName(), SIGNED_BAD, QTimer::singleShot(), QString::startsWith(), KeyStruct::trusted, and validityResult().

Referenced by checkValidity().

void Security::slotSignFile  )  [slot]
 

Creates a signature and an md5sum file for the.

See also:
m_fileName and packs everything into a gzipped tarball.

Definition at line 269 of file security.cpp.

References QMap::begin(), QFile::close(), QObject::connect(), QFileInfo::dirPath(), QMap::end(), fileSigned(), QFile::open(), QFile::setName(), and QTimer::singleShot().

Referenced by signFile().

void KNS::Security::validityResult int  result  )  [signal]
 

Sent when the validity check is done.

Returns:
the result of the check. See Results

Referenced by slotCheckValidity().

void KNS::Security::fileSigned int  result  )  [signal]
 

Sent when the signing is done.

Returns:
the result of the operation. See Results

Referenced by slotSignFile().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for knewstuff Library Version 3.4.3.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sun Oct 9 08:03:20 2005 by doxygen 1.4.4 written by Dimitri van Heesch, © 1997-2003