summaryrefslogtreecommitdiff
path: root/src/lib/libtls/tls_init.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libtls/tls_init.3')
-rw-r--r--src/lib/libtls/tls_init.329
1 files changed, 28 insertions, 1 deletions
diff --git a/src/lib/libtls/tls_init.3 b/src/lib/libtls/tls_init.3
index 05474016f4..f5cada93a5 100644
--- a/src/lib/libtls/tls_init.3
+++ b/src/lib/libtls/tls_init.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: tls_init.3,v 1.84 2017/01/24 01:16:26 claudio Exp $ 1.\" $OpenBSD: tls_init.3,v 1.85 2017/01/24 01:48:05 claudio Exp $
2.\" 2.\"
3.\" Copyright (c) 2014 Ted Unangst <tedu@openbsd.org> 3.\" Copyright (c) 2014 Ted Unangst <tedu@openbsd.org>
4.\" 4.\"
@@ -26,6 +26,7 @@
26.Nm tls_config_parse_protocols , 26.Nm tls_config_parse_protocols ,
27.Nm tls_config_add_keypair_file , 27.Nm tls_config_add_keypair_file ,
28.Nm tls_config_add_keypair_mem , 28.Nm tls_config_add_keypair_mem ,
29.Nm tls_config_add_ticket_key ,
29.Nm tls_config_set_alpn , 30.Nm tls_config_set_alpn ,
30.Nm tls_config_set_ca_file , 31.Nm tls_config_set_ca_file ,
31.Nm tls_config_set_ca_path , 32.Nm tls_config_set_ca_path ,
@@ -42,6 +43,8 @@
42.Nm tls_config_set_ocsp_staple_mem , 43.Nm tls_config_set_ocsp_staple_mem ,
43.Nm tls_config_set_ocsp_staple_file , 44.Nm tls_config_set_ocsp_staple_file ,
44.Nm tls_config_set_protocols , 45.Nm tls_config_set_protocols ,
46.Nm tls_config_set_session_id ,
47.Nm tls_config_set_session_lifetime ,
45.Nm tls_config_set_verify_depth , 48.Nm tls_config_set_verify_depth ,
46.Nm tls_config_prefer_ciphers_client , 49.Nm tls_config_prefer_ciphers_client ,
47.Nm tls_config_prefer_ciphers_server , 50.Nm tls_config_prefer_ciphers_server ,
@@ -111,6 +114,8 @@
111.Ft "int" 114.Ft "int"
112.Fn tls_config_add_keypair_mem "struct tls_config *config" "const uint8_t *cert" "size_t cert_len" "const uint8_t *key" "size_t key_len" 115.Fn tls_config_add_keypair_mem "struct tls_config *config" "const uint8_t *cert" "size_t cert_len" "const uint8_t *key" "size_t key_len"
113.Ft "int" 116.Ft "int"
117.Fn tls_config_add_ticket_key "struct tls_config *config" "uint32_t keyrev" "unsigned char *key" "size_t keylen"
118.Ft "int"
114.Fn tls_config_set_alpn "struct tls_config *config" "const char *alpn" 119.Fn tls_config_set_alpn "struct tls_config *config" "const char *alpn"
115.Ft "int" 120.Ft "int"
116.Fn tls_config_set_ca_file "struct tls_config *config" "const char *ca_file" 121.Fn tls_config_set_ca_file "struct tls_config *config" "const char *ca_file"
@@ -143,6 +148,10 @@
143.Ft "int" 148.Ft "int"
144.Fn tls_config_set_protocols "struct tls_config *config" "uint32_t protocols" 149.Fn tls_config_set_protocols "struct tls_config *config" "uint32_t protocols"
145.Ft "int" 150.Ft "int"
151.Fn tls_config_set_session_id "struct tls_config *config" "const unsigned char *session_id" "size_t len"
152.Ft "int"
153.Fn tls_config_set_session_lifetime "struct tls_config *config" "int lifetime"
154.Ft "int"
146.Fn tls_config_set_verify_depth "struct tls_config *config" "int verify_depth" 155.Fn tls_config_set_verify_depth "struct tls_config *config" "int verify_depth"
147.Ft "void" 156.Ft "void"
148.Fn tls_config_prefer_ciphers_client "struct tls_config *config" 157.Fn tls_config_prefer_ciphers_client "struct tls_config *config"
@@ -371,6 +380,14 @@ used as an alternative certificate for Server Name Indication (server only).
371adds an additional public certificate and private key from memory, 380adds an additional public certificate and private key from memory,
372used as an alternative certificate for Server Name Indication (server only). 381used as an alternative certificate for Server Name Indication (server only).
373.It 382.It
383.Fn tls_config_add_ticket_key
384adds a key used for the encryption and authentication of TLS tickets.
385By default keys are generated and rotated automatically based on their lifetime.
386This function should only be used to synchronise ticket encryption key accross
387multiple processes.
388Re-adding a known key will result in an error, unless it is the most recently
389added key.
390.It
374.Fn tls_config_set_alpn 391.Fn tls_config_set_alpn
375sets the ALPN protocols that are supported. 392sets the ALPN protocols that are supported.
376The alpn string is a comma separated list of protocols, in order of preference. 393The alpn string is a comma separated list of protocols, in order of preference.
@@ -447,6 +464,16 @@ Additionally, the values
447.Dv TLS_PROTOCOLS_DEFAULT 464.Dv TLS_PROTOCOLS_DEFAULT
448(TLSv1.2 only) may be used. 465(TLSv1.2 only) may be used.
449.It 466.It
467.Fn tls_config_set_session_id
468sets the session identifier that will be used by the TLS server when
469sessions are enabled.
470By default a random value is used.
471.It
472.Fn tls_config_set_session_lifetime
473sets the lifetime to be used for TLS sessions.
474Session support is disabled if a lifetime of zero is specified, which is the
475default.
476.It
450.Fn tls_config_set_verify_depth 477.Fn tls_config_set_verify_depth
451limits the number of intermediate certificates that will be followed during 478limits the number of intermediate certificates that will be followed during
452certificate validation. 479certificate validation.