gnutls_sign_set_secure(3)

1gnutls_sign_set_secure(3)           gnutls           gnutls_sign_set_secure(3)
2
3
4

NAME

6       gnutls_sign_set_secure - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_sign_set_secure(gnutls_sign_algorithm_t  sign, unsigned int
12       secure);
13

ARGUMENTS

15       gnutls_sign_algorithm_t sign
16                   the sign algorithm
17
18       unsigned int secure
19                   whether to mark the sign algorithm secure
20

DESCRIPTION

22       Modify the previous system wide setting that marked  sign as secure  or
23       insecure.   Calling  this function is allowed only if allowlisting mode
24       is set in the configuration file, and only if the system-wide TLS  pri‐
25       ority  string  has  not been initialized yet.  The intended usage is to
26       provide applications with a way to expressly deviate from the distribu‐
27       tion or site defaults inherited from the configuration file.  The modi‐
28       fication is composable with further modifications performed through the
29       priority string mechanism.
30
31       This  function  is  not thread-safe and is intended to be called in the
32       main thread at the beginning of the process execution.
33
34       Even when  secure is true,  sign is not marked as secure for the use in
35       certificates.  Use gnutls_sign_set_secure_for_certs() to mark it secure
36       as well for certificates.
37

RETURNS

39       0 on success or negative error code otherwise.
40

SINCE

42       3.7.3
43

REPORTING BUGS

45       Report bugs to <bugs@gnutls.org>.
46       Home page: https://www.gnutls.org
47
48

COPYRIGHT

50       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
51       Copying and distribution of this file, with  or  without  modification,
52       are  permitted in any medium without royalty provided the copyright no‐
53       tice and this notice are preserved.
54