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)>
111 Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved.
113 Licensed under the OpenSSL license (the "License"). You may not use
114 this file except in compliance with the License. You can obtain a copy
115 in the file LICENSE in the source distribution or at
116 L<https://www.openssl.org/source/license.html>.