| 1 |
|
| 2 |
|
| 3 |
|
| 4 |
|
| 5 |
@deftypefun {int} {gnutls_sign_set_secure} (gnutls_sign_algorithm_t @var{sign}, unsigned int @var{secure}) |
| 6 |
@var{sign}: the sign algorithm |
| 7 |
|
| 8 |
@var{secure}: whether to mark the sign algorithm secure |
| 9 |
|
| 10 |
Modify the previous system wide setting that marked @code{sign} as secure |
| 11 |
or insecure. Calling this function is allowed |
| 12 |
only if allowlisting mode is set in the configuration file, |
| 13 |
and only if the system-wide TLS priority string |
| 14 |
has not been initialized yet. |
| 15 |
The intended usage is to provide applications with a way |
| 16 |
to expressly deviate from the distribution or site defaults |
| 17 |
inherited from the configuration file. |
| 18 |
The modification is composable with further modifications |
| 19 |
performed through the priority string mechanism. |
| 20 |
|
| 21 |
This function is not thread-safe and is intended to be called |
| 22 |
in the main thread at the beginning of the process execution. |
| 23 |
|
| 24 |
Even when @code{secure} is true, @code{sign} is not marked as secure for the |
| 25 |
use in certificates. Use @code{gnutls_sign_set_secure_for_certs()} to |
| 26 |
mark it secure as well for certificates. |
| 27 |
|
| 28 |
@strong{Returns:} 0 on success or negative error code otherwise. |
| 29 |
|
| 30 |
@strong{Since:} 3.7.3 |
| 31 |
@end deftypefun |