xref: /freebsd/crypto/openssl/doc/man3/SSL_get1_builtin_sigalgs.pod (revision e7be843b4a162e68651d3911f0357ed464915629)
1*e7be843bSPierre Pronchery=pod
2*e7be843bSPierre Pronchery
3*e7be843bSPierre Pronchery=head1 NAME
4*e7be843bSPierre Pronchery
5*e7be843bSPierre ProncherySSL_get1_builtin_sigalgs - get list of built-in signature algorithms
6*e7be843bSPierre Pronchery
7*e7be843bSPierre Pronchery=head1 SYNOPSIS
8*e7be843bSPierre Pronchery
9*e7be843bSPierre Pronchery #include <openssl/tls1.h>
10*e7be843bSPierre Pronchery
11*e7be843bSPierre Pronchery char *SSL_get1_builtin_sigalgs(OSSL_LIB_CTX *libctx);
12*e7be843bSPierre Pronchery
13*e7be843bSPierre Pronchery=head1 DESCRIPTION
14*e7be843bSPierre Pronchery
15*e7be843bSPierre ProncheryReturn the colon-separated list of built-in and available TLS signature
16*e7be843bSPierre Proncheryalgorithms.
17*e7be843bSPierre ProncheryThe string returned must be freed by the user using L<OPENSSL_free(3)>.
18*e7be843bSPierre Pronchery
19*e7be843bSPierre Pronchery=head1 NOTES
20*e7be843bSPierre Pronchery
21*e7be843bSPierre ProncheryThe string may be empty (strlen==0) if none of the built-in TLS signature
22*e7be843bSPierre Proncheryalgorithms can be activated, e.g., if suitable providers are missing.
23*e7be843bSPierre Pronchery
24*e7be843bSPierre Pronchery=head1 RETURN VALUES
25*e7be843bSPierre Pronchery
26*e7be843bSPierre ProncheryNULL may be returned if no memory could be allocated. Otherwise, a
27*e7be843bSPierre Proncherynewly allocated string is always returned but it may have strlen == 0.
28*e7be843bSPierre Pronchery
29*e7be843bSPierre Pronchery=head1 HISTORY
30*e7be843bSPierre Pronchery
31*e7be843bSPierre ProncheryThis function was added in OpenSSL 3.4.
32*e7be843bSPierre Pronchery
33*e7be843bSPierre Pronchery=head1 COPYRIGHT
34*e7be843bSPierre Pronchery
35*e7be843bSPierre ProncheryCopyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved.
36*e7be843bSPierre Pronchery
37*e7be843bSPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
38*e7be843bSPierre Proncherythis file except in compliance with the License.  You can obtain a copy
39*e7be843bSPierre Proncheryin the file LICENSE in the source distribution or at
40*e7be843bSPierre ProncheryL<https://www.openssl.org/source/license.html>.
41*e7be843bSPierre Pronchery
42*e7be843bSPierre Pronchery=cut
43