diff --git a/doc/crypto/CMS_sign_receipt.pod b/doc/crypto/CMS_sign_receipt.pod new file mode 100644 index 0000000000000000000000000000000000000000..f603ab66f0154edb51547a6a8e0dd00fd66169e8 --- /dev/null +++ b/doc/crypto/CMS_sign_receipt.pod @@ -0,0 +1,45 @@ +=pod + +=head1 NAME + +CMS_sign_receipt - create a CMS signed receipt + +=head1 SYNOPSIS + + #include + + CMS_ContentInfo *CMS_sign_receipt(CMS_SignerInfo *si, X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs, unsigned int flags); + +=head1 DESCRIPTION + +CMS_sign_receipt() creates and returns a CMS signed receipt structure. B is +the B structure containing the signed receipt request. +B is the certificate to sign with, B is the corresponding +private key. B is an optional additional set of certificates to include +in the CMS structure (for example any intermediate CAs in the chain). + +B is an optional set of flags. + +=head1 NOTES + +This functions behaves in a similar way to CMS_sign() except the flag values +B, B, B, B and B +are not supported since they do not make sense in the context of signed +receipts. + +=head1 RETURN VALUES + +CMS_sign_receipt() returns either a valid CMS_ContentInfo structure or NULL if +an error occurred. The error can be obtained from ERR_get_error(3). + +=head1 SEE ALSO + +L, +L, +L + +=head1 HISTORY + +CMS_sign_receipt() was added to OpenSSL 0.9.8 + +=cut diff --git a/doc/crypto/CMS_verify_receipt.pod b/doc/crypto/CMS_verify_receipt.pod new file mode 100644 index 0000000000000000000000000000000000000000..d90f161bcf48b1cab31b2db226470bbb0de1aaa5 --- /dev/null +++ b/doc/crypto/CMS_verify_receipt.pod @@ -0,0 +1,47 @@ +=pod + +=head1 NAME + +CMS_verify - verify a CMS signed receipt + +=head1 SYNOPSIS + + #include + + int CMS_verify_receipt(CMS_ContentInfo *rcms, CMS_ContentInfo *ocms, STACK_OF(X509) *certs, X509_STORE *store, unsigned int flags); + +=head1 DESCRIPTION + +CMS_verify_receipt() verifies a CMS signed receipt. B is the signed +receipt to verify. B is the original SignedData structure containing the +receipt request B is a set of certificates in which to search for the +signer's certificate. B is a trusted certificate store (used for chain +verification). + +B is an optional set of flags, which can be used to modify the verify +operation. + +=head1 NOTES + +This functions behaves in a similar way to CMS_verify() except the flag values +B, B, B and B are not +supported since they do not make sense in the context of signed receipts. + +=head1 RETURN VALUES + +CMS_verify_receipt() returns 1 for a successful verification and zero if an +error occurred. + +The error can be obtained from L + +=head1 SEE ALSO + +L, +L, +L, + +=head1 HISTORY + +CMS_verify() was added to OpenSSL 0.9.8 + +=cut