=pod =head1 NAME OCSP_REQUEST_new, OCSP_REQUEST_free, OCSP_request_add0_id, OCSP_request_sign, OCSP_request_add1_cert, OCSP_request_onereq_count, OCSP_request_onereq_get0 - OCSP request functions =head1 SYNOPSIS #include OCSP_REQUEST *OCSP_REQUEST_new(void); void OCSP_REQUEST_free(OCSP_REQUEST *req); OCSP_ONEREQ *OCSP_request_add0_id(OCSP_REQUEST *req, OCSP_CERTID *cid); int OCSP_request_sign(OCSP_REQUEST *req, X509 *signer, EVP_PKEY *key, const EVP_MD *dgst, STACK_OF(X509) *certs, unsigned long flags); int OCSP_request_add1_cert(OCSP_REQUEST *req, X509 *cert); int OCSP_request_onereq_count(OCSP_REQUEST *req); OCSP_ONEREQ *OCSP_request_onereq_get0(OCSP_REQUEST *req, int i); =head1 DESCRIPTION OCSP_REQUEST_new() allocates and returns an empty B structure. OCSP_REQUEST_free() frees up the request structure B. OCSP_request_add0_id() adds certificate ID B to B. It returns the B structure added so an application can add additional extensions to the request. The B parameter B be freed up after the operation. OCSP_request_sign() signs OCSP request B using certificate B, private key B, digest B and additional certificates B. If the B option B is set then no certificates will be included in the request. OCSP_request_add1_cert() adds certificate B to request B. The application is responsible for freeing up B after use. OCSP_request_onereq_count() returns the total number of B structures in B. OCSP_request_onereq_get0() returns an internal pointer to the B contained in B of index B. The index value B runs from 0 to OCSP_request_onereq_count(req) - 1. =head1 RETURN VALUES OCSP_REQUEST_new() returns an empty B structure or B if an error occurred. OCSP_request_add0_id() returns the B structure containing B or B if an error occurred. OCSP_request_sign() and OCSP_request_add1_cert() return 1 for success and 0 for failure. OCSP_request_onereq_count() returns the total number of B structures in B. OCSP_request_onereq_get0() returns a pointer to an B structure or B if the index value is out or range. =head1 NOTES An OCSP request structure contains one or more B structures corresponding to each certificate. OCSP_request_onereq_count() and OCSP_request_onereq_get0() are mainly used by OCSP responders. =head1 EXAMPLE Create an B structure for certificate B with issuer B: OCSP_REQUEST *req; OCSP_ID *cid; req = OCSP_REQUEST_new(); if (req == NULL) /* error */ cid = OCSP_cert_to_id(EVP_sha1(), cert, issuer); if (cid == NULL) /* error */ if (OCSP_REQUEST_add0_id(req, cid) == NULL) /* error */ /* Do something with req, e.g. query responder */ OCSP_REQUEST_free(req); =head1 SEE ALSO L, L, L, L, L, L =head1 COPYRIGHT Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. Licensed under the OpenSSL license (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at L. =cut