vtls.h 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. #ifndef HEADER_CURL_VTLS_H
  2. #define HEADER_CURL_VTLS_H
  3. /***************************************************************************
  4. * _ _ ____ _
  5. * Project ___| | | | _ \| |
  6. * / __| | | | |_) | |
  7. * | (__| |_| | _ <| |___
  8. * \___|\___/|_| \_\_____|
  9. *
  10. * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
  11. *
  12. * This software is licensed as described in the file COPYING, which
  13. * you should have received as part of this distribution. The terms
  14. * are also available at http://curl.haxx.se/docs/copyright.html.
  15. *
  16. * You may opt to use, copy, modify, merge, publish, distribute and/or sell
  17. * copies of the Software, and permit persons to whom the Software is
  18. * furnished to do so, under the terms of the COPYING file.
  19. *
  20. * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  21. * KIND, either express or implied.
  22. *
  23. ***************************************************************************/
  24. #include "curl_setup.h"
  25. #ifndef MD5_DIGEST_LENGTH
  26. #define MD5_DIGEST_LENGTH 16 /* fixed size */
  27. #endif
  28. /* see http://tools.ietf.org/html/draft-ietf-tls-applayerprotoneg-04 */
  29. #define ALPN_HTTP_1_1_LENGTH 8
  30. #define ALPN_HTTP_1_1 "http/1.1"
  31. bool Curl_ssl_config_matches(struct ssl_config_data* data,
  32. struct ssl_config_data* needle);
  33. bool Curl_clone_ssl_config(struct ssl_config_data* source,
  34. struct ssl_config_data* dest);
  35. void Curl_free_ssl_config(struct ssl_config_data* sslc);
  36. unsigned int Curl_rand(struct SessionHandle *);
  37. #ifdef USE_SSL
  38. int Curl_ssl_init(void);
  39. void Curl_ssl_cleanup(void);
  40. CURLcode Curl_ssl_connect(struct connectdata *conn, int sockindex);
  41. CURLcode Curl_ssl_connect_nonblocking(struct connectdata *conn,
  42. int sockindex,
  43. bool *done);
  44. /* tell the SSL stuff to close down all open information regarding
  45. connections (and thus session ID caching etc) */
  46. void Curl_ssl_close_all(struct SessionHandle *data);
  47. void Curl_ssl_close(struct connectdata *conn, int sockindex);
  48. CURLcode Curl_ssl_shutdown(struct connectdata *conn, int sockindex);
  49. CURLcode Curl_ssl_set_engine(struct SessionHandle *data, const char *engine);
  50. /* Sets engine as default for all SSL operations */
  51. CURLcode Curl_ssl_set_engine_default(struct SessionHandle *data);
  52. struct curl_slist *Curl_ssl_engines_list(struct SessionHandle *data);
  53. /* init the SSL session ID cache */
  54. CURLcode Curl_ssl_initsessions(struct SessionHandle *, size_t);
  55. size_t Curl_ssl_version(char *buffer, size_t size);
  56. bool Curl_ssl_data_pending(const struct connectdata *conn,
  57. int connindex);
  58. int Curl_ssl_check_cxn(struct connectdata *conn);
  59. /* Certificate information list handling. */
  60. void Curl_ssl_free_certinfo(struct SessionHandle *data);
  61. int Curl_ssl_init_certinfo(struct SessionHandle * data, int num);
  62. CURLcode Curl_ssl_push_certinfo_len(struct SessionHandle * data, int certnum,
  63. const char * label, const char * value,
  64. size_t valuelen);
  65. CURLcode Curl_ssl_push_certinfo(struct SessionHandle * data, int certnum,
  66. const char * label, const char * value);
  67. /* Functions to be used by SSL library adaptation functions */
  68. /* extract a session ID */
  69. int Curl_ssl_getsessionid(struct connectdata *conn,
  70. void **ssl_sessionid,
  71. size_t *idsize) /* set 0 if unknown */;
  72. /* add a new session ID */
  73. CURLcode Curl_ssl_addsessionid(struct connectdata *conn,
  74. void *ssl_sessionid,
  75. size_t idsize);
  76. /* Kill a single session ID entry in the cache */
  77. void Curl_ssl_kill_session(struct curl_ssl_session *session);
  78. /* delete a session from the cache */
  79. void Curl_ssl_delsessionid(struct connectdata *conn, void *ssl_sessionid);
  80. /* get N random bytes into the buffer */
  81. void Curl_ssl_md5sum(unsigned char *tmp, /* input */
  82. size_t tmplen,
  83. unsigned char *md5sum, /* output */
  84. size_t md5len);
  85. #define SSL_SHUTDOWN_TIMEOUT 10000 /* ms */
  86. #ifdef have_curlssl_random
  87. #define HAVE_CURL_SSL_RANDOM
  88. #endif
  89. #ifdef have_curlssl_md5sum
  90. #define HAVE_CURL_SSL_MD5SUM
  91. #endif
  92. #else
  93. /* When SSL support is not present, just define away these function calls */
  94. #define Curl_ssl_init() 1
  95. #define Curl_ssl_cleanup() Curl_nop_stmt
  96. #define Curl_ssl_connect(x,y) CURLE_NOT_BUILT_IN
  97. #define Curl_ssl_close_all(x) Curl_nop_stmt
  98. #define Curl_ssl_close(x,y) Curl_nop_stmt
  99. #define Curl_ssl_shutdown(x,y) CURLE_NOT_BUILT_IN
  100. #define Curl_ssl_set_engine(x,y) CURLE_NOT_BUILT_IN
  101. #define Curl_ssl_set_engine_default(x) CURLE_NOT_BUILT_IN
  102. #define Curl_ssl_engines_list(x) NULL
  103. #define Curl_ssl_send(a,b,c,d,e) -1
  104. #define Curl_ssl_recv(a,b,c,d,e) -1
  105. #define Curl_ssl_initsessions(x,y) CURLE_OK
  106. #define Curl_ssl_version(x,y) 0
  107. #define Curl_ssl_data_pending(x,y) 0
  108. #define Curl_ssl_check_cxn(x) 0
  109. #define Curl_ssl_free_certinfo(x) Curl_nop_stmt
  110. #define Curl_ssl_connect_nonblocking(x,y,z) CURLE_NOT_BUILT_IN
  111. #define Curl_ssl_kill_session(x) Curl_nop_stmt
  112. #endif
  113. #endif /* HEADER_CURL_VTLS_H */