QCA::CRL Class Reference
[QCA user API]

Certificate Revocation List More...

#include <QtCrypto>

Collaboration diagram for QCA::CRL:
Collaboration graph
[legend]

List of all members.

Public Member Functions

void change (CRLContext *c)
 CRL (const CRL &from)
bool isNull () const
CertificateInfo issuerInfo () const
CertificateInfoOrdered issuerInfoOrdered () const
QByteArray issuerKeyId () const
QDateTime nextUpdate () const
int number () const
bool operator!= (const CRL &other) const
CRLoperator= (const CRL &from)
bool operator== (const CRL &a) const
QList< CRLEntryrevoked () const
SignatureAlgorithm signatureAlgorithm () const
QDateTime thisUpdate () const
QByteArray toDER () const
QString toPEM () const
bool toPEMFile (const QString &fileName) const

Static Public Member Functions

static CRL fromDER (const QByteArray &a, ConvertResult *result=0, const QString &provider=QString())
static CRL fromPEM (const QString &s, ConvertResult *result=0, const QString &provider=QString())
static CRL fromPEMFile (const QString &fileName, ConvertResult *result=0, const QString &provider=QString())

Friends

class Private

Detailed Description

Certificate Revocation List

A CRL is a list of certificates that are special in some way. The normal reason for including a certificate on a CRL is that the certificate should no longer be used. For example, if a key is compromised, then the associated certificate may no longer provides appropriate security. There are other reasons why a certificate may be placed on a CRL, as shown in the CRLEntry::Reason enumeration.

See also:
CertificateCollection for a way to handle Certificates and CRLs as a single entity.
CRLEntry for the CRL segment representing a single Certificate.

Constructor & Destructor Documentation

QCA::CRL::CRL ( const CRL from  ) 

Standard copy constructor.

Parameters:
from the revocation list to copy from

Member Function Documentation

CRL& QCA::CRL::operator= ( const CRL from  ) 

Standard assignment operator.

Parameters:
from the revocation list to assign from
bool QCA::CRL::isNull (  )  const

Test if the CRL is empty.

Returns:
true if the CRL is entry, otherwise return false
CertificateInfo QCA::CRL::issuerInfo (  )  const

Information on the issuer of the CRL as a QMultiMap.

See also:
issuerInfoOrdered for a version that maintains the order of information fields as per the underlying CRL.
CertificateInfoOrdered QCA::CRL::issuerInfoOrdered (  )  const

Information on the issuer of the CRL as an ordered list (QList of CertificateInfoPair).

See also:
issuerInfo for a version that allows lookup based on a multimap.
CertificateInfoPair for the elements in the list
int QCA::CRL::number (  )  const

The CRL serial number.

Note that serial numbers are a CRL extension, and not all certificates have one.

Returns:
the CRL serial number, or -1 if there is no serial number
QDateTime QCA::CRL::thisUpdate (  )  const

the time that this CRL became (or becomes) valid

QDateTime QCA::CRL::nextUpdate (  )  const

the time that this CRL will be obsoleted

you should obtain an updated CRL at this time

QList<CRLEntry> QCA::CRL::revoked (  )  const

a list of the revoked certificates in this CRL

SignatureAlgorithm QCA::CRL::signatureAlgorithm (  )  const

The signature algorithm used for the signature on this CRL.

QByteArray QCA::CRL::issuerKeyId (  )  const

The key identification of the CRL issuer.

bool QCA::CRL::operator== ( const CRL a  )  const

Test for equality of two Certificate Revocation Lists.

Parameters:
a the CRL to be compared to this CRL
Returns:
true if the two CRLs are the same
bool QCA::CRL::operator!= ( const CRL other  )  const [inline]

Inequality operator.

Parameters:
other the CRL to be compared to this CRL
QByteArray QCA::CRL::toDER (  )  const

Export the Certificate Revocation List (CRL) in DER format.

Returns:
an array containing the CRL in DER format
QString QCA::CRL::toPEM (  )  const

Export the Certificate Revocation List (CRL) in PEM format.

Returns:
a string containing the CRL in PEM format
bool QCA::CRL::toPEMFile ( const QString fileName  )  const

Export the Certificate Revocation List (CRL) into PEM format in a file.

Parameters:
fileName the name of the file to use
static CRL QCA::CRL::fromDER ( const QByteArray a,
ConvertResult result = 0,
const QString provider = QString() 
) [static]

Import a DER encoded Certificate Revocation List (CRL).

Parameters:
a the array containing the CRL in DER format
result a pointer to a ConvertResult, which if not-null will be set to the conversion status
provider the provider to use, if a specific provider is required
Returns:
the CRL corresponding to the contents of the array
static CRL QCA::CRL::fromPEM ( const QString s,
ConvertResult result = 0,
const QString provider = QString() 
) [static]

Import a PEM encoded Certificate Revocation List (CRL).

Parameters:
s the string containing the CRL in PEM format
result a pointer to a ConvertResult, which if not-null will be set to the conversion status
provider the provider to use, if a specific provider is required
Returns:
the CRL corresponding to the contents of the string
static CRL QCA::CRL::fromPEMFile ( const QString fileName,
ConvertResult result = 0,
const QString provider = QString() 
) [static]

Import a PEM encoded Certificate Revocation List (CRL) from a file.

Parameters:
fileName the name (and path, if required) of the file containing the certificate in PEM format
result a pointer to a ConvertResult, which if not-null will be set to the conversion status
provider the provider to use, if a specific provider is required
Returns:
the CRL in the file
void QCA::CRL::change ( CRLContext c  ) 

For internal use only.

Parameters:
c context (internal)

The documentation for this class was generated from the following file:
Generated on Sat Nov 27 13:41:18 2010 for Qt Cryptographic Architecture by  doxygen 1.6.3