.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.

.TH "gnutls_set_default_priority_append" 3 "3.6.14" "gnutls" "gnutls"

.SH NAME

gnutls_set_default_priority_append \- API function

.SH SYNOPSIS

.B #include <gnutls/gnutls.h>

.sp

.BI "int gnutls_set_default_priority_append(gnutls_session_t " session ", const char * " add_prio ", const char ** " err_pos ", unsigned " flags ");"

.SH ARGUMENTS

.IP "gnutls_session_t session" 12

is a \fBgnutls_session_t\fP type.

.IP "const char * add_prio" 12

is a string describing priorities to be appended to default

.IP "const char ** err_pos" 12

In case of an error this will have the position in the string the error occurred

.IP "unsigned flags" 12

must be zero

.SH "DESCRIPTION"

Sets the default priority on the ciphers, key exchange methods,

and macs with the additional options in  \fIadd_prio\fP . This is the recommended method of

setting the defaults when only few additional options are to be added. This promotes

consistency between applications using GnuTLS, and allows GnuTLS using applications

to update settings in par with the library.

The  \fIadd_prio\fP string should start as a normal priority string, e.g.,

'\-VERS\-TLS\-ALL:+VERS\-TLS1.3:%COMPAT' or '%FORCE_ETM'. That is, it must not start

with ':'.

To allow a user to override the defaults (e.g., when a user interface

or configuration file is available), the functions

\fBgnutls_priority_set_direct()\fP or \fBgnutls_priority_set()\fP can

be used.

.SH "RETURNS"

\fBGNUTLS_E_SUCCESS\fP on success, or an error code.

.SH "SINCE"

3.6.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