crypto/libressl/include/tls.h

   1 /* $OpenBSD: tls.h,v 1.28 2016/04/28 17:05:59 jsing Exp $ */
   2 /*
   3  * Copyright (c) 2014 Joel Sing <jsing@openbsd.org>
   4  *
   5  * Permission to use, copy, modify, and distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 #ifndef HEADER_TLS_H
  19 #define HEADER_TLS_H
  20
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif
  24
  25 #include <sys/types.h>
  26
  27 #include <stddef.h>
  28 #include <stdint.h>
  29
  30 #define TLS_API 20141031
  31
  32 #define TLS_PROTOCOL_TLSv1_0    (1 << 1)
  33 #define TLS_PROTOCOL_TLSv1_1    (1 << 2)
  34 #define TLS_PROTOCOL_TLSv1_2    (1 << 3)
  35 #define TLS_PROTOCOL_TLSv1 \
  36         (TLS_PROTOCOL_TLSv1_0|TLS_PROTOCOL_TLSv1_1|TLS_PROTOCOL_TLSv1_2)
  37
  38 #define TLS_PROTOCOLS_ALL TLS_PROTOCOL_TLSv1
  39 #define TLS_PROTOCOLS_DEFAULT TLS_PROTOCOL_TLSv1_2
  40
  41 #define TLS_WANT_POLLIN         -2
  42 #define TLS_WANT_POLLOUT        -3
  43
  44 struct tls;
  45 struct tls_config;
  46
  47 int tls_init(void);
  48
  49 const char *tls_config_error(struct tls_config *_config);
  50 const char *tls_error(struct tls *_ctx);
  51
  52 struct tls_config *tls_config_new(void);
  53 void tls_config_free(struct tls_config *_config);
  54
  55 int tls_config_set_ca_file(struct tls_config *_config, const char *_ca_file);
  56 int tls_config_set_ca_path(struct tls_config *_config, const char *_ca_path);
  57 int tls_config_set_ca_mem(struct tls_config *_config, const uint8_t *_ca,
  58     size_t _len);
  59 int tls_config_set_cert_file(struct tls_config *_config,
  60     const char *_cert_file);
  61 int tls_config_set_cert_mem(struct tls_config *_config, const uint8_t *_cert,
  62     size_t _len);
  63 int tls_config_set_ciphers(struct tls_config *_config, const char *_ciphers);
  64 int tls_config_set_dheparams(struct tls_config *_config, const char *_params);
  65 int tls_config_set_ecdhecurve(struct tls_config *_config, const char *_name);
  66 int tls_config_set_key_file(struct tls_config *_config, const char *_key_file);
  67 int tls_config_set_key_mem(struct tls_config *_config, const uint8_t *_key,
  68     size_t _len);
  69 int tls_config_set_keypair_file(struct tls_config *_config,
  70     const char *_cert_file, const char *_key_file);
  71 int tls_config_set_keypair_mem(struct tls_config *_config, const uint8_t *_cert,
  72     size_t _cert_len, const uint8_t *_key, size_t _key_len);
  73 void tls_config_set_protocols(struct tls_config *_config, uint32_t _protocols);
  74 void tls_config_set_verify_depth(struct tls_config *_config, int _verify_depth);
  75
  76 void tls_config_prefer_ciphers_client(struct tls_config *_config);
  77 void tls_config_prefer_ciphers_server(struct tls_config *_config);
  78
  79 void tls_config_insecure_noverifycert(struct tls_config *_config);
  80 void tls_config_insecure_noverifyname(struct tls_config *_config);
  81 void tls_config_insecure_noverifytime(struct tls_config *_config);
  82 void tls_config_verify(struct tls_config *_config);
  83
  84 void tls_config_verify_client(struct tls_config *_config);
  85 void tls_config_verify_client_optional(struct tls_config *_config);
  86
  87 void tls_config_clear_keys(struct tls_config *_config);
  88 int tls_config_parse_protocols(uint32_t *_protocols, const char *_protostr);
  89
  90 struct tls *tls_client(void);
  91 struct tls *tls_server(void);
  92 int tls_configure(struct tls *_ctx, struct tls_config *_config);
  93 void tls_reset(struct tls *_ctx);
  94 void tls_free(struct tls *_ctx);
  95
  96 int tls_accept_fds(struct tls *_ctx, struct tls **_cctx, int _fd_read,
  97     int _fd_write);
  98 int tls_accept_socket(struct tls *_ctx, struct tls **_cctx, int _socket);
  99 int tls_connect(struct tls *_ctx, const char *_host, const char *_port);
 100 int tls_connect_fds(struct tls *_ctx, int _fd_read, int _fd_write,
 101     const char *_servername);
 102 int tls_connect_servername(struct tls *_ctx, const char *_host,
 103     const char *_port, const char *_servername);
 104 int tls_connect_socket(struct tls *_ctx, int _s, const char *_servername);
 105 int tls_handshake(struct tls *_ctx);
 106 ssize_t tls_read(struct tls *_ctx, void *_buf, size_t _buflen);
 107 ssize_t tls_write(struct tls *_ctx, const void *_buf, size_t _buflen);
 108 int tls_close(struct tls *_ctx);
 109
 110 int tls_peer_cert_provided(struct tls *_ctx);
 111 int tls_peer_cert_contains_name(struct tls *_ctx, const char *_name);
 112
 113 const char *tls_peer_cert_hash(struct tls *_ctx);
 114 const char *tls_peer_cert_issuer(struct tls *_ctx);
 115 const char *tls_peer_cert_subject(struct tls *_ctx);
 116 time_t  tls_peer_cert_notbefore(struct tls *_ctx);
 117 time_t  tls_peer_cert_notafter(struct tls *_ctx);
 118
 119 const char *tls_conn_version(struct tls *_ctx);
 120 const char *tls_conn_cipher(struct tls *_ctx);
 121
 122 uint8_t *tls_load_file(const char *_file, size_t *_len, char *_password);
 123
 124 #ifdef __cplusplus
 125 }
 126 #endif
 127
 128 #endif /* HEADER_TLS_H */