---
name: "gnutls_cipher_set_priority"
section: "3"
platform: "linux"
package: "gnutls-doc"
version: "3.3.8-6+deb8u7"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_cipher_set_priority"
---

# gnutls\_cipher\_set\_priority(3)

API function

## NAME

gnutls\_cipher\_set\_priority - API function

## SYNOPSIS

**#include \<gnutls/compat.h\>**

**int gnutls\_cipher\_set\_priority(gnutls\_session\_t** *session***, const int \*** *list***);**

## ARGUMENTS

- gnutls\_session\_t session

  is a **gnutls\_session\_t** structure.

- const int \* list

  is a 0 terminated list of gnutls\_cipher\_algorithm\_t elements.

## DESCRIPTION

Sets the priority on the ciphers supported by gnutls.  Priority is higher for elements specified before others.  After specifying the ciphers you want, you must append a 0.  Note that the priority is set on the client. The server does not use the algorithm's priority except for disabling algorithms that were not specified.

## RETURNS

**GNUTLS\_E\_SUCCESS** (0) on success, or a negative error code.

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: http://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2014 Free Software Foundation, Inc..\
 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.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

- http://www.gnutls.org/manual/