mirror of
https://github.com/openssl/openssl.git
synced 2024-12-21 06:09:35 +08:00
0ce8271c20
Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Shane Lontis <shane.lontis@oracle.com> Reviewed-by: David von Oheimb <david.von.oheimb@siemens.com> (Merged from https://github.com/openssl/openssl/pull/14417)
52 lines
1.6 KiB
Plaintext
52 lines
1.6 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
X509_STORE_CTX_get_by_subject,
|
|
X509_STORE_CTX_get_obj_by_subject
|
|
- X509 and X509_CRL lookup functions
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/x509_vfy.h>
|
|
|
|
int X509_STORE_CTX_get_by_subject(const X509_STORE_CTX *vs,
|
|
X509_LOOKUP_TYPE type,
|
|
const X509_NAME *name, X509_OBJECT *ret);
|
|
X509_OBJECT *X509_STORE_CTX_get_obj_by_subject(X509_STORE_CTX *vs,
|
|
X509_LOOKUP_TYPE type,
|
|
const X509_NAME *name);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
X509_STORE_CTX_get_by_subject() tries to find an object
|
|
of given I<type>, which may be B<X509_LU_X509> or B<X509_LU_CRL>,
|
|
and subject I<name> from the store in the provided store context I<vs>.
|
|
If found and I<ret> is not NULL, it increments the reference count and
|
|
stores the looked up object in I<ret>.
|
|
|
|
X509_STORE_CTX_get_obj_by_subject() is like X509_STORE_CTX_get_by_subject()
|
|
but returns the found object on success, else NULL.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
X509_STORE_CTX_get_by_subject() returns 1 if the lookup was successful, else 0.
|
|
|
|
X509_STORE_CTX_get_obj_by_subject() returns an object on success, else NULL.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<X509_LOOKUP_meth_set_get_by_subject(3)>,
|
|
L<X509_LOOKUP_by_subject(3)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2022 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
Licensed under the Apache License 2.0 (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<https://www.openssl.org/source/license.html>.
|
|
|
|
=cut
|