1 #ifndef HEADER_CURL_KEYLOG_H 2 #define HEADER_CURL_KEYLOG_H 3 /*************************************************************************** 4 * _ _ ____ _ 5 * Project ___| | | | _ \| | 6 * / __| | | | |_) | | 7 * | (__| |_| | _ <| |___ 8 * \___|\___/|_| \_\_____| 9 * 10 * Copyright (C) 1998 - 2020, 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 https://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 26 /* 27 * Opens the TLS key log file if requested by the user. The SSLKEYLOGFILE 28 * environment variable specifies the output file. 29 */ 30 void Curl_tls_keylog_open(void); 31 32 /* 33 * Closes the TLS key log file if not already. 34 */ 35 void Curl_tls_keylog_close(void); 36 37 /* 38 * Returns true if the user successfully enabled the TLS key log file. 39 */ 40 bool Curl_tls_keylog_enabled(void); 41 42 /* 43 * Appends a key log file entry. 44 * Returns true iff the key log file is open and a valid entry was provided. 45 */ 46 bool Curl_tls_keylog_write(const char *label, 47 const unsigned char client_random[32], 48 const unsigned char *secret, size_t secretlen); 49 50 /* 51 * Appends a line to the key log file, ensure it is terminated by a LF. 52 * Returns true iff the key log file is open and a valid line was provided. 53 */ 54 bool Curl_tls_keylog_write_line(const char *line); 55 56 #endif /* HEADER_CURL_KEYLOG_H */ 57