mirror of
https://github.com/curl/curl.git
synced 2024-12-27 06:59:43 +08:00
141 lines
4.5 KiB
C
141 lines
4.5 KiB
C
#ifndef HEADER_CURL_LOG_H
|
|
#define HEADER_CURL_LOG_H
|
|
/***************************************************************************
|
|
* _ _ ____ _
|
|
* Project ___| | | | _ \| |
|
|
* / __| | | | |_) | |
|
|
* | (__| |_| | _ <| |___
|
|
* \___|\___/|_| \_\_____|
|
|
*
|
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, 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, data)) \
|
|
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, data) \
|
|
((data) && (data)->set.verbose && \
|
|
(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,y) ((void)(x), (void)(y), FALSE)
|
|
|
|
#endif /* !DEBUGBUILD */
|
|
|
|
#define LOG_CF_IS_DEBUG(cf, data) Curl_log_cf_is_debug(cf, data)
|
|
|
|
/* 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 */
|