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

KNewStuff

KNS::Security

KNS::Security Class Reference

Handles security related issues, like signing, verifying. More...

#include <security.h>

Inheritance diagram for KNS::Security:
QObject

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 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 ()

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>

For internal use only.

Definition at line 47 of file security.h.


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


Constructor & Destructor Documentation

Security::~Security (  ) 

Definition at line 51 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 214 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 55 of file security.cpp.

void Security::readSecretKeys (  )  [slot]

Reads the available secret keys.

Definition at line 82 of file security.cpp.

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

Definition at line 51 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 80 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 283 of file security.cpp.

void Security::slotCheckValidity (  )  [slot]

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

Definition at line 220 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 289 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
  • KPty
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.6.1
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