You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.



NSS 3.3 Public Functions

Newsgroup: mozilla.dev.tech.crypto

This page lists all exported functions in NSS 3.3.

SSL Functions
Deprecated SSL Functions
Certificate Functions
Crypto Functions
Utility Functions
S/MIME Functions
PKCS #7 Functions
PKCS #12 Functions

SSL Functions

The public functions listed here are used to configure sockets for communication via the SSL and TLS protocols. In addition to the functions listed here, applications that support SSL use some Certificate Functions, Crypto Functions, and Utility Functions,

Other sources of information:

If documentation is available for a function listed below, the function name is linked to its entry in the SSL Reference. The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
NSS_GetClientAuthData LXR Summary
NSS_SetDomesticPolicy LXR Summary
NSS_SetExportPolicy LXR Summary
SSL_AuthCertificate LXR Summary
SSL_AuthCertificateHook LXR Summary
SSL_BadCertHook LXR Summary
SSL_CertDBHandleSet LXR Summary
SSL_CipherPolicyGet LXR Summary
SSL_CipherPolicySet LXR Summary
SSL_CipherPrefGet LXR Summary
SSL_CipherPrefGetDefault LXR Summary
SSL_CipherPrefSet LXR Summary
SSL_CipherPrefSetDefault LXR Summary
SSL_ClearSessionCache LXR Summary
SSL_ConfigMPServerSIDCache LXR Summary
SSL_ConfigSecureServer LXR Summary
SSL_ConfigServerSessionIDCache LXR Summary
SSL_DataPending LXR Summary
SSL_ForceHandshake LXR Summary
SSL_GetClientAuthDataHook LXR Summary
SSL_GetSessionID LXR Summary
SSL_GetStatistics LXR Summary
SSL_HandshakeCallback LXR Summary
SSL_ImportFD LXR Summary
SSL_InheritMPServerSIDCache LXR Summary
SSL_InvalidateSession LXR Summary
SSL_OptionGet LXR Summary
SSL_OptionGetDefault LXR Summary
SSL_OptionSet LXR Summary
SSL_OptionSetDefault LXR Summary
SSL_PeerCertificate LXR Summary
SSL_PreencryptedFileToStream LXR Summary
SSL_PreencryptedStreamToFile LXR Summary
SSL_ReHandshake LXR Summary
SSL_ResetHandshake LXR Summary
SSL_RestartHandshakeAfterCertReq LXR Summary
SSL_RestartHandshakeAfterServerCert LXR Summary
SSL_RevealCert LXR Summary
SSL_RevealPinArg LXR Summary
SSL_RevealURL LXR Summary
SSL_SecurityStatus LXR Summary
SSL_SetPKCS11PinArg LXR Summary
SSL_SetSockPeerID LXR Summary
SSL_SetURL LXR Summary

Deprecated SSL Functions

The following SSL functions have been replaced with newer versions. The deprecated functions are not supported by the new SSL shared libraries. Applications that want to use the SSL shared libraries must convert to calling the new replacement functions listed below.

Each function name is linked to its entry in the SSL Reference. The LXR summary for each deprecated function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition Replacement in NSS 3.3
SSL_Enable LXR Summary SSL_OptionSet
SSL_EnableCipher LXR Summary SSL_CipherPrefSetDefault
SSL_EnableDefault LXR Summary SSL_OptionSetDefault
SSL_RedoHandshake LXR Summary SSL_ReHandshake
SSL_SetPolicy LXR Summary SSL_CipherPolicySet

Certificate Functions

The public functions listed here are used to manipulate certificate databases.

If documentation is available for a function listed below, the function name is linked to its entry in the SSL Reference. The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
CERT_AsciiToName LXR Summary
CERT_CertTimesValid LXR Summary
CERT_ChangeCertTrust LXR Summary
CERT_CheckCertUsage LXR_Summary
CERT_CheckCertValidTimes LXR Summary
CERT_CreateCertificateRequest LXR Summary
CERT_DecodeDERCrl LXR Summary
CERT_DestroyCertificate LXR Summary
CERT_DestroyCertificateRequest LXR Summary
CERT_DestroyCertList LXR Summary
CERT_DestroyName LXR Summary
CERT_DupCertificate LXR Summary
CERT_EnableOCSPChecking LXR Summary
CERT_FindCertIssuer LXR Summary
CERT_FormatName LXR Summary
CERT_FreeDistNames LXR Summary
CERT_FreeNicknames LXR Summary
CERT_GetAVATag LXR Summary
CERT_GetCertEmailAddress LXR Summary
CERT_GetCertIssuerAndSN LXR Summary
CERT_GetCertNicknames LXR Summary
CERT_GetCertTrust LXR Summary
CERT_GetCertUid LXR Summary
CERT_GetCommonName LXR Summary
CERT_GetCountryName LXR Summary
CERT_GetDBContentVersion LXR Summary
CERT_GetDefaultCertDB LXR Summary
CERT_GetDomainComponentName LXR Summary
CERT_GetLocalityName LXR Summary
CERT_GetOrgName LXR Summary
CERT_GetOrgUnitName LXR Summary
CERT_GetSlopTime LXR Summary
CERT_GetSSLCACerts LXR Summary
CERT_GetStateName LXR Summary
CERT_ImportCAChain LXR Summary
CERT_NameToAscii LXR Summary
CERT_RFC1485_EscapeAndQuote LXR Summary
CERT_SetSlopTime LXR Summary
CERT_VerifyCertName LXR Summary
CERT_VerifyCertNow LXR Summary
NSS_CmpCertChainWCANames LXR Summary
NSS_FindCertKEAType LXR Summary

Crypto Functions

The public functions listed here perform cryptographic operations via the PKCS #11 interface.

If documentation is available for a function listed below, the function name is linked to its entry in the SSL Reference. The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
PK11_Authenticate LXR Summary
PK11_ChangePW LXR Summary
PK11_CheckUserPassword LXR Summary
PK11_CipherOp LXR Summary
PK11_CloneContext LXR Summary
PK11_ConfigurePKCS11 LXR Summary
PK11_CreateContextBySymKey LXR Summary
PK11_CreateDigestContext LXR Summary
PK11_DestroyContext LXR Summary
PK11_DestroyTokenObject LXR Summary
PK11_DigestBegin LXR Summary
PK11_DigestOp LXR Summary
PK11_DigestFinal LXR Summary
PK11_DoesMechanism LXR Summary
PK11_Finalize LXR Summary
PK11_FindCertByIssuerAndSN LXR Summary
PK11_FindCertFromDERCert LXR Summary
PK11_FindCertFromNickname LXR Summary
PK11_FindKeyByAnyCert LXR Summary
PK11_FindKeyByDERCert LXR Summary
PK11_FindSlotByName LXR Summary
PK11_FortezzaHasKEA LXR Summary
PK11_FreeSlot LXR Summary
PK11_FreeSlotList LXR Summary
PK11_FreeSymKey LXR Summary
PK11_GenerateKeyPair LXR Summary
PK11_GenerateNewParam LXR Summary
PK11_GenerateRandom LXR Summary
PK11_GetAllTokens LXR Summary
PK11_GetBlockSize LXR Summary
PK11_GetFirstSafe LXR Summary
PK11_GetInternalKeySlot LXR Summary
PK11_GetInternalSlot LXR Summary
PK11_GetModule LXR Summary
PK11_GetSlotName LXR Summary
PK11_GetTokenName LXR Summary
PK11_HashBuf LXR Summary
PK11_IsFIPS LXR Summary
PK11_IsFriendly LXR Summary
PK11_IsHW LXR Summary
PK11_IsInternal LXR Summary
PK11_IsPresent LXR Summary
PK11_IsReadOnly LXR Summary
PK11_KeyGen LXR Summary
PK11_ListCerts LXR Summary
PK11_NeedLogin LXR Summary
PK11_RandomUpdate LXR Summary
PK11_SetPasswordFunc LXR Summary
PK11_SetSlotPWValues LXR Summary
SEC_DeletePermCertificate LXR Summary
SEC_DeletePermCRL LXR Summary
SEC_DerSignData LXR Summary
SEC_DestroyCrl LXR Summary
SEC_FindCrlByDERCert LXR Summary
SEC_FindCrlByName LXR Summary
SEC_LookupCrls LXR Summary
SEC_NewCrl LXR Summary
SECKEY_ConvertToPublicKey LXR Summary
SECKEY_CopyPrivateKey LXR Summary
SECKEY_CreateDHPrivateKey LXR Summary
SECKEY_CreateSubjectPublicKeyInfo LXR Summary
SECKEY_DestroyPrivateKey LXR Summary
SECKEY_DestroySubjectPublicKeyInfo LXR Summary
SECKEY_GetPublicKeyType LXR Summary
SECMOD_AddNewModule LXR Summary
SECMOD_IsModulePresent LXR Summary

Utility Functions

The public functions listed here perform initialization tasks and other services.

If documentation is available for a function listed below, the function name is linked to its entry in the SSL Reference. The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
ATOB_AsciiToData LXR Summary
BTOA_ConvertItemToAscii LXR Summary
BTOA_DataToAscii LXR Summary
DER_GeneralizedTimeToTime LXR Summary
DER_UTCDayToAscii LXR Summary
DER_UTCTimeToAscii LXR Summary
NSS_Init LXR Summary
NSS_Initialize LXR Summary
NSS_InitReadWrite LXR Summary
NSS_NoDBInit LXR Summary
NSS_Shutdown LXR Summary
NSS_VersionCheck LXR Summary
PORT_Alloc LXR Summary
PORT_Free LXR Summary
PORT_GetError LXR Summary
PORT_SetError LXR Summary
PORT_SetUCS2_ASCIIConversionFunction LXR Summary
PORT_SetUCS2_UTF8ConversionFunction LXR Summary
PORT_SetUCS4_UTF8ConversionFunction LXR Summary
SECITEM_CopyItem LXR Summary
SECITEM_DupItem LXR Summary
SECITEM_FreeItem LXR Summary
SECITEM_ZfreeItem LXR Summary
SECOID_FindOIDTagDescription LXR Summary
SECOID_GetAlgorithmTag LXR Summary

S/MIME Functions

The public functions listed here perform S/MIME operations using the S/MIME Toolkit.

The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
NSS_CMSContentInfo_GetBulkKey LXR Summary
NSS_CMSContentInfo_GetBulkKeySize LXR Summary
NSS_CMSContentInfo_GetContent LXR Summary
NSS_CMSContentInfo_GetContentEncAlgTag LXR Summary
NSS_CMSContentInfo_GetContentTypeTag LXR Summary
NSS_CMSContentInfo_SetBulkKey LXR Summary
NSS_CMSContentInfo_SetContent LXR Summary
NSS_CMSContentInfo_SetContent_Data LXR Summary
NSS_CMSContentInfo_SetContentEncAlg LXR Summary
NSS_CMSContentInfo_SetContent_DigestedData LXR Summary
NSS_CMSContentInfo_SetContent_EncryptedData LXR Summary
NSS_CMSContentInfo_SetContent_EnvelopedData LXR Summary
NSS_CMSContentInfo_SetContent_SignedData LXR Summary
NSS_CMSDecoder_Cancel LXR Summary
NSS_CMSDecoder_Finish LXR Summary
NSS_CMSDecoder_Start LXR Summary
NSS_CMSDecoder_Update LXR Summary
NSS_CMSDigestContext_Cancel LXR Summary
NSS_CMSDigestContext_FinishMultiple LXR Summary
NSS_CMSDigestContext_FinishSingle LXR Summary
NSS_CMSDigestContext_StartMultiple LXR Summary
NSS_CMSDigestContext_StartSingle LXR Summary
NSS_CMSDigestContext_Update LXR Summary
NSS_CMSDigestedData_Create LXR Summary
NSS_CMSDigestedData_Destroy LXR Summary
NSS_CMSDigestedData_GetContentInfo LXR Summary
NSS_CMSDEREncode LXR Summary
NSS_CMSEncoder_Cancel LXR Summary
NSS_CMSEncoder_Finish LXR Summary
NSS_CMSEncoder_Start LXR Summary
NSS_CMSEncoder_Update LXR Summary
NSS_CMSEncryptedData_Create LXR Summary
NSS_CMSEncryptedData_Destroy LXR Summary
NSS_CMSEncryptedData_GetContentInfo LXR Summary
NSS_CMSEnvelopedData_AddRecipient LXR Summary
NSS_CMSEnvelopedData_Create LXR Summary
NSS_CMSEnvelopedData_Destroy LXR Summary
NSS_CMSEnvelopedData_GetContentInfo LXR Summary
NSS_CMSMessage_ContentLevel LXR Summary
NSS_CMSMessage_ContentLevelCount LXR Summary
NSS_CMSMessage_Copy LXR Summary
NSS_CMSMessage_Create LXR Summary
NSS_CMSMessage_CreateFromDER LXR Summary
NSS_CMSMessage_Destroy LXR Summary
NSS_CMSMessage_GetContent LXR Summary
NSS_CMSMessage_GetContentInfo LXR Summary
NSS_CMSRecipientInfo_Create LXR Summary
NSS_CMSRecipientInfo_Destroy LXR Summary
NSS_CMSSignedData_AddCertChain LXR Summary
NSS_CMSSignedData_AddCertList LXR Summary
NSS_CMSSignedData_AddCertificate LXR Summary
NSS_CMSSignedData_AddDigest LXR Summary
NSS_CMSSignedData_AddSignerInfo LXR Summary
NSS_CMSSignedData_Create LXR Summary
NSS_CMSSignedData_CreateCertsOnly LXR Summary
NSS_CMSSignedData_Destroy LXR Summary
NSS_CMSSignedData_GetContentInfo LXR Summary
NSS_CMSSignedData_GetDigestAlgs LXR Summary
NSS_CMSSignedData_GetSignerInfo LXR Summary
NSS_CMSSignedData_HasDigests LXR Summary
NSS_CMSSignedData_ImportCerts LXR Summary
NSS_CMSSignedData_SetDigests LXR Summary
NSS_CMSSignedData_SignerInfoCount LXR Summary
NSS_CMSSignedData_VerifyCertsOnly LXR Summary
NSS_CMSSignedData_VerifySignerInfo LXR Summary
NSS_CMSSignerInfo_AddSMIMECaps LXR Summary
NSS_CMSSignerInfo_AddSMIMEEncKeyPrefs LXR Summary
NSS_CMSSignerInfo_AddSigningTime LXR Summary
NSS_CMSSignerInfo_Create LXR Summary
NSS_CMSSignerInfo_Destroy LXR Summary
NSS_CMSSignerInfo_GetCertList LXR Summary
NSS_CMSSignerInfo_GetSignerCommonName LXR Summary
NSS_CMSSignerInfo_GetSignerEmailAddress LXR Summary
NSS_CMSSignerInfo_GetSigningCertificate LXR Summary
NSS_CMSSignerInfo_GetSigningTime LXR Summary
NSS_CMSSignerInfo_GetVerificationStatus LXR Summary
NSS_CMSSignerInfo_GetVersion LXR Summary
NSS_CMSSignerInfo_IncludeCerts LXR Summary
NSS_CMSUtil_VerificationStatusToString LXR Summary
NSS_SMIMEUtil_FindBulkAlgForRecipients LXR Summary

PKCS #7 Functions

The public functions listed here perform PKCS #7 operations required by mail and news applications and by some of the NSS tools.

The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
CERT_DecodeCertPackage LXR Summary
SEC_PKCS7AddRecipient LXR Summary
SEC_PKCS7AddSigningTime LXR Summary
SEC_PKCS7ContentType LXR Summary
SEC_PKCS7CreateData LXR Summary
SEC_PKCS7CreateEncryptedData LXR Summary
SEC_PKCS7CreateEnvelopedDat LXR Summary
SEC_PKCS7CreateSignedData LXR Summary
SEC_PKCS7DecodeItem LXR Summary
SEC_PKCS7DecoderFinish LXR Summary
SEC_PKCS7DecoderStart LXR Summary
SEC_PKCS7DecoderUpdate LXR Summary
SEC_PKCS7DecryptContents LXR Summary
SEC_PKCS7DestroyContentInfo LXR Summary
SEC_PKCS7EncoderFinish LXR Summary
SEC_PKCS7EncoderStart LXR Summary
SEC_PKCS7EncoderUpdate LXR Summary
SEC_PKCS7GetCertificateList LXR Summary
SEC_PKCS7GetContent LXR Summary
SEC_PKCS7GetEncryptionAlgorithm LXR Summary
SEC_PKCS7IncludeCertChain LXR Summary
SEC_PKCS7IsContentEmpty LXR Summary
SEC_PKCS7VerifySignature LXR Summary

PKCS #12 Functions

The public functions listed here perform PKCS #12 operations required by some of the NSS tools and other applications.

The LXR summary for each function provides links to the function definition, prototype definition, and source code references.
Function name/documentation Function prototype/definition
SEC_PKCS12AddCertAndKey LXR Summary
SEC_PKCS12AddPasswordIntegrity LXR Summary
SEC_PKCS12CreateExportContext LXR Summary
SEC_PKCS12CreatePasswordPrivSafe LXR Summary
SEC_PKCS12CreateUnencryptedSafe LXR Summary
SEC_PKCS12DecoderFinish LXR Summary
SEC_PKCS12DecoderImportBags LXR Summary
SEC_PKCS12DecoderStart LXR Summary
SEC_PKCS12DecoderUpdate LXR Summary
SEC_PKCS12DecoderValidateBags LXR Summary
SEC_PKCS12DecoderVerify LXR Summary
SEC_PKCS12DestroyExportContext LXR Summary
SEC_PKCS12EnableCipher LXR Summary
SEC_PKCS12Encode LXR Summary
SEC_PKCS12IsEncryptionAllowed LXR Summary
SEC_PKCS12SetPreferredCipher LXR Summary