CMS_verify_receipt.pod 1.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. =pod
  2. =head1 NAME
  3. CMS_verify_receipt - verify a CMS signed receipt
  4. =head1 SYNOPSIS
  5. #include <openssl/cms.h>
  6. int CMS_verify_receipt(CMS_ContentInfo *rcms, CMS_ContentInfo *ocms, STACK_OF(X509) *certs, X509_STORE *store, unsigned int flags);
  7. =head1 DESCRIPTION
  8. CMS_verify_receipt() verifies a CMS signed receipt. B<rcms> is the signed
  9. receipt to verify. B<ocms> is the original SignedData structure containing the
  10. receipt request. B<certs> is a set of certificates in which to search for the
  11. signing certificate. B<store> is a trusted certificate store (used for chain
  12. verification).
  13. B<flags> is an optional set of flags, which can be used to modify the verify
  14. operation.
  15. =head1 NOTES
  16. This functions behaves in a similar way to CMS_verify() except the flag values
  17. B<CMS_DETACHED>, B<CMS_BINARY>, B<CMS_TEXT> and B<CMS_STREAM> are not
  18. supported since they do not make sense in the context of signed receipts.
  19. =head1 RETURN VALUES
  20. CMS_verify_receipt() returns 1 for a successful verification and zero if an
  21. error occurred.
  22. The error can be obtained from L<ERR_get_error(3)|ERR_get_error(3)>
  23. =head1 SEE ALSO
  24. L<ERR_get_error(3)|ERR_get_error(3)>,
  25. L<CMS_sign_receipt(3)|CMS_sign_receipt(3)>,
  26. L<CMS_verify(3)|CMS_verify(3)>,
  27. =head1 HISTORY
  28. CMS_verify_receipt() was added to OpenSSL 0.9.8
  29. =cut