#ifndef HEADER_CURL_LOG_H #define HEADER_CURL_LOG_H /*************************************************************************** * _ _ ____ _ * Project ___| | | | _ \| | * / __| | | | |_) | | * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * * Copyright (C) Daniel Stenberg, , et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms * are also available at https://curl.se/docs/copyright.html. * * You may opt to use, copy, modify, merge, publish, distribute and/or sell * copies of the Software, and permit persons to whom the Software is * furnished to do so, under the terms of the COPYING file. * * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY * KIND, either express or implied. * * SPDX-License-Identifier: curl * ***************************************************************************/ struct Curl_easy; struct Curl_cfilter; /** * Init logging, return != 0 on failure. */ CURLcode Curl_log_init(void); void Curl_infof(struct Curl_easy *, const char *fmt, ...); void Curl_failf(struct Curl_easy *, const char *fmt, ...); #if defined(CURL_DISABLE_VERBOSE_STRINGS) #if defined(HAVE_VARIADIC_MACROS_C99) #define infof(...) Curl_nop_stmt #elif defined(HAVE_VARIADIC_MACROS_GCC) #define infof(x...) Curl_nop_stmt #else #error "missing VARIADIC macro define, fix and rebuild!" #endif #else /* CURL_DISABLE_VERBOSE_STRINGS */ #define infof Curl_infof #endif /* CURL_DISABLE_VERBOSE_STRINGS */ #define failf Curl_failf #define CURL_LOG_DEFAULT 0 #define CURL_LOG_DEBUG 1 #define CURL_LOG_TRACE 2 /* the function used to output verbose information */ void Curl_debug(struct Curl_easy *data, curl_infotype type, char *ptr, size_t size); #ifdef DEBUGBUILD /* explainer: we have some mix configuration and werror settings * that define HAVE_VARIADIC_MACROS_C99 even though C89 is enforced * on gnuc and some other compiler. Need to treat carefully. */ #if defined(HAVE_VARIADIC_MACROS_C99) && \ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) #define LOG_CF(data, cf, ...) \ do { if(Curl_log_cf_is_debug(cf)) \ Curl_log_cf_debug(data, cf, __VA_ARGS__); } while(0) #else #define LOG_CF Curl_log_cf_debug #endif void Curl_log_cf_debug(struct Curl_easy *data, struct Curl_cfilter *cf, #if defined(__GNUC__) && !defined(printf) && \ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) && \ !defined(__MINGW32__) const char *fmt, ...) __attribute__((format(printf, 3, 4))); #else const char *fmt, ...); #endif #define Curl_log_cf_is_debug(cf) \ ((cf) && (cf)->cft->log_level >= CURL_LOG_DEBUG) #else /* !DEBUGBUILD */ #if defined(HAVE_VARIADIC_MACROS_C99) && \ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) #define LOG_CF(...) Curl_nop_stmt #define Curl_log_cf_debug(...) Curl_nop_stmt #elif defined(HAVE_VARIADIC_MACROS_GCC) && \ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) #define LOG_CF(x...) Curl_nop_stmt #define Curl_log_cf_debug(x...) Curl_nop_stmt #else #define LOG_CF Curl_log_cf_debug /* without c99, we seem unable to completely define away this function. */ void Curl_log_cf_debug(struct Curl_easy *data, struct Curl_cfilter *cf, const char *fmt, ...); #endif #define Curl_log_cf_is_debug(x) ((void)(x), FALSE) #endif /* !DEBUGBUILD */ #define LOG_CF_IS_DEBUG(x) Curl_log_cf_is_debug(x) /* Macros intended for DEBUGF logging, use like: * DEBUGF(infof(data, CFMSG(cf, "this filter %s rocks"), "very much")); * and it will output: * [CONN-1-0][CF-SSL] this filter very much rocks * on connection #1 with sockindex 0 for filter of type "SSL". */ #define DMSG(d,msg) \ "[CONN-%ld] "msg, (d)->conn->connection_id #define DMSGI(d,i,msg) \ "[CONN-%ld-%d] "msg, (d)->conn->connection_id, (i) #define CMSG(c,msg) \ "[CONN-%ld] "msg, (c)->connection_id #define CMSGI(c,i,msg) \ "[CONN-%ld-%d] "msg, (c)->connection_id, (i) #define CFMSG(cf,msg) \ "[CONN-%ld-%d][CF-%s] "msg, (cf)->conn->connection_id, \ (cf)->sockindex, (cf)->cft->name #endif /* HEADER_CURL_LOG_H */