X-Git-Url: https://git.openssl.org/?a=blobdiff_plain;f=doc%2Fcrypto%2FPKCS7_verify.pod;h=3a5300ad79967b46255cca6ccf6648e67a1a00a5;hb=0daccd4dc1f1ac62181738a91714f35472e50f3c;hp=f5200a23ecf253355ac2ef87bebdc6ab373170b8;hpb=7e9db7cefcf6ea09aeda4a0395a291412a6966da;p=openssl.git diff --git a/doc/crypto/PKCS7_verify.pod b/doc/crypto/PKCS7_verify.pod index f5200a23ec..3a5300ad79 100644 --- a/doc/crypto/PKCS7_verify.pod +++ b/doc/crypto/PKCS7_verify.pod @@ -2,19 +2,21 @@ =head1 NAME -PKCS7_verify - verify a PKCS#7 signedData structure +PKCS7_verify, PKCS7_get0_signers - verify a PKCS#7 signedData structure =head1 SYNOPSIS -int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store, BIO *indata, BIO *out, int flags); + #include -int PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs, int flags); + int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store, BIO *indata, BIO *out, int flags); + + STACK_OF(X509) *PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs, int flags); =head1 DESCRIPTION PKCS7_verify() verifies a PKCS#7 signedData structure. B is the PKCS7 structure to verify. B is a set of certificates in which to search for -the signer's certificate. B is a trusted certficate store (used for +the signer's certificate. B is a trusted certificate store (used for chain verification). B is the signed data if the content is not present in B (that is it is detached). The content is written to B if it is not NULL. @@ -89,12 +91,12 @@ timestamp). =head1 RETURN VALUES -PKCS7_verify() returns 1 for a successful verification and zero or a negative -value if an error occurs. +PKCS7_verify() returns one for a successful verification and zero +if an error occurs. PKCS7_get0_signers() returns all signers or B if an error occurred. -The error can be obtained from L +The error can be obtained from L =head1 BUGS @@ -102,12 +104,11 @@ The trusted certificate store is not searched for the signers certificate, this is primarily due to the inadequacies of the current B functionality. -=head1 SEE ALSO - -L, L +The lack of single pass processing and need to hold all data in memory as +mentioned in PKCS7_sign() also applies to PKCS7_verify(). -=head1 HISTORY +=head1 SEE ALSO -TBA +L, L =cut