• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KNewStuff

KNS::Security

KNS::Security Class Reference

#include <security.h>

Inheritance diagram for KNS::Security:

Inheritance graph
[legend]

List of all members.


Detailed Description

Handles security related issues, like signing, verifying.

It is a private class, not meant to be used by third party applications.

Author:
Andras Mantia <amantia@kde.org>

Definition at line 49 of file security.h.


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 fileSigned (int result)
void validityResult (int result)

Public Member Functions

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

Static Public Member Functions

static Security * ref ()

Member Enumeration Documentation

enum KNS::Security::Results

Enumerator:
MD5_OK 
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 86 of file security.h.


Constructor & Destructor Documentation

Security::~Security (  ) 

Definition at line 52 of file security.cpp.


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 215 of file security.cpp.

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

Sent when the signing is done.

Returns:
the result of the operation. See Results

void Security::readKeys (  )  [slot]

Reads the available public keys.

Definition at line 56 of file security.cpp.

void Security::readSecretKeys (  )  [slot]

Reads the available secret keys.

Definition at line 83 of file security.cpp.

static Security* KNS::Security::ref (  )  [inline, static]

Definition at line 53 of file security.h.

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 82 of file security.h.

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 284 of file security.cpp.

void Security::slotCheckValidity (  )  [slot]

Verifies the integrity and the signature of a tarball file (see m_fileName).

Definition at line 221 of file security.cpp.

void Security::slotSignFile (  )  [slot]

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

Definition at line 290 of file security.cpp.

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

Sent when the validity check is done.

Returns:
the result of the check. See Results


The documentation for this class was generated from the following files:
  • security.h
  • security.cpp

KNewStuff

Skip menu "KNewStuff"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • KIO
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal