KSSL Class Reference
#include <kssl.h>
Detailed Description
KDE SSL Wrapper ClassKDE SSL Class.This class implements KDE's SSL support by wrapping OpenSSL.
- See also:
- KExtendedSocket, TCPSlaveBase
Definition at line 42 of file kssl.h.
Public Member Functions | |
KSSL (bool init=true) | |
~KSSL () | |
bool | initialize () |
bool | TLSInit () |
bool | setSession (const KSSLSession *session) |
void | close () |
bool | reInitialize () |
bool | reconfig () |
void | setAutoReconfig (bool ar) |
int | seedWithEGD () |
bool | setSettings (KSSLSettings *settings) |
KSSLSettings * | settings () |
bool | setClientCertificate (KSSLPKCS12 *pkcs) |
void | setProxyUse (bool active, QString realIP=QString::null, int realPort=0, QString proxy=QString::null) KDE_DEPRECATED |
void | setPeerHost (QString realHost=QString::null) |
int | connect (int sock) |
int | accept (int sock) |
int | read (void *buf, int len) |
int | peek (void *buf, int len) |
int | write (const void *buf, int len) |
int | pending () |
KSSLConnectionInfo & | connectionInfo () |
KSSLPeerInfo & | peerInfo () |
const KSSLSession * | session () const |
bool | reusingSession () const |
Static Public Member Functions | |
static bool | doesSSLWork () |
Constructor & Destructor Documentation
KSSL::KSSL | ( | bool | init = true |
) |
KSSL::~KSSL | ( | ) |
Member Function Documentation
bool KSSL::doesSSLWork | ( | ) | [static] |
bool KSSL::initialize | ( | ) |
Initialize OpenSSL.
- Returns:
- true on success
- See also:
- reInitialize
bool KSSL::TLSInit | ( | ) |
bool KSSL::setSession | ( | const KSSLSession * | session | ) |
Set an SSL session to use.
This deep copies the session so it doesn't have to remain valid. You need to call it after calling initialize or reInitialize. The ID is cleared in close().
- Parameters:
-
session A valid session to reuse. If 0L, it will clear the session ID in memory.
- Returns:
- true on success
bool KSSL::reInitialize | ( | ) |
Reinitialize OpenSSL.
- Returns:
- true on success
- See also:
- initialize
bool KSSL::reconfig | ( | ) |
Trigger a reread of KSSL configuration and reInitialize() KSSL.
- Returns:
- true on successful reinitalizations
- See also:
- setAutoReconfig
void KSSL::setAutoReconfig | ( | bool | ar | ) |
Enable or disable automatic reconfiguration on initialize().
- Parameters:
-
ar Set to false in order to disable auto-reloading of the KSSL configuration during initialize().
int KSSL::seedWithEGD | ( | ) |
bool KSSL::setSettings | ( | KSSLSettings * | settings | ) |
Set a new KSSLSettings instance as the settings.
This deletes the current instance of KSSLSettings.
- Parameters:
-
settings A new, valid settings object.
- Returns:
- true on success
KSSLSettings* KSSL::settings | ( | ) | [inline] |
One is built by the constructor, so this will only return a NULL pointer if you set one with setSettings().
- Returns:
- the current settings instance
bool KSSL::setClientCertificate | ( | KSSLPKCS12 * | pkcs | ) |
Use this to set the certificate to send to the server.
Do NOT delete the KSSLPKCS12 object until you are done with the session. It is not defined when KSSL will be done with this.
- Parameters:
-
pkcs the valid PKCS#12 object to send.
- Returns:
- true if the certificate was properly set to the session.
void KSSL::setProxyUse | ( | bool | active, | |
QString | realIP = QString::null , |
|||
int | realPort = 0 , |
|||
QString | proxy = QString::null | |||
) |
Set the status of the connection with respect to proxies.
- Parameters:
-
active is not used realIP is the IP address of the host you're connecting to realPort is the port of the host you're connecting to proxy is the IP or hostname of the proxy server
void KSSL::setPeerHost | ( | QString | realHost = QString::null |
) |
int KSSL::connect | ( | int | sock | ) |
int KSSL::accept | ( | int | sock | ) |
Connect the SSL session to the remote host using the provided socket descriptor.
This is for use with an SSL server application.
- Parameters:
-
sock the socket descriptor to connect with. This must be an already connected socket.
- Returns:
- 1 on success, 0 on error setting the file descriptor, -1 on other error.
int KSSL::read | ( | void * | buf, | |
int | len | |||
) |
int KSSL::peek | ( | void * | buf, | |
int | len | |||
) |
int KSSL::write | ( | const void * | buf, | |
int | len | |||
) |
int KSSL::pending | ( | ) |
KSSLConnectionInfo & KSSL::connectionInfo | ( | ) |
Obtain a reference to the connection information.
- Returns:
- a reference to the connection information, valid after connected
- See also:
- KSSLConnectionInfo
KSSLPeerInfo & KSSL::peerInfo | ( | ) |
Obtain a reference to the information about the peer.
- Returns:
- a reference to the peer information, valid after connected
- See also:
- KSSLPeerInfo
const KSSLSession * KSSL::session | ( | ) | const |
Obtain a pointer to the session information.
- Returns:
- a pointer to the session information. This is valid after connected, while connected. It is deleted by the KSSL object which returns it. May return 0L if no valid session exists.
- See also:
- KSSLSession
bool KSSL::reusingSession | ( | ) | const |
The documentation for this class was generated from the following files: