|   | | 
|  |  |  | XML Security Library Reference Manual |  | 
 
app
Nameapp -- Application functions implementation for NSS. 
Synopsisint                 xmlSecNssAppInit                    (const char *config);
int                 xmlSecNssAppShutdown                (void);
int                 xmlSecNssAppDefaultKeysMngrInit     (xmlSecKeysMngrPtr mngr);
int                 xmlSecNssAppDefaultKeysMngrAdoptKey (xmlSecKeysMngrPtr mngr,
                                                         xmlSecKeyPtr key);
int                 xmlSecNssAppDefaultKeysMngrLoad     (xmlSecKeysMngrPtr mngr,
                                                         const char *uri);
int                 xmlSecNssAppDefaultKeysMngrSave     (xmlSecKeysMngrPtr mngr,
                                                         const char *filename,
                                                         xmlSecKeyDataType type);
int                 xmlSecNssAppKeysMngrCertLoad        (xmlSecKeysMngrPtr mngr,
                                                         const char *filename,
                                                         xmlSecKeyDataFormat format,
                                                         xmlSecKeyDataType type);
int                 xmlSecNssAppKeysMngrCertLoadMemory  (xmlSecKeysMngrPtr mngr,
                                                         const xmlSecByte *data,
                                                         xmlSecSize dataSize,
                                                         xmlSecKeyDataFormat format,
                                                         xmlSecKeyDataType type);
int                 xmlSecNssAppKeysMngrCertLoadSECItem (xmlSecKeysMngrPtr mngr,
                                                         SECItem *secItem,
                                                         xmlSecKeyDataFormat format,
                                                         xmlSecKeyDataType type);
xmlSecKeyPtr        xmlSecNssAppKeyLoad                 (const char *filename,
                                                         xmlSecKeyDataFormat format,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
xmlSecKeyPtr        xmlSecNssAppKeyLoadMemory           (const xmlSecByte *data,
                                                         xmlSecSize dataSize,
                                                         xmlSecKeyDataFormat format,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
xmlSecKeyPtr        xmlSecNssAppKeyLoadSECItem          (SECItem *secItem,
                                                         xmlSecKeyDataFormat format,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
xmlSecKeyPtr        xmlSecNssAppPkcs12Load              (const char *filename,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
xmlSecKeyPtr        xmlSecNssAppPkcs12LoadMemory        (const xmlSecByte *data,
                                                         xmlSecSize dataSize,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
xmlSecKeyPtr        xmlSecNssAppPkcs12LoadSECItem       (SECItem *secItem,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);
int                 xmlSecNssAppKeyCertLoad             (xmlSecKeyPtr key,
                                                         const char *filename,
                                                         xmlSecKeyDataFormat format);
int                 xmlSecNssAppKeyCertLoadMemory       (xmlSecKeyPtr key,
                                                         const xmlSecByte *data,
                                                         xmlSecSize dataSize,
                                                         xmlSecKeyDataFormat format);
int                 xmlSecNssAppKeyCertLoadSECItem      (xmlSecKeyPtr key,
                                                         SECItem *secItem,
                                                         xmlSecKeyDataFormat format);
xmlSecKeyPtr        xmlSecNssAppKeyFromCertLoadSECItem  (SECItem *secItem,
                                                         xmlSecKeyDataFormat format);
void*               xmlSecNssAppGetDefaultPwdCallback   (void); 
DescriptionApplication functions implementation for NSS. 
Details
xmlSecNssAppInit ()int                 xmlSecNssAppInit                    (const char *config); General crypto engine initialization. This function is used
by XMLSec command line utility and called before
xmlSecInitfunction. 
| config: |              the path to NSS database files. |  
| Returns : |  0 on success or a negative value otherwise. |  
 
xmlSecNssAppShutdown ()int                 xmlSecNssAppShutdown                (void); General crypto engine shutdown. This function is used
by XMLSec command line utility and called after
xmlSecShutdownfunction. 
| Returns : |  0 on success or a negative value otherwise. | 
 
 
xmlSecNssAppDefaultKeysMngrInit ()int                 xmlSecNssAppDefaultKeysMngrInit     (xmlSecKeysMngrPtr mngr); Initializes mngrwith NSS keys store xmlSecNssKeysStoreId
and a default NSS crypto key data stores. 
| mngr: |                the pointer to keys manager. |  
| Returns : |  0 on success or a negative value otherwise. |  
 
 
 
xmlSecNssAppDefaultKeysMngrSave ()int                 xmlSecNssAppDefaultKeysMngrSave     (xmlSecKeysMngrPtr mngr,
                                                         const char *filename,
                                                         xmlSecKeyDataType type);Saves keys from mngrto  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. |  
 
xmlSecNssAppKeysMngrCertLoad ()int                 xmlSecNssAppKeysMngrCertLoad        (xmlSecKeysMngrPtr mngr,
                                                         const char *filename,
                                                         xmlSecKeyDataFormat format,
                                                         xmlSecKeyDataType type);Reads cert from filenameand adds to the list of trusted or known
untrusted certs instore 
| mngr: |                the pointer to keys manager. |  
| filename: |            the certificate file. |  
| format: |              the certificate file format (PEM or DER). |  
| type: |                the certificate type (trusted/untrusted). |  
| Returns : |  0 on success or a negative value otherwise. |  
 
 
xmlSecNssAppKeysMngrCertLoadSECItem ()int                 xmlSecNssAppKeysMngrCertLoadSECItem (xmlSecKeysMngrPtr mngr,
                                                         SECItem *secItem,
                                                         xmlSecKeyDataFormat format,
                                                         xmlSecKeyDataType type);Reads cert from secItemand adds to the list of trusted or known
untrusted certs instore 
| mngr: |                the pointer to keys manager. |  
| secItem: |             the pointer to SECItem. |  
| format: |              the certificate format (PEM or DER). |  
| type: |                the certificate type (trusted/untrusted). |  
| Returns : |  0 on success or a negative value otherwise. |  
 
xmlSecNssAppKeyLoad ()xmlSecKeyPtr        xmlSecNssAppKeyLoad                 (const char *filename,
                                                         xmlSecKeyDataFormat format,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);Reads key from a file 
 
 
xmlSecNssAppKeyLoadSECItem ()xmlSecKeyPtr        xmlSecNssAppKeyLoadSECItem          (SECItem *secItem,
                                                         xmlSecKeyDataFormat format,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);Reads key from a file 
 
xmlSecNssAppPkcs12Load ()xmlSecKeyPtr        xmlSecNssAppPkcs12Load              (const char *filename,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);Reads key and all associated certificates from the PKCS12 file.
For uniformity, call xmlSecNssAppKeyLoad instead of this function. Pass
in format=xmlSecKeyDataFormatPkcs12. 
 
xmlSecNssAppPkcs12LoadMemory ()xmlSecKeyPtr        xmlSecNssAppPkcs12LoadMemory        (const xmlSecByte *data,
                                                         xmlSecSize dataSize,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);Reads key and all associated certificates from the PKCS12 binary data.
For uniformity, call xmlSecNssAppKeyLoad instead of this function. Pass
in format=xmlSecKeyDataFormatPkcs12. 
 
xmlSecNssAppPkcs12LoadSECItem ()xmlSecKeyPtr        xmlSecNssAppPkcs12LoadSECItem       (SECItem *secItem,
                                                         const char *pwd,
                                                         void *pwdCallback,
                                                         void *pwdCallbackCtx);Reads key and all associated certificates from the PKCS12 SECItem.
For uniformity, call xmlSecNssAppKeyLoad instead of this function. Pass
in format=xmlSecKeyDataFormatPkcs12. 
 
xmlSecNssAppKeyCertLoad ()int                 xmlSecNssAppKeyCertLoad             (xmlSecKeyPtr key,
                                                         const char *filename,
                                                         xmlSecKeyDataFormat format);Reads the certificate from $filenameand adds it to key 
 
 
xmlSecNssAppKeyCertLoadSECItem ()int                 xmlSecNssAppKeyCertLoadSECItem      (xmlSecKeyPtr key,
                                                         SECItem *secItem,
                                                         xmlSecKeyDataFormat format);Reads the certificate from secItemand adds it to key 
 
xmlSecNssAppKeyFromCertLoadSECItem ()xmlSecKeyPtr        xmlSecNssAppKeyFromCertLoadSECItem  (SECItem *secItem,
                                                         xmlSecKeyDataFormat format);Loads public key from cert. 
 
xmlSecNssAppGetDefaultPwdCallback ()void*               xmlSecNssAppGetDefaultPwdCallback   (void); Gets default password callback. | 
 |