diff options
Diffstat (limited to 'src/lib/libtls/tls_init.3')
-rw-r--r-- | src/lib/libtls/tls_init.3 | 29 |
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). | |||
371 | adds an additional public certificate and private key from memory, | 380 | adds an additional public certificate and private key from memory, |
372 | used as an alternative certificate for Server Name Indication (server only). | 381 | used as an alternative certificate for Server Name Indication (server only). |
373 | .It | 382 | .It |
383 | .Fn tls_config_add_ticket_key | ||
384 | adds a key used for the encryption and authentication of TLS tickets. | ||
385 | By default keys are generated and rotated automatically based on their lifetime. | ||
386 | This function should only be used to synchronise ticket encryption key accross | ||
387 | multiple processes. | ||
388 | Re-adding a known key will result in an error, unless it is the most recently | ||
389 | added key. | ||
390 | .It | ||
374 | .Fn tls_config_set_alpn | 391 | .Fn tls_config_set_alpn |
375 | sets the ALPN protocols that are supported. | 392 | sets the ALPN protocols that are supported. |
376 | The alpn string is a comma separated list of protocols, in order of preference. | 393 | The 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 | ||
468 | sets the session identifier that will be used by the TLS server when | ||
469 | sessions are enabled. | ||
470 | By default a random value is used. | ||
471 | .It | ||
472 | .Fn tls_config_set_session_lifetime | ||
473 | sets the lifetime to be used for TLS sessions. | ||
474 | Session support is disabled if a lifetime of zero is specified, which is the | ||
475 | default. | ||
476 | .It | ||
450 | .Fn tls_config_set_verify_depth | 477 | .Fn tls_config_set_verify_depth |
451 | limits the number of intermediate certificates that will be followed during | 478 | limits the number of intermediate certificates that will be followed during |
452 | certificate validation. | 479 | certificate validation. |