QCA::CRL

Search for usage in LXR

#include <QtCrypto>

Inheritance diagram for QCA::CRL:

Public Member Functions

 CRL (const CRL &from)
 
void change (CRLContext *c)
 
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
 
- Public Member Functions inherited from QCA::Algorithm
 Algorithm (const Algorithm &from)
 
void change (const QString &type, const QString &provider)
 
void change (Provider::Context *c)
 
Provider::Contextcontext ()
 
const Provider::Contextcontext () const
 
Algorithmoperator= (const Algorithm &from)
 
Providerprovider () const
 
Provider::ContexttakeContext ()
 
QString type () const
 

Static Public Member Functions

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

Additional Inherited Members

- Protected Member Functions inherited from QCA::Algorithm
 Algorithm ()
 
 Algorithm (const QString &type, const QString &provider)
 

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.

Definition at line 1739 of file qca_cert.h.

Constructor & Destructor Documentation

◆ CRL()

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

Standard copy constructor.

Parameters
fromthe revocation list to copy from

Member Function Documentation

◆ change()

void QCA::CRL::change ( CRLContext c)
Parameters
ccontext (internal)

◆ fromDER()

static CRL QCA::CRL::fromDER ( const QByteArray a,
ConvertResult result = nullptr,
const QString provider = QString() 
)
static

Import a DER encoded Certificate Revocation List (CRL)

Parameters
athe array containing the CRL in DER format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CRL corresponding to the contents of the array

◆ fromPEM()

static CRL QCA::CRL::fromPEM ( const QString s,
ConvertResult result = nullptr,
const QString provider = QString() 
)
static

Import a PEM encoded Certificate Revocation List (CRL)

Parameters
sthe string containing the CRL in PEM format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CRL corresponding to the contents of the string

◆ fromPEMFile()

static CRL QCA::CRL::fromPEMFile ( const QString fileName,
ConvertResult result = nullptr,
const QString provider = QString() 
)
static

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

Parameters
fileNamethe name (and path, if required) of the file containing the certificate in PEM format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CRL in the file

◆ isNull()

bool QCA::CRL::isNull ( ) const

Test if the CRL is empty.

Returns
true if the CRL is empty, otherwise return false

◆ issuerInfo()

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.

◆ issuerInfoOrdered()

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

◆ issuerKeyId()

QByteArray QCA::CRL::issuerKeyId ( ) const

The key identification of the CRL issuer.

◆ nextUpdate()

QDateTime QCA::CRL::nextUpdate ( ) const

the time that this CRL will be obsoleted

you should obtain an updated CRL at this time

◆ number()

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

◆ operator!=()

bool QCA::CRL::operator!= ( const CRL other) const
inline

Inequality operator.

Parameters
otherthe CRL to be compared to this CRL

Definition at line 1834 of file qca_cert.h.

◆ operator=()

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

Standard assignment operator.

Parameters
fromthe revocation list to assign from

◆ operator==()

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

Test for equality of two Certificate Revocation Lists.

Parameters
athe CRL to be compared to this CRL
Returns
true if the two CRLs are the same

◆ revoked()

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

a list of the revoked certificates in this CRL

◆ signatureAlgorithm()

SignatureAlgorithm QCA::CRL::signatureAlgorithm ( ) const

The signature algorithm used for the signature on this CRL.

◆ thisUpdate()

QDateTime QCA::CRL::thisUpdate ( ) const

the time that this CRL became (or becomes) valid

◆ toDER()

QByteArray QCA::CRL::toDER ( ) const

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

Returns
an array containing the CRL in DER format

◆ toPEM()

QString QCA::CRL::toPEM ( ) const

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

Returns
a string containing the CRL in PEM format

◆ toPEMFile()

bool QCA::CRL::toPEMFile ( const QString fileName) const

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

Parameters
fileNamethe name of the file to use

The documentation for this class was generated from the following file:
This file is part of the KDE documentation.
Documentation copyright © 1996-2022 The KDE developers.
Generated on Tue Nov 29 2022 03:51:18 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.