SSL_CTX_SET1_GROUPS(3) | Library Functions Manual | SSL_CTX_SET1_GROUPS(3)

# NAME

`SSL_CTX_set1_groups`, `SSL_CTX_set1_groups_list`, `SSL_set1_groups`, `SSL_set1_groups_list`, `SSL_CTX_set1_curves`, `SSL_CTX_set1_curves_list`, `SSL_set1_curves`, `SSL_set1_curves_list` — choose supported EC groups

# SYNOPSIS

library “libssl” libcrypto
`#include <openssl/ssl.h>`

int
`SSL_CTX_set1_groups`(SSL_CTX *ctx, const int *glist, size_t glistlen);

int
`SSL_CTX_set1_groups_list`(SSL_CTX *ctx, const char *list);

int
`SSL_set1_groups`(SSL *ssl, const int *glist, size_t glistlen);

int
`SSL_set1_groups_list`(SSL *ssl, const char *list);

int
`SSL_CTX_set1_curves`(SSL_CTX *ctx, const int *clist, size_t clistlen);

int
`SSL_CTX_set1_curves_list`(SSL_CTX *ctx, const char *list);

int
`SSL_set1_curves`(SSL *ssl, const int *clist, size_t clistlen);

int
`SSL_set1_curves_list`(SSL *ssl, const char *list);

# DESCRIPTION

`SSL_CTX_set1_groups`() sets the supported groups for ctx to the glistlen groups in the array glist. The array consists of group NIDs in preference order. For a TLS client, the groups are used directly in the supported groups extension. For a TLS server, the groups are used to determine the set of shared groups.

`SSL_CTX_set1_groups_list`() sets the supported groups for ctx to the list represented as a colon separated list of group NIDs or names, for example "P-521:P-384:P-256".

`SSL_set1_groups`() and `SSL_set1_groups_list`() are similar except that they set supported groups for the SSL structure ssl only.

The curve functions are deprecated synonyms for the equivalently named group functions and are identical in every respect except that they are implemented as macros. They exist because prior to TLS1.3, there was only the concept of supported curves. In TLS1.3, this was renamed to supported groups and extended to include Diffie Hellman groups.

If an application wishes to make use of several of these functions for configuration purposes either on a command line or in a file, it should consider using the SSL_CONF interface instead of manually parsing options.

# RETURN VALUES

All these functions return 1 for success or 0 for failure.

# SEE ALSO

ssl(3), SSL_CTX_add_extra_chain_cert(3), SSL_CTX_set_cipher_list(3), SSL_CTX_set_options(3), SSL_new(3)

# HISTORY

The curve functions first appeared in OpenSSL 1.0.2 and the group functions in OpenSSL 1.1.1. Both have been available since OpenBSD 6.1.

June 8, 2025 | Debian