1207753Smm=pod
2207753Smm
3207753Smm=head1 NAME
4207753Smm
5207753Smm CMS_sign_receipt - create a CMS signed receipt
6207753Smm
7207753Smm=head1 SYNOPSIS
8207753Smm
9207753Smm #include <openssl/cms.h>
10207753Smm
11207753Smm CMS_ContentInfo *CMS_sign_receipt(CMS_SignerInfo *si, X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs, unsigned int flags);
12207753Smm
13207753Smm=head1 DESCRIPTION
14207753Smm
15207753SmmCMS_sign_receipt() creates and returns a CMS signed receipt structure. B<si> is
16207753Smmthe B<CMS_SignerInfo> structure containing the signed receipt request.
17207753SmmB<signcert> is the certificate to sign with, B<pkey> is the corresponding
18207753Smmprivate key.  B<certs> is an optional additional set of certificates to include
19207753Smmin the CMS structure (for example any intermediate CAs in the chain).
20207753Smm
21207753SmmB<flags> is an optional set of flags.
22207753Smm
23207753Smm=head1 NOTES
24207753Smm
25207753SmmThis functions behaves in a similar way to CMS_sign() except the flag values
26207753SmmB<CMS_DETACHED>, B<CMS_BINARY>, B<CMS_NOATTR>, B<CMS_TEXT> and B<CMS_STREAM>
27207753Smmare not supported since they do not make sense in the context of signed
28207753Smmreceipts.
29207753Smm
30207753Smm=head1 RETURN VALUES
31207753Smm
32207753SmmCMS_sign_receipt() returns either a valid CMS_ContentInfo structure or NULL if
33207753Smman error occurred.  The error can be obtained from ERR_get_error(3).
34207753Smm
35207753Smm=head1 SEE ALSO
36207753Smm
37207753SmmL<ERR_get_error(3)|ERR_get_error(3)>,
38207753SmmL<CMS_verify_receipt(3)|CMS_verify_receipt(3)>,
39207753SmmL<CMS_sign(3)|CMS_sign(3)>
40207753Smm
41207753Smm=head1 HISTORY
42207753Smm
43207753SmmCMS_sign_receipt() was added to OpenSSL 0.9.8
44207753Smm
45207753Smm=cut
46207753Smm