.TH "KSSLPKCS12" kde3 "11 Jun 2005" "Version Version 3.4.1" "kio Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KSSLPKCS12 \- \fBKDE\fP PKCS#12 Certificate \fBKDE\fP PKCS#12 Certificate.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <ksslpkcs12.h>\fP
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "virtual \fB~KSSLPKCS12\fP ()"
.br
.ti -1c
.RI "\fBQString\fP \fBname\fP ()"
.br
.ti -1c
.RI "\fBQString\fP \fBtoString\fP ()"
.br
.ti -1c
.RI "void \fBsetCert\fP (PKCS12 *c)"
.br
.ti -1c
.RI "bool \fBchangePassword\fP (\fBQString\fP pold, \fBQString\fP pnew)"
.br
.ti -1c
.RI "EVP_PKEY * \fBgetPrivateKey\fP ()"
.br
.ti -1c
.RI "\fBKSSLCertificate\fP * \fBgetCertificate\fP ()"
.br
.ti -1c
.RI "bool \fBtoFile\fP (\fBQString\fP filename)"
.br
.ti -1c
.RI "\fBKSSLCertificate::KSSLValidation\fP \fBvalidate\fP ()"
.br
.ti -1c
.RI "\fBKSSLCertificate::KSSLValidation\fP \fBvalidate\fP (KSSLCertificate::KSSLPurpose p)"
.br
.ti -1c
.RI "\fBKSSLCertificate::KSSLValidation\fP \fBrevalidate\fP ()"
.br
.ti -1c
.RI "\fBKSSLCertificate::KSSLValidation\fP \fBrevalidate\fP (KSSLCertificate::KSSLPurpose p)"
.br
.ti -1c
.RI "bool \fBisValid\fP ()"
.br
.ti -1c
.RI "bool \fBisValid\fP (KSSLCertificate::KSSLPurpose p)"
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static \fBKSSLPKCS12\fP * \fBfromString\fP (\fBQString\fP base64, \fBQString\fP password='')"
.br
.ti -1c
.RI "static \fBKSSLPKCS12\fP * \fBloadCertFile\fP (\fBQString\fP filename, \fBQString\fP password='')"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "bool \fBparse\fP (\fBQString\fP pass)"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKSSL\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
\fBKDE\fP PKCS#12 Certificate \fBKDE\fP PKCS#12 Certificate. 

As of yet, this class is being defined. if you use it, let it be known that BC will break on you until this message is removed.
.PP
\fBAuthor:\fP
.RS 4
George Staikos <staikos@kde.org> 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKSSL\fP, \fBKSSLCertificate\fP 
.RE
.PP

.PP
Definition at line 61 of file ksslpkcs12.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KSSLPKCS12::~\fBKSSLPKCS12\fP ()\fC [virtual]\fP"
.PP
Destroy this PKCS#12 certificate. 
.PP
Definition at line 58 of file ksslpkcs12.cc.
.PP
References KOpenSSLProxy::EVP_PKEY_free(), KOpenSSLProxy::PKCS12_free(), and KOpenSSLProxy::X509_free().
.SH "Member Function Documentation"
.PP 
.SS "\fBQString\fP KSSLPKCS12::name ()"
.PP
The name of this certificate. 
.PP
This can be used to refer to the certificate instead of passing the object itself. 
.PP
\fBReturns:\fP
.RS 4
the name of the certificate
.RE
.PP

.PP
Definition at line 279 of file ksslpkcs12.cc.
.SS "\fBKSSLPKCS12\fP * KSSLPKCS12::fromString (\fBQString\fP base64, \fBQString\fP password = \fC''\fP)\fC [static]\fP"
.PP
Create a KSSLPKCS12 object from a Base64 in a \fBQString\fP. 
.PP
\fBParameters:\fP
.RS 4
\fIbase64\fP the base64 encoded certificate 
.br
\fIpassword\fP a password for the certificate if encrypted 
.RE
.PP
\fBReturns:\fP
.RS 4
the PKCS#12 object, or NULL on failure.
.RE
.PP

.PP
Definition at line 75 of file ksslpkcs12.cc.
.PP
References KCodecs::base64Decode(), KTempFile::close(), KTempFile::file(), QString::isEmpty(), QString::latin1(), loadCertFile(), KTempFile::name(), and KTempFile::unlink().
.SS "\fBKSSLPKCS12\fP * KSSLPKCS12::loadCertFile (\fBQString\fP filename, \fBQString\fP password = \fC''\fP)\fC [static]\fP"
.PP
Create a KSSLPKCS12 object by reading a PKCS#12 file. 
.PP
\fBParameters:\fP
.RS 4
\fIfilename\fP the filename of the certificate 
.br
\fIpassword\fP a password for the certificate if encrypted 
.RE
.PP
\fBReturns:\fP
.RS 4
the PKCS#12 object, or NULL on failure.
.RE
.PP

.PP
Definition at line 93 of file ksslpkcs12.cc.
.PP
References QFile::handle(), QFile::open(), parse(), and setCert().
.PP
Referenced by fromString().
.SS "\fBQString\fP KSSLPKCS12::toString ()"
.PP
Convert to a Base64 string. 
.PP
\fBReturns:\fP
.RS 4
the certificate in base64 form
.RE
.PP

.PP
Definition at line 196 of file ksslpkcs12.cc.
.PP
References KCodecs::base64Encode(), and KOpenSSLProxy::i2d_PKCS12().
.SS "void KSSLPKCS12::setCert (PKCS12 * c)"
.PP
Raw set the PKCS12 object. 
.PP
\fBParameters:\fP
.RS 4
\fIc\fP the openssl PKCS12 object 
.RE
.PP

.PP
Definition at line 126 of file ksslpkcs12.cc.
.PP
Referenced by loadCertFile().
.SS "bool KSSLPKCS12::changePassword (\fBQString\fP pold, \fBQString\fP pnew)"
.PP
Change the password of the PKCS#12 in memory. 
.PP
\fBParameters:\fP
.RS 4
\fIpold\fP the old password 
.br
\fIpnew\fP the new password 
.RE
.PP
\fBReturns:\fP
.RS 4
true on success
.RE
.PP

.PP
Definition at line 133 of file ksslpkcs12.cc.
.PP
References QString::isNull(), QString::latin1(), and KOpenSSLProxy::PKCS12_newpass().
.SS "EVP_PKEY * KSSLPKCS12::getPrivateKey ()"
.PP
Get the private key. 
.PP
\fBReturns:\fP
.RS 4
the internal OpenSSL private key format 
.RE
.PP

.PP
Definition at line 186 of file ksslpkcs12.cc.
.SS "\fBKSSLCertificate\fP * KSSLPKCS12::getCertificate ()"
.PP
Get the X.509 certificate. 
.PP
\fBReturns:\fP
.RS 4
the X.509 certificate for the PKCS#12 object, or NULL
.RE
.PP

.PP
Definition at line 191 of file ksslpkcs12.cc.
.SS "bool KSSLPKCS12::toFile (\fBQString\fP filename)"
.PP
Write the PKCS#12 to a file in raw mode. 
.PP
\fBParameters:\fP
.RS 4
\fIfilename\fP the file to write to 
.RE
.PP
\fBReturns:\fP
.RS 4
true on success
.RE
.PP

.PP
Definition at line 217 of file ksslpkcs12.cc.
.PP
References QFile::handle(), KOpenSSLProxy::i2d_PKCS12_fp(), QString::latin1(), and QFile::open().
.SS "\fBKSSLCertificate::KSSLValidation\fP KSSLPKCS12::validate ()"
.PP
Check the X.509 and private key to make sure they're valid. 
.PP
\fBReturns:\fP
.RS 4
the result of the validation 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKSSLCertificate\fP
.RE
.PP

.PP
Definition at line 240 of file ksslpkcs12.cc.
.PP
Referenced by isValid().
.SS "\fBKSSLCertificate::KSSLValidation\fP KSSLPKCS12::validate (KSSLCertificate::KSSLPurpose p)"
.PP
Check the X.509 and private key to make sure they're valid. 
.PP
\fBParameters:\fP
.RS 4
\fIp\fP the purpose to validate for 
.RE
.PP
\fBReturns:\fP
.RS 4
the result of the validation 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKSSLCertificate\fP
.RE
.PP

.PP
Definition at line 245 of file ksslpkcs12.cc.
.PP
References KOpenSSLProxy::X509_check_private_key().
.SS "\fBKSSLCertificate::KSSLValidation\fP KSSLPKCS12::revalidate ()"
.PP
Check the X.509 and private key to make sure they're valid. 
.PP
Ignore any cached validation result. 
.PP
\fBReturns:\fP
.RS 4
the result of the validation 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKSSLCertificate\fP
.RE
.PP

.PP
Definition at line 259 of file ksslpkcs12.cc.
.SS "\fBKSSLCertificate::KSSLValidation\fP KSSLPKCS12::revalidate (KSSLCertificate::KSSLPurpose p)"
.PP
Check the X.509 and private key to make sure they're valid. 
.PP
Ignore any cached validation result. 
.PP
\fBParameters:\fP
.RS 4
\fIp\fP the purpose to validate for 
.RE
.PP
\fBReturns:\fP
.RS 4
the result of the validation 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKSSLCertificate\fP
.RE
.PP

.PP
Definition at line 264 of file ksslpkcs12.cc.
.SS "bool KSSLPKCS12::isValid ()"
.PP
Check if the X.509 and private key are valid. 
.PP
\fBReturns:\fP
.RS 4
true if valid
.RE
.PP

.PP
Definition at line 269 of file ksslpkcs12.cc.
.SS "bool KSSLPKCS12::isValid (KSSLCertificate::KSSLPurpose p)"
.PP
Check if the X.509 and private key are valid. 
.PP
\fBParameters:\fP
.RS 4
\fIp\fP the purpose to validate for 
.RE
.PP
\fBReturns:\fP
.RS 4
true if valid
.RE
.PP

.PP
Definition at line 274 of file ksslpkcs12.cc.
.PP
References validate().

.SH "Author"
.PP 
Generated automatically by Doxygen for kio Library from the source code.
