1 .\" **************************************************************************
3 .\" * Project ___| | | | _ \| |
4 .\" * / __| | | | |_) | |
5 .\" * | (__| |_| | _ <| |___
6 .\" * \___|\___/|_| \_\_____|
8 .\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
10 .\" * This software is licensed as described in the file COPYING, which
11 .\" * you should have received as part of this distribution. The terms
12 .\" * are also available at https://curl.haxx.se/docs/copyright.html.
14 .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 .\" * copies of the Software, and permit persons to whom the Software is
16 .\" * furnished to do so, under the terms of the COPYING file.
18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 .\" * KIND, either express or implied.
21 .\" **************************************************************************
23 .TH CURLOPT_DEBUGFUNCTION 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options"
25 CURLOPT_DEBUGFUNCTION \- debug callback
28 #include <curl/curl.h>
32 CURLINFO_HEADER_IN, /* 1 */
33 CURLINFO_HEADER_OUT, /* 2 */
34 CURLINFO_DATA_IN, /* 3 */
35 CURLINFO_DATA_OUT, /* 4 */
36 CURLINFO_SSL_DATA_IN, /* 5 */
37 CURLINFO_SSL_DATA_OUT, /* 6 */
41 int debug_callback(CURL *handle,
47 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEBUGFUNCTION,
50 Pass a pointer to your callback function, which should match the prototype
53 \fICURLOPT_DEBUGFUNCTION(3)\fP replaces the standard debug function used when
54 \fICURLOPT_VERBOSE(3)\fP is in effect. This callback receives debug
55 information, as specified in the \fItype\fP argument. This function must
56 return 0. The \fIdata\fP pointed to by the char * passed to this function WILL
57 NOT be zero terminated, but will be exactly of the \fIsize\fP as told by the
60 The \fIuserptr\fP argument is the pointer set with \fICURLOPT_DEBUGDATA(3)\fP.
62 Available curl_infotype values:
64 The data is informational text.
65 .IP CURLINFO_HEADER_IN
66 The data is header (or header-like) data received from the peer.
67 .IP CURLINFO_HEADER_OUT
68 The data is header (or header-like) data sent to the peer.
70 The data is protocol data received from the peer.
72 The data is protocol data sent to the peer.
73 .IP CURLINFO_SSL_DATA_OUT
74 The data is SSL/TLS (binary) data sent to the peer.
75 .IP CURLINFO_SSL_DATA_IN
76 The data is SSL/TLS (binary) data received from the peer.
84 void dump(const char *text,
85 FILE *stream, unsigned char *ptr, size_t size)
89 unsigned int width=0x10;
91 fprintf(stream, "%s, %10.10ld bytes (0x%8.8lx)\\n",
92 text, (long)size, (long)size);
94 for(i=0; i<size; i+= width) {
95 fprintf(stream, "%4.4lx: ", (long)i);
97 /* show hex to the left */
98 for(c = 0; c < width; c++) {
100 fprintf(stream, "%02x ", ptr[i+c]);
105 /* show data on the right */
106 for(c = 0; (c < width) && (i+c < size); c++) {
107 char x = (ptr[i+c] >= 0x20 && ptr[i+c] < 0x80) ? ptr[i+c] : '.';
111 fputc('\\n', stream); /* newline */
116 int my_trace(CURL *handle, curl_infotype type,
117 char *data, size_t size,
121 (void)handle; /* prevent compiler warning */
126 fprintf(stderr, "== Info: %s", data);
127 default: /* in case a new one is introduced to shock us */
130 case CURLINFO_HEADER_OUT:
131 text = "=> Send header";
133 case CURLINFO_DATA_OUT:
134 text = "=> Send data";
136 case CURLINFO_SSL_DATA_OUT:
137 text = "=> Send SSL data";
139 case CURLINFO_HEADER_IN:
140 text = "<= Recv header";
142 case CURLINFO_DATA_IN:
143 text = "<= Recv data";
145 case CURLINFO_SSL_DATA_IN:
146 text = "<= Recv SSL data";
150 dump(text, stderr, (unsigned char *)data, size);
159 curl = curl_easy_init();
161 curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, my_trace);
163 /* the DEBUGFUNCTION has no effect until we enable VERBOSE */
164 curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
166 /* example.com is redirected, so we tell libcurl to follow redirection */
167 curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
169 curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/");
170 res = curl_easy_perform(curl);
171 /* Check for errors */
173 fprintf(stderr, "curl_easy_perform() failed: %s\\n",
174 curl_easy_strerror(res));
177 curl_easy_cleanup(curl);
187 .BR CURLOPT_VERBOSE "(3), " CURLOPT_DEBUGDATA "(3), "