Synopsis
int xmlSecGnuTLSAppInit (const char *config);
int xmlSecGnuTLSAppShutdown (void);
int xmlSecGnuTLSAppDefaultKeysMngrInit
(xmlSecKeysMngrPtr mngr);
int xmlSecGnuTLSAppDefaultKeysMngrAdoptKey
(xmlSecKeysMngrPtr mngr,
xmlSecKeyPtr key);
int xmlSecGnuTLSAppDefaultKeysMngrLoad
(xmlSecKeysMngrPtr mngr,
const char *uri);
int xmlSecGnuTLSAppDefaultKeysMngrSave
(xmlSecKeysMngrPtr mngr,
const char *filename,
xmlSecKeyDataType type);
int xmlSecGnuTLSAppKeysMngrCertLoad (xmlSecKeysMngrPtr mngr,
const char *filename,
xmlSecKeyDataFormat format,
xmlSecKeyDataType type);
int xmlSecGnuTLSAppKeysMngrCertLoadMemory
(xmlSecKeysMngrPtr mngr,
const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format,
xmlSecKeyDataType type);
xmlSecKeyPtr xmlSecGnuTLSAppKeyLoad (const char *filename,
xmlSecKeyDataFormat format,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
xmlSecKeyPtr xmlSecGnuTLSAppKeyLoadMemory (const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
xmlSecKeyPtr xmlSecGnuTLSAppPkcs12Load (const char *filename,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
xmlSecKeyPtr xmlSecGnuTLSAppPkcs12LoadMemory
(const xmlSecByte *data,
xmlSecSize dataSize,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
int xmlSecGnuTLSAppKeyCertLoad (xmlSecKeyPtr key,
const char *filename,
xmlSecKeyDataFormat format);
int xmlSecGnuTLSAppKeyCertLoadMemory
(xmlSecKeyPtr key,
const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format);
void* xmlSecGnuTLSAppGetDefaultPwdCallback
(void);
Details
xmlSecGnuTLSAppInit ()
int xmlSecGnuTLSAppInit (const char *config);
General crypto engine initialization. This function is used
by XMLSec command line utility and called before
xmlSecInit function.
config: |
the path to GnuTLS configuration (unused). |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppShutdown ()
int xmlSecGnuTLSAppShutdown (void);
General crypto engine shutdown. This function is used
by XMLSec command line utility and called after
xmlSecShutdown function.
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppDefaultKeysMngrInit ()
int xmlSecGnuTLSAppDefaultKeysMngrInit
(xmlSecKeysMngrPtr mngr);
Initializes mngr with simple keys store xmlSecSimpleKeysStoreId
and a default GnuTLS crypto key data stores.
mngr: |
the pointer to keys manager. |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppDefaultKeysMngrSave ()
int xmlSecGnuTLSAppDefaultKeysMngrSave
(xmlSecKeysMngrPtr mngr,
const char *filename,
xmlSecKeyDataType type);
Saves keys from mngr to XML keys file.
mngr: |
the pointer to keys manager. |
filename: |
the destination filename. |
type: |
the type of keys to save (public/private/symmetric). |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppKeysMngrCertLoad ()
int xmlSecGnuTLSAppKeysMngrCertLoad (xmlSecKeysMngrPtr mngr,
const char *filename,
xmlSecKeyDataFormat format,
xmlSecKeyDataType type);
Reads cert from filename and adds to the list of trusted or known
untrusted certs in store (not implemented yet).
mngr: |
the keys manager. |
filename: |
the certificate file. |
format: |
the certificate file format. |
type: |
the flag that indicates is the certificate in filename
trusted or not. |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppKeysMngrCertLoadMemory ()
int xmlSecGnuTLSAppKeysMngrCertLoadMemory
(xmlSecKeysMngrPtr mngr,
const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format,
xmlSecKeyDataType type);
Reads cert from binary buffer data and adds to the list of trusted or known
untrusted certs in store (not implemented yet).
mngr: |
the keys manager. |
data: |
the certificate binary data. |
dataSize: |
the certificate binary data size. |
format: |
the certificate file format. |
type: |
the flag that indicates is the certificate trusted or not. |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppKeyLoad ()
xmlSecKeyPtr xmlSecGnuTLSAppKeyLoad (const char *filename,
xmlSecKeyDataFormat format,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
Reads key from the a file (not implemented yet).
xmlSecGnuTLSAppKeyLoadMemory ()
xmlSecKeyPtr xmlSecGnuTLSAppKeyLoadMemory (const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
Reads key from the memory buffer (not implemented yet).
xmlSecGnuTLSAppPkcs12Load ()
xmlSecKeyPtr xmlSecGnuTLSAppPkcs12Load (const char *filename,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
Reads key and all associated certificates from the PKCS12 file
(not implemented yet).
For uniformity, call xmlSecGnuTLSAppKeyLoad instead of this function. Pass
in format=xmlSecKeyDataFormatPkcs12.
xmlSecGnuTLSAppPkcs12LoadMemory ()
xmlSecKeyPtr xmlSecGnuTLSAppPkcs12LoadMemory
(const xmlSecByte *data,
xmlSecSize dataSize,
const char *pwd,
void *pwdCallback,
void *pwdCallbackCtx);
Reads key and all associated certificates from the PKCS12 data in memory buffer.
For uniformity, call xmlSecGnuTLSAppKeyLoadMemory instead of this function. Pass
in format=xmlSecKeyDataFormatPkcs12 (not implemented yet).
xmlSecGnuTLSAppKeyCertLoad ()
int xmlSecGnuTLSAppKeyCertLoad (xmlSecKeyPtr key,
const char *filename,
xmlSecKeyDataFormat format);
Reads the certificate from $filename and adds it to key
(not implemented yet).
key: |
the pointer to key. |
filename: |
the certificate filename. |
format: |
the certificate file format. |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppKeyCertLoadMemory ()
int xmlSecGnuTLSAppKeyCertLoadMemory
(xmlSecKeyPtr key,
const xmlSecByte *data,
xmlSecSize dataSize,
xmlSecKeyDataFormat format);
Reads the certificate from memory buffer and adds it to key (not implemented yet).
key: |
the pointer to key. |
data: |
the certificate binary data. |
dataSize: |
the certificate binary data size. |
format: |
the certificate file format. |
Returns : |
0 on success or a negative value otherwise. |
xmlSecGnuTLSAppGetDefaultPwdCallback ()
void* xmlSecGnuTLSAppGetDefaultPwdCallback
(void);
Gets default password callback.