Blame doc/functions/gnutls_set_default_priority_append

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_set_default_priority_append} (gnutls_session_t @var{session}, const char * @var{add_prio}, const char ** @var{err_pos}, unsigned @var{flags})
Packit Service 4684c1
@var{session}: is a @code{gnutls_session_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{add_prio}: is a string describing priorities to be appended to default
Packit Service 4684c1
Packit Service 4684c1
@var{err_pos}: In case of an error this will have the position in the string the error occurred
Packit Service 4684c1
Packit Service 4684c1
@var{flags}: must be zero
Packit Service 4684c1
Packit Service 4684c1
Sets the default priority on the ciphers, key exchange methods,
Packit Service 4684c1
and macs with the additional options in  @code{add_prio} . This is the recommended method of
Packit Service 4684c1
setting the defaults when only few additional options are to be added. This promotes
Packit Service 4684c1
consistency between applications using GnuTLS, and allows GnuTLS using applications
Packit Service 4684c1
to update settings in par with the library.
Packit Service 4684c1
Packit Service 4684c1
The  @code{add_prio} string should start as a normal priority string, e.g.,
Packit Service 4684c1
'-VERS-TLS-ALL:+VERS-TLS1.3:%COMPAT' or '%FORCE_ETM'. That is, it must not start
Packit Service 4684c1
with ':'.
Packit Service 4684c1
Packit Service 4684c1
To allow a user to override the defaults (e.g., when a user interface
Packit Service 4684c1
or configuration file is available), the functions
Packit Service 4684c1
@code{gnutls_priority_set_direct()}  or @code{gnutls_priority_set()}  can
Packit Service 4684c1
be used.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} @code{GNUTLS_E_SUCCESS}  on success, or an error code.
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 3.6.3
Packit Service 4684c1
@end deftypefun