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

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