---
name: "gnutls_priority_get_cipher_suite_index"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_priority_get_cipher_suite_index"
---

# gnutls\_priority\_get\_cipher\_suite\_index(3)

API function

## NAME

gnutls\_priority\_get\_cipher\_suite\_index - API function

## SYNOPSIS

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

**int gnutls\_priority\_get\_cipher\_suite\_index(gnutls\_priority\_t** *pcache***, unsigned int** *idx***, unsigned int \*** *sidx***);**

## ARGUMENTS

- gnutls\_priority\_t pcache

  is a **gnutls\_priority\_t** type.

- unsigned int idx

  is an index number.

- unsigned int \* sidx

  internal index of cipher suite to get information about.

## DESCRIPTION

Provides the internal ciphersuite index to be used with **gnutls\_cipher\_suite\_info()**. The index  *idx* provided is an index kept at the priorities structure. It might be that a valid priorities index does not correspond to a ciphersuite and in that case **GNUTLS\_E\_UNKNOWN\_CIPHER\_SUITE** will be returned. Once the last available index is crossed then **GNUTLS\_E\_REQUESTED\_DATA\_NOT\_AVAILABLE** will be returned.

## RETURNS

On success it returns **GNUTLS\_E\_SUCCESS** (0), or a negative error value otherwise.

## SINCE

3\.0.9

## REPORTING BUGS

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

## COPYRIGHT

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

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