summaryrefslogtreecommitdiffstats
path: root/doc/manpages/gnutls_sign_set_secure.3
blob: 8eaa64bafe5845fa77da01ace69055056725cf91 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_sign_set_secure" 3 "3.7.9" "gnutls" "gnutls"
.SH NAME
gnutls_sign_set_secure \- API function
.SH SYNOPSIS
.B #include <gnutls/gnutls.h>
.sp
.BI "int gnutls_sign_set_secure(gnutls_sign_algorithm_t " sign ", unsigned int " secure ");"
.SH ARGUMENTS
.IP "gnutls_sign_algorithm_t sign" 12
the sign algorithm
.IP "unsigned int secure" 12
whether to mark the sign algorithm secure
.SH "DESCRIPTION"
Modify the previous system wide setting that marked  \fIsign\fP as secure
or insecure.  Calling this function is allowed
only if allowlisting mode is set in the configuration file,
and only if the system\-wide TLS priority string
has not been initialized yet.
The intended usage is to provide applications with a way
to expressly deviate from the distribution or site defaults
inherited from the configuration file.
The modification is composable with further modifications
performed through the priority string mechanism.

This function is not thread\-safe and is intended to be called
in the main thread at the beginning of the process execution.

Even when  \fIsecure\fP is true,  \fIsign\fP is not marked as secure for the
use in certificates.  Use \fBgnutls_sign_set_secure_for_certs()\fP to
mark it secure as well for certificates.
.SH "RETURNS"
0 on success or negative error code otherwise.
.SH "SINCE"
3.7.3
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.br
Home page: https://www.gnutls.org

.SH COPYRIGHT
Copyright \(co 2001- Free Software Foundation, Inc., and others.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B gnutls
is maintained as a Texinfo manual.
If the /usr/share/doc/gnutls/
directory does not contain the HTML form visit
.B
.IP https://www.gnutls.org/manual/
.PP