mirror of
https://github.com/openssl/openssl.git
synced 2025-03-01 19:28:10 +08:00
eeccc23723
Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/12615)
65 lines
1.8 KiB
Plaintext
65 lines
1.8 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
X509_add_cert,
|
|
X509_add_certs -
|
|
X509 certificate list addition functions
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/x509.h>
|
|
|
|
int X509_add_cert(STACK_OF(X509) *sk, X509 *cert, int flags);
|
|
int X509_add_certs(STACK_OF(X509) *sk, STACK_OF(X509) *certs, int flags);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
X509_add_cert() adds a certificate I<cert> to the given list I<sk>.
|
|
|
|
X509_add_certs() adds a list of certificate I<certs> to the given list I<sk>.
|
|
The I<certs> argument may be NULL, which implies no effect.
|
|
|
|
Both these functions have a I<flags> parameter,
|
|
which is used to control details of the operation.
|
|
|
|
The value B<X509_ADD_FLAG_DEFAULT>, which equals 0, means no special semantics.
|
|
|
|
If B<X509_ADD_FLAG_UP_REF> is set then
|
|
the reference counts of those certificates added successfully are increased.
|
|
|
|
If B<X509_ADD_FLAG_PREPEND> is set then the certifcates are prepended to I<sk>.
|
|
By default they are appended to I<sk>.
|
|
In both cases the original order of the added certificates is preserved.
|
|
|
|
If B<X509_ADD_FLAG_NO_DUP> is set then certificates already contained in I<sk>,
|
|
which is determined using L<X509_cmp(3)>, are ignored.
|
|
|
|
If B<X509_ADD_FLAG_NO_SS> is set then certificates that are marked self-signed,
|
|
which is determined using L<X509_self_signed(3)>, are ignored.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
Both functions return 1 for success and 0 for failure.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<X509_cmp(3)>
|
|
L<X509_self_signed(3)>
|
|
|
|
=head1 HISTORY
|
|
|
|
The functions X509_add_cert() and X509_add_certs()
|
|
were added in OpenSSL 3.0.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2019-2020 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
|