3 OCSP_REQUEST_new, OCSP_REQUEST_free, OCSP_request_add0_id, OCSP_request_sign,
4 OCSP_request_add1_cert, OCSP_request_onereq_count,
5 OCSP_request_onereq_get0 - OCSP request functions.
9 #include <openssl/ocsp.h>
11 OCSP_REQUEST *OCSP_REQUEST_new(void);
12 void OCSP_REQUEST_free(OCSP_REQUEST *req);
14 OCSP_ONEREQ *OCSP_request_add0_id(OCSP_REQUEST *req, OCSP_CERTID *cid);
16 int OCSP_request_sign(OCSP_REQUEST *req,
17 X509 *signer, EVP_PKEY *key, const EVP_MD *dgst,
18 STACK_OF(X509) *certs, unsigned long flags);
20 int OCSP_request_add1_cert(OCSP_REQUEST *req, X509 *cert);
22 int OCSP_request_onereq_count(OCSP_REQUEST *req);
23 OCSP_ONEREQ *OCSP_request_onereq_get0(OCSP_REQUEST *req, int i);
27 OCSP_REQUEST_new() allocates and returns an empty B<OCSP_REQUEST> structure.
29 OCSP_REQUEST_free() frees up the request structure B<req>.
31 OCSP_request_add0_id() adds certificate ID B<cid> to B<req>. It returns
32 the B<OCSP_ONEREQ> structure added so an application can add additional
33 extensions to the request. The B<id> parameter B<MUST NOT> be freed up after
36 OCSP_request_sign() signs OCSP request B<req> using certificate
37 B<signer>, private key B<key>, digest B<dgst> and additional certificates
38 B<certs>. If the B<flags> option B<OCSP_NOCERTS> is set then no certificates
39 will be included in the request.
41 OCSP_request_add1_cert() adds certificate B<cert> to request B<req>. The
42 application is responsible for freeing up B<cert> after use.
44 OCSP_request_onereq_count() returns the total number of B<OCSP_ONEREQ>
47 OCSP_request_onereq_get0() returns an internal pointer to the B<OCSP_ONEREQ>
48 contained in B<req> of index B<i>. The index value B<i> runs from 0 to
49 OCSP_request_onereq_count(req) - 1.
53 OCSP_REQUEST_new() returns an empty B<OCSP_REQUEST> structure or B<NULL> if
56 OCSP_request_add0_id() returns the B<OCSP_ONEREQ> structure containing B<cid>
57 or B<NULL> if an error occurred.
59 OCSP_request_sign() and OCSP_request_add1_cert() return 1 for success and 0
62 OCSP_request_onereq_count() returns the total number of B<OCSP_ONEREQ>
65 OCSP_request_onereq_get0() returns a pointer to an B<OCSP_ONEREQ> structure
66 or B<NULL> if the index value is out or range.
70 An OCSP request structure contains one or more B<OCSP_ONEREQ> structures
71 corresponding to each certificate.
73 OCSP_request_onereq_count() and OCSP_request_onereq_get0() are mainly used by
78 Create an B<OCSP_REQUEST> structure for certificate B<cert> with issuer
84 req = OCSP_REQUEST_new();
87 cid = OCSP_cert_to_id(EVP_sha1(), cert, issuer);
91 if (OCSP_REQUEST_add0_id(req, cid) == NULL)
94 /* Do something with req, e.g. query responder */
96 OCSP_REQUEST_free(req);
101 L<OCSP_cert_to_id(3)>,
102 L<OCSP_request_add1_nonce(3)>,
103 L<OCSP_response_find_status(3)>,
104 L<OCSP_response_status(3)>,
105 L<OCSP_sendreq_new(3)>