1#ifndef __CURL_TYPECHECK_GCC_H
2#define __CURL_TYPECHECK_GCC_H
3/***************************************************************************
4 *                                  _   _ ____  _
5 *  Project                     ___| | | |  _ \| |
6 *                             / __| | | | |_) | |
7 *                            | (__| |_| |  _ <| |___
8 *                             \___|\___/|_| \_\_____|
9 *
10 * Copyright (C) 1998 - 2015, 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
25/* wraps curl_easy_setopt() with typechecking */
26
27/* To add a new kind of warning, add an
28 *   if(_curl_is_sometype_option(_curl_opt))
29 *     if(!_curl_is_sometype(value))
30 *       _curl_easy_setopt_err_sometype();
31 * block and define _curl_is_sometype_option, _curl_is_sometype and
32 * _curl_easy_setopt_err_sometype below
33 *
34 * NOTE: We use two nested 'if' statements here instead of the && operator, in
35 *       order to work around gcc bug #32061.  It affects only gcc 4.3.x/4.4.x
36 *       when compiling with -Wlogical-op.
37 *
38 * To add an option that uses the same type as an existing option, you'll just
39 * need to extend the appropriate _curl_*_option macro
40 */
41#define curl_easy_setopt(handle, option, value)                               \
42__extension__ ({                                                              \
43  __typeof__ (option) _curl_opt = option;                                     \
44  if(__builtin_constant_p(_curl_opt)) {                                       \
45    if(_curl_is_long_option(_curl_opt))                                       \
46      if(!_curl_is_long(value))                                               \
47        _curl_easy_setopt_err_long();                                         \
48    if(_curl_is_off_t_option(_curl_opt))                                      \
49      if(!_curl_is_off_t(value))                                              \
50        _curl_easy_setopt_err_curl_off_t();                                   \
51    if(_curl_is_string_option(_curl_opt))                                     \
52      if(!_curl_is_string(value))                                             \
53        _curl_easy_setopt_err_string();                                       \
54    if(_curl_is_write_cb_option(_curl_opt))                                   \
55      if(!_curl_is_write_cb(value))                                           \
56        _curl_easy_setopt_err_write_callback();                               \
57    if((_curl_opt) == CURLOPT_READFUNCTION)                                   \
58      if(!_curl_is_read_cb(value))                                            \
59        _curl_easy_setopt_err_read_cb();                                      \
60    if((_curl_opt) == CURLOPT_IOCTLFUNCTION)                                  \
61      if(!_curl_is_ioctl_cb(value))                                           \
62        _curl_easy_setopt_err_ioctl_cb();                                     \
63    if((_curl_opt) == CURLOPT_SOCKOPTFUNCTION)                                \
64      if(!_curl_is_sockopt_cb(value))                                         \
65        _curl_easy_setopt_err_sockopt_cb();                                   \
66    if((_curl_opt) == CURLOPT_OPENSOCKETFUNCTION)                             \
67      if(!_curl_is_opensocket_cb(value))                                      \
68        _curl_easy_setopt_err_opensocket_cb();                                \
69    if((_curl_opt) == CURLOPT_PROGRESSFUNCTION)                               \
70      if(!_curl_is_progress_cb(value))                                        \
71        _curl_easy_setopt_err_progress_cb();                                  \
72    if((_curl_opt) == CURLOPT_DEBUGFUNCTION)                                  \
73      if(!_curl_is_debug_cb(value))                                           \
74        _curl_easy_setopt_err_debug_cb();                                     \
75    if((_curl_opt) == CURLOPT_SSL_CTX_FUNCTION)                               \
76      if(!_curl_is_ssl_ctx_cb(value))                                         \
77        _curl_easy_setopt_err_ssl_ctx_cb();                                   \
78    if(_curl_is_conv_cb_option(_curl_opt))                                    \
79      if(!_curl_is_conv_cb(value))                                            \
80        _curl_easy_setopt_err_conv_cb();                                      \
81    if((_curl_opt) == CURLOPT_SEEKFUNCTION)                                   \
82      if(!_curl_is_seek_cb(value))                                            \
83        _curl_easy_setopt_err_seek_cb();                                      \
84    if(_curl_is_cb_data_option(_curl_opt))                                    \
85      if(!_curl_is_cb_data(value))                                            \
86        _curl_easy_setopt_err_cb_data();                                      \
87    if((_curl_opt) == CURLOPT_ERRORBUFFER)                                    \
88      if(!_curl_is_error_buffer(value))                                       \
89        _curl_easy_setopt_err_error_buffer();                                 \
90    if((_curl_opt) == CURLOPT_STDERR)                                         \
91      if(!_curl_is_FILE(value))                                               \
92        _curl_easy_setopt_err_FILE();                                         \
93    if(_curl_is_postfields_option(_curl_opt))                                 \
94      if(!_curl_is_postfields(value))                                         \
95        _curl_easy_setopt_err_postfields();                                   \
96    if((_curl_opt) == CURLOPT_HTTPPOST)                                       \
97      if(!_curl_is_arr((value), struct curl_httppost))                        \
98        _curl_easy_setopt_err_curl_httpost();                                 \
99    if(_curl_is_slist_option(_curl_opt))                                      \
100      if(!_curl_is_arr((value), struct curl_slist))                           \
101        _curl_easy_setopt_err_curl_slist();                                   \
102    if((_curl_opt) == CURLOPT_SHARE)                                          \
103      if(!_curl_is_ptr((value), CURLSH))                                      \
104        _curl_easy_setopt_err_CURLSH();                                       \
105  }                                                                           \
106  curl_easy_setopt(handle, _curl_opt, value);                                 \
107})
108
109/* wraps curl_easy_getinfo() with typechecking */
110/* FIXME: don't allow const pointers */
111#define curl_easy_getinfo(handle, info, arg)                                  \
112__extension__ ({                                                              \
113  __typeof__ (info) _curl_info = info;                                        \
114  if(__builtin_constant_p(_curl_info)) {                                      \
115    if(_curl_is_string_info(_curl_info))                                      \
116      if(!_curl_is_arr((arg), char *))                                        \
117        _curl_easy_getinfo_err_string();                                      \
118    if(_curl_is_long_info(_curl_info))                                        \
119      if(!_curl_is_arr((arg), long))                                          \
120        _curl_easy_getinfo_err_long();                                        \
121    if(_curl_is_double_info(_curl_info))                                      \
122      if(!_curl_is_arr((arg), double))                                        \
123        _curl_easy_getinfo_err_double();                                      \
124    if(_curl_is_slist_info(_curl_info))                                       \
125      if(!_curl_is_arr((arg), struct curl_slist *))                           \
126        _curl_easy_getinfo_err_curl_slist();                                  \
127  }                                                                           \
128  curl_easy_getinfo(handle, _curl_info, arg);                                 \
129})
130
131/* TODO: typechecking for curl_share_setopt() and curl_multi_setopt(),
132 * for now just make sure that the functions are called with three
133 * arguments
134 */
135#define curl_share_setopt(share,opt,param) curl_share_setopt(share,opt,param)
136#define curl_multi_setopt(handle,opt,param) curl_multi_setopt(handle,opt,param)
137
138
139/* the actual warnings, triggered by calling the _curl_easy_setopt_err*
140 * functions */
141
142/* To define a new warning, use _CURL_WARNING(identifier, "message") */
143#define _CURL_WARNING(id, message)                                            \
144  static void __attribute__((__warning__(message)))                           \
145  __attribute__((__unused__)) __attribute__((__noinline__))                   \
146  id(void) { __asm__(""); }
147
148_CURL_WARNING(_curl_easy_setopt_err_long,
149  "curl_easy_setopt expects a long argument for this option")
150_CURL_WARNING(_curl_easy_setopt_err_curl_off_t,
151  "curl_easy_setopt expects a curl_off_t argument for this option")
152_CURL_WARNING(_curl_easy_setopt_err_string,
153              "curl_easy_setopt expects a "
154              "string (char* or char[]) argument for this option"
155  )
156_CURL_WARNING(_curl_easy_setopt_err_write_callback,
157  "curl_easy_setopt expects a curl_write_callback argument for this option")
158_CURL_WARNING(_curl_easy_setopt_err_read_cb,
159  "curl_easy_setopt expects a curl_read_callback argument for this option")
160_CURL_WARNING(_curl_easy_setopt_err_ioctl_cb,
161  "curl_easy_setopt expects a curl_ioctl_callback argument for this option")
162_CURL_WARNING(_curl_easy_setopt_err_sockopt_cb,
163  "curl_easy_setopt expects a curl_sockopt_callback argument for this option")
164_CURL_WARNING(_curl_easy_setopt_err_opensocket_cb,
165              "curl_easy_setopt expects a "
166              "curl_opensocket_callback argument for this option"
167  )
168_CURL_WARNING(_curl_easy_setopt_err_progress_cb,
169  "curl_easy_setopt expects a curl_progress_callback argument for this option")
170_CURL_WARNING(_curl_easy_setopt_err_debug_cb,
171  "curl_easy_setopt expects a curl_debug_callback argument for this option")
172_CURL_WARNING(_curl_easy_setopt_err_ssl_ctx_cb,
173  "curl_easy_setopt expects a curl_ssl_ctx_callback argument for this option")
174_CURL_WARNING(_curl_easy_setopt_err_conv_cb,
175  "curl_easy_setopt expects a curl_conv_callback argument for this option")
176_CURL_WARNING(_curl_easy_setopt_err_seek_cb,
177  "curl_easy_setopt expects a curl_seek_callback argument for this option")
178_CURL_WARNING(_curl_easy_setopt_err_cb_data,
179              "curl_easy_setopt expects a "
180              "private data pointer as argument for this option")
181_CURL_WARNING(_curl_easy_setopt_err_error_buffer,
182              "curl_easy_setopt expects a "
183              "char buffer of CURL_ERROR_SIZE as argument for this option")
184_CURL_WARNING(_curl_easy_setopt_err_FILE,
185  "curl_easy_setopt expects a FILE* argument for this option")
186_CURL_WARNING(_curl_easy_setopt_err_postfields,
187  "curl_easy_setopt expects a void* or char* argument for this option")
188_CURL_WARNING(_curl_easy_setopt_err_curl_httpost,
189  "curl_easy_setopt expects a struct curl_httppost* argument for this option")
190_CURL_WARNING(_curl_easy_setopt_err_curl_slist,
191  "curl_easy_setopt expects a struct curl_slist* argument for this option")
192_CURL_WARNING(_curl_easy_setopt_err_CURLSH,
193  "curl_easy_setopt expects a CURLSH* argument for this option")
194
195_CURL_WARNING(_curl_easy_getinfo_err_string,
196  "curl_easy_getinfo expects a pointer to char * for this info")
197_CURL_WARNING(_curl_easy_getinfo_err_long,
198  "curl_easy_getinfo expects a pointer to long for this info")
199_CURL_WARNING(_curl_easy_getinfo_err_double,
200  "curl_easy_getinfo expects a pointer to double for this info")
201_CURL_WARNING(_curl_easy_getinfo_err_curl_slist,
202  "curl_easy_getinfo expects a pointer to struct curl_slist * for this info")
203
204/* groups of curl_easy_setops options that take the same type of argument */
205
206/* To add a new option to one of the groups, just add
207 *   (option) == CURLOPT_SOMETHING
208 * to the or-expression. If the option takes a long or curl_off_t, you don't
209 * have to do anything
210 */
211
212/* evaluates to true if option takes a long argument */
213#define _curl_is_long_option(option)                                          \
214  (0 < (option) && (option) < CURLOPTTYPE_OBJECTPOINT)
215
216#define _curl_is_off_t_option(option)                                         \
217  ((option) > CURLOPTTYPE_OFF_T)
218
219/* evaluates to true if option takes a char* argument */
220#define _curl_is_string_option(option)                                        \
221  ((option) == CURLOPT_ACCEPT_ENCODING ||                                     \
222   (option) == CURLOPT_CAINFO ||                                              \
223   (option) == CURLOPT_CAPATH ||                                              \
224   (option) == CURLOPT_COOKIE ||                                              \
225   (option) == CURLOPT_COOKIEFILE ||                                          \
226   (option) == CURLOPT_COOKIEJAR ||                                           \
227   (option) == CURLOPT_COOKIELIST ||                                          \
228   (option) == CURLOPT_CRLFILE ||                                             \
229   (option) == CURLOPT_CUSTOMREQUEST ||                                       \
230   (option) == CURLOPT_DEFAULT_PROTOCOL ||                                    \
231   (option) == CURLOPT_DNS_INTERFACE ||                                       \
232   (option) == CURLOPT_DNS_LOCAL_IP4 ||                                       \
233   (option) == CURLOPT_DNS_LOCAL_IP6 ||                                       \
234   (option) == CURLOPT_DNS_SERVERS ||                                         \
235   (option) == CURLOPT_EGDSOCKET ||                                           \
236   (option) == CURLOPT_FTPPORT ||                                             \
237   (option) == CURLOPT_FTP_ACCOUNT ||                                         \
238   (option) == CURLOPT_FTP_ALTERNATIVE_TO_USER ||                             \
239   (option) == CURLOPT_INTERFACE ||                                           \
240   (option) == CURLOPT_ISSUERCERT ||                                          \
241   (option) == CURLOPT_KEYPASSWD ||                                           \
242   (option) == CURLOPT_KRBLEVEL ||                                            \
243   (option) == CURLOPT_LOGIN_OPTIONS ||                                       \
244   (option) == CURLOPT_MAIL_AUTH ||                                           \
245   (option) == CURLOPT_MAIL_FROM ||                                           \
246   (option) == CURLOPT_NETRC_FILE ||                                          \
247   (option) == CURLOPT_NOPROXY ||                                             \
248   (option) == CURLOPT_PASSWORD ||                                            \
249   (option) == CURLOPT_PINNEDPUBLICKEY ||                                     \
250   (option) == CURLOPT_PROXY ||                                               \
251   (option) == CURLOPT_PROXYPASSWORD ||                                       \
252   (option) == CURLOPT_PROXYUSERNAME ||                                       \
253   (option) == CURLOPT_PROXYUSERPWD ||                                        \
254   (option) == CURLOPT_PROXY_SERVICE_NAME ||                                  \
255   (option) == CURLOPT_RANDOM_FILE ||                                         \
256   (option) == CURLOPT_RANGE ||                                               \
257   (option) == CURLOPT_REFERER ||                                             \
258   (option) == CURLOPT_RTSP_SESSION_ID ||                                     \
259   (option) == CURLOPT_RTSP_STREAM_URI ||                                     \
260   (option) == CURLOPT_RTSP_TRANSPORT ||                                      \
261   (option) == CURLOPT_SERVICE_NAME ||                                        \
262   (option) == CURLOPT_SOCKS5_GSSAPI_SERVICE ||                               \
263   (option) == CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 ||                             \
264   (option) == CURLOPT_SSH_KNOWNHOSTS ||                                      \
265   (option) == CURLOPT_SSH_PRIVATE_KEYFILE ||                                 \
266   (option) == CURLOPT_SSH_PUBLIC_KEYFILE ||                                  \
267   (option) == CURLOPT_SSLCERT ||                                             \
268   (option) == CURLOPT_SSLCERTTYPE ||                                         \
269   (option) == CURLOPT_SSLENGINE ||                                           \
270   (option) == CURLOPT_SSLKEY ||                                              \
271   (option) == CURLOPT_SSLKEYTYPE ||                                          \
272   (option) == CURLOPT_SSL_CIPHER_LIST ||                                     \
273   (option) == CURLOPT_TLSAUTH_PASSWORD ||                                    \
274   (option) == CURLOPT_TLSAUTH_TYPE ||                                        \
275   (option) == CURLOPT_TLSAUTH_USERNAME ||                                    \
276   (option) == CURLOPT_UNIX_SOCKET_PATH ||                                    \
277   (option) == CURLOPT_URL ||                                                 \
278   (option) == CURLOPT_USERAGENT ||                                           \
279   (option) == CURLOPT_USERNAME ||                                            \
280   (option) == CURLOPT_USERPWD ||                                             \
281   (option) == CURLOPT_XOAUTH2_BEARER ||                                      \
282   0)
283
284/* evaluates to true if option takes a curl_write_callback argument */
285#define _curl_is_write_cb_option(option)                                      \
286  ((option) == CURLOPT_HEADERFUNCTION ||                                      \
287   (option) == CURLOPT_WRITEFUNCTION)
288
289/* evaluates to true if option takes a curl_conv_callback argument */
290#define _curl_is_conv_cb_option(option)                                       \
291  ((option) == CURLOPT_CONV_TO_NETWORK_FUNCTION ||                            \
292   (option) == CURLOPT_CONV_FROM_NETWORK_FUNCTION ||                          \
293   (option) == CURLOPT_CONV_FROM_UTF8_FUNCTION)
294
295/* evaluates to true if option takes a data argument to pass to a callback */
296#define _curl_is_cb_data_option(option)                                       \
297  ((option) == CURLOPT_CHUNK_DATA ||                                          \
298   (option) == CURLOPT_CLOSESOCKETDATA ||                                     \
299   (option) == CURLOPT_DEBUGDATA ||                                           \
300   (option) == CURLOPT_FNMATCH_DATA ||                                        \
301   (option) == CURLOPT_HEADERDATA ||                                          \
302   (option) == CURLOPT_INTERLEAVEDATA ||                                      \
303   (option) == CURLOPT_IOCTLDATA ||                                           \
304   (option) == CURLOPT_OPENSOCKETDATA ||                                      \
305   (option) == CURLOPT_PRIVATE ||                                             \
306   (option) == CURLOPT_PROGRESSDATA ||                                        \
307   (option) == CURLOPT_READDATA ||                                            \
308   (option) == CURLOPT_SEEKDATA ||                                            \
309   (option) == CURLOPT_SOCKOPTDATA ||                                         \
310   (option) == CURLOPT_SSH_KEYDATA ||                                         \
311   (option) == CURLOPT_SSL_CTX_DATA ||                                        \
312   (option) == CURLOPT_WRITEDATA ||                                           \
313   0)
314
315/* evaluates to true if option takes a POST data argument (void* or char*) */
316#define _curl_is_postfields_option(option)                                    \
317  ((option) == CURLOPT_POSTFIELDS ||                                          \
318   (option) == CURLOPT_COPYPOSTFIELDS ||                                      \
319   0)
320
321/* evaluates to true if option takes a struct curl_slist * argument */
322#define _curl_is_slist_option(option)                                         \
323  ((option) == CURLOPT_HTTP200ALIASES ||                                      \
324   (option) == CURLOPT_HTTPHEADER ||                                          \
325   (option) == CURLOPT_MAIL_RCPT ||                                           \
326   (option) == CURLOPT_POSTQUOTE ||                                           \
327   (option) == CURLOPT_PREQUOTE ||                                            \
328   (option) == CURLOPT_PROXYHEADER ||                                         \
329   (option) == CURLOPT_QUOTE ||                                               \
330   (option) == CURLOPT_RESOLVE ||                                             \
331   (option) == CURLOPT_TELNETOPTIONS ||                                       \
332   0)
333
334/* groups of curl_easy_getinfo infos that take the same type of argument */
335
336/* evaluates to true if info expects a pointer to char * argument */
337#define _curl_is_string_info(info)                                            \
338  (CURLINFO_STRING < (info) && (info) < CURLINFO_LONG)
339
340/* evaluates to true if info expects a pointer to long argument */
341#define _curl_is_long_info(info)                                              \
342  (CURLINFO_LONG < (info) && (info) < CURLINFO_DOUBLE)
343
344/* evaluates to true if info expects a pointer to double argument */
345#define _curl_is_double_info(info)                                            \
346  (CURLINFO_DOUBLE < (info) && (info) < CURLINFO_SLIST)
347
348/* true if info expects a pointer to struct curl_slist * argument */
349#define _curl_is_slist_info(info)                                             \
350  (CURLINFO_SLIST < (info))
351
352
353/* typecheck helpers -- check whether given expression has requested type*/
354
355/* For pointers, you can use the _curl_is_ptr/_curl_is_arr macros,
356 * otherwise define a new macro. Search for __builtin_types_compatible_p
357 * in the GCC manual.
358 * NOTE: these macros MUST NOT EVALUATE their arguments! The argument is
359 * the actual expression passed to the curl_easy_setopt macro. This
360 * means that you can only apply the sizeof and __typeof__ operators, no
361 * == or whatsoever.
362 */
363
364/* XXX: should evaluate to true iff expr is a pointer */
365#define _curl_is_any_ptr(expr)                                                \
366  (sizeof(expr) == sizeof(void*))
367
368/* evaluates to true if expr is NULL */
369/* XXX: must not evaluate expr, so this check is not accurate */
370#define _curl_is_NULL(expr)                                                   \
371  (__builtin_types_compatible_p(__typeof__(expr), __typeof__(NULL)))
372
373/* evaluates to true if expr is type*, const type* or NULL */
374#define _curl_is_ptr(expr, type)                                              \
375  (_curl_is_NULL(expr) ||                                                     \
376   __builtin_types_compatible_p(__typeof__(expr), type *) ||                  \
377   __builtin_types_compatible_p(__typeof__(expr), const type *))
378
379/* evaluates to true if expr is one of type[], type*, NULL or const type* */
380#define _curl_is_arr(expr, type)                                              \
381  (_curl_is_ptr((expr), type) ||                                              \
382   __builtin_types_compatible_p(__typeof__(expr), type []))
383
384/* evaluates to true if expr is a string */
385#define _curl_is_string(expr)                                                 \
386  (_curl_is_arr((expr), char) ||                                              \
387   _curl_is_arr((expr), signed char) ||                                       \
388   _curl_is_arr((expr), unsigned char))
389
390/* evaluates to true if expr is a long (no matter the signedness)
391 * XXX: for now, int is also accepted (and therefore short and char, which
392 * are promoted to int when passed to a variadic function) */
393#define _curl_is_long(expr)                                                   \
394  (__builtin_types_compatible_p(__typeof__(expr), long) ||                    \
395   __builtin_types_compatible_p(__typeof__(expr), signed long) ||             \
396   __builtin_types_compatible_p(__typeof__(expr), unsigned long) ||           \
397   __builtin_types_compatible_p(__typeof__(expr), int) ||                     \
398   __builtin_types_compatible_p(__typeof__(expr), signed int) ||              \
399   __builtin_types_compatible_p(__typeof__(expr), unsigned int) ||            \
400   __builtin_types_compatible_p(__typeof__(expr), short) ||                   \
401   __builtin_types_compatible_p(__typeof__(expr), signed short) ||            \
402   __builtin_types_compatible_p(__typeof__(expr), unsigned short) ||          \
403   __builtin_types_compatible_p(__typeof__(expr), char) ||                    \
404   __builtin_types_compatible_p(__typeof__(expr), signed char) ||             \
405   __builtin_types_compatible_p(__typeof__(expr), unsigned char))
406
407/* evaluates to true if expr is of type curl_off_t */
408#define _curl_is_off_t(expr)                                                  \
409  (__builtin_types_compatible_p(__typeof__(expr), curl_off_t))
410
411/* evaluates to true if expr is abuffer suitable for CURLOPT_ERRORBUFFER */
412/* XXX: also check size of an char[] array? */
413#define _curl_is_error_buffer(expr)                                           \
414  (_curl_is_NULL(expr) ||                                                     \
415   __builtin_types_compatible_p(__typeof__(expr), char *) ||                  \
416   __builtin_types_compatible_p(__typeof__(expr), char[]))
417
418/* evaluates to true if expr is of type (const) void* or (const) FILE* */
419#if 0
420#define _curl_is_cb_data(expr)                                                \
421  (_curl_is_ptr((expr), void) ||                                              \
422   _curl_is_ptr((expr), FILE))
423#else /* be less strict */
424#define _curl_is_cb_data(expr)                                                \
425  _curl_is_any_ptr(expr)
426#endif
427
428/* evaluates to true if expr is of type FILE* */
429#define _curl_is_FILE(expr)                                                   \
430  (__builtin_types_compatible_p(__typeof__(expr), FILE *))
431
432/* evaluates to true if expr can be passed as POST data (void* or char*) */
433#define _curl_is_postfields(expr)                                             \
434  (_curl_is_ptr((expr), void) ||                                              \
435   _curl_is_arr((expr), char))
436
437/* FIXME: the whole callback checking is messy...
438 * The idea is to tolerate char vs. void and const vs. not const
439 * pointers in arguments at least
440 */
441/* helper: __builtin_types_compatible_p distinguishes between functions and
442 * function pointers, hide it */
443#define _curl_callback_compatible(func, type)                                 \
444  (__builtin_types_compatible_p(__typeof__(func), type) ||                    \
445   __builtin_types_compatible_p(__typeof__(func), type*))
446
447/* evaluates to true if expr is of type curl_read_callback or "similar" */
448#define _curl_is_read_cb(expr)                                          \
449  (_curl_is_NULL(expr) ||                                                     \
450   __builtin_types_compatible_p(__typeof__(expr), __typeof__(fread)) ||       \
451   __builtin_types_compatible_p(__typeof__(expr), curl_read_callback) ||      \
452   _curl_callback_compatible((expr), _curl_read_callback1) ||                 \
453   _curl_callback_compatible((expr), _curl_read_callback2) ||                 \
454   _curl_callback_compatible((expr), _curl_read_callback3) ||                 \
455   _curl_callback_compatible((expr), _curl_read_callback4) ||                 \
456   _curl_callback_compatible((expr), _curl_read_callback5) ||                 \
457   _curl_callback_compatible((expr), _curl_read_callback6))
458typedef size_t (_curl_read_callback1)(char *, size_t, size_t, void*);
459typedef size_t (_curl_read_callback2)(char *, size_t, size_t, const void*);
460typedef size_t (_curl_read_callback3)(char *, size_t, size_t, FILE*);
461typedef size_t (_curl_read_callback4)(void *, size_t, size_t, void*);
462typedef size_t (_curl_read_callback5)(void *, size_t, size_t, const void*);
463typedef size_t (_curl_read_callback6)(void *, size_t, size_t, FILE*);
464
465/* evaluates to true if expr is of type curl_write_callback or "similar" */
466#define _curl_is_write_cb(expr)                                               \
467  (_curl_is_read_cb(expr) ||                                            \
468   __builtin_types_compatible_p(__typeof__(expr), __typeof__(fwrite)) ||      \
469   __builtin_types_compatible_p(__typeof__(expr), curl_write_callback) ||     \
470   _curl_callback_compatible((expr), _curl_write_callback1) ||                \
471   _curl_callback_compatible((expr), _curl_write_callback2) ||                \
472   _curl_callback_compatible((expr), _curl_write_callback3) ||                \
473   _curl_callback_compatible((expr), _curl_write_callback4) ||                \
474   _curl_callback_compatible((expr), _curl_write_callback5) ||                \
475   _curl_callback_compatible((expr), _curl_write_callback6))
476typedef size_t (_curl_write_callback1)(const char *, size_t, size_t, void*);
477typedef size_t (_curl_write_callback2)(const char *, size_t, size_t,
478                                       const void*);
479typedef size_t (_curl_write_callback3)(const char *, size_t, size_t, FILE*);
480typedef size_t (_curl_write_callback4)(const void *, size_t, size_t, void*);
481typedef size_t (_curl_write_callback5)(const void *, size_t, size_t,
482                                       const void*);
483typedef size_t (_curl_write_callback6)(const void *, size_t, size_t, FILE*);
484
485/* evaluates to true if expr is of type curl_ioctl_callback or "similar" */
486#define _curl_is_ioctl_cb(expr)                                         \
487  (_curl_is_NULL(expr) ||                                                     \
488   __builtin_types_compatible_p(__typeof__(expr), curl_ioctl_callback) ||     \
489   _curl_callback_compatible((expr), _curl_ioctl_callback1) ||                \
490   _curl_callback_compatible((expr), _curl_ioctl_callback2) ||                \
491   _curl_callback_compatible((expr), _curl_ioctl_callback3) ||                \
492   _curl_callback_compatible((expr), _curl_ioctl_callback4))
493typedef curlioerr (_curl_ioctl_callback1)(CURL *, int, void*);
494typedef curlioerr (_curl_ioctl_callback2)(CURL *, int, const void*);
495typedef curlioerr (_curl_ioctl_callback3)(CURL *, curliocmd, void*);
496typedef curlioerr (_curl_ioctl_callback4)(CURL *, curliocmd, const void*);
497
498/* evaluates to true if expr is of type curl_sockopt_callback or "similar" */
499#define _curl_is_sockopt_cb(expr)                                       \
500  (_curl_is_NULL(expr) ||                                                     \
501   __builtin_types_compatible_p(__typeof__(expr), curl_sockopt_callback) ||   \
502   _curl_callback_compatible((expr), _curl_sockopt_callback1) ||              \
503   _curl_callback_compatible((expr), _curl_sockopt_callback2))
504typedef int (_curl_sockopt_callback1)(void *, curl_socket_t, curlsocktype);
505typedef int (_curl_sockopt_callback2)(const void *, curl_socket_t,
506                                      curlsocktype);
507
508/* evaluates to true if expr is of type curl_opensocket_callback or
509   "similar" */
510#define _curl_is_opensocket_cb(expr)                                    \
511  (_curl_is_NULL(expr) ||                                                     \
512   __builtin_types_compatible_p(__typeof__(expr), curl_opensocket_callback) ||\
513   _curl_callback_compatible((expr), _curl_opensocket_callback1) ||           \
514   _curl_callback_compatible((expr), _curl_opensocket_callback2) ||           \
515   _curl_callback_compatible((expr), _curl_opensocket_callback3) ||           \
516   _curl_callback_compatible((expr), _curl_opensocket_callback4))
517typedef curl_socket_t (_curl_opensocket_callback1)
518  (void *, curlsocktype, struct curl_sockaddr *);
519typedef curl_socket_t (_curl_opensocket_callback2)
520  (void *, curlsocktype, const struct curl_sockaddr *);
521typedef curl_socket_t (_curl_opensocket_callback3)
522  (const void *, curlsocktype, struct curl_sockaddr *);
523typedef curl_socket_t (_curl_opensocket_callback4)
524  (const void *, curlsocktype, const struct curl_sockaddr *);
525
526/* evaluates to true if expr is of type curl_progress_callback or "similar" */
527#define _curl_is_progress_cb(expr)                                      \
528  (_curl_is_NULL(expr) ||                                                     \
529   __builtin_types_compatible_p(__typeof__(expr), curl_progress_callback) ||  \
530   _curl_callback_compatible((expr), _curl_progress_callback1) ||             \
531   _curl_callback_compatible((expr), _curl_progress_callback2))
532typedef int (_curl_progress_callback1)(void *,
533    double, double, double, double);
534typedef int (_curl_progress_callback2)(const void *,
535    double, double, double, double);
536
537/* evaluates to true if expr is of type curl_debug_callback or "similar" */
538#define _curl_is_debug_cb(expr)                                         \
539  (_curl_is_NULL(expr) ||                                                     \
540   __builtin_types_compatible_p(__typeof__(expr), curl_debug_callback) ||     \
541   _curl_callback_compatible((expr), _curl_debug_callback1) ||                \
542   _curl_callback_compatible((expr), _curl_debug_callback2) ||                \
543   _curl_callback_compatible((expr), _curl_debug_callback3) ||                \
544   _curl_callback_compatible((expr), _curl_debug_callback4) ||                \
545   _curl_callback_compatible((expr), _curl_debug_callback5) ||                \
546   _curl_callback_compatible((expr), _curl_debug_callback6) ||                \
547   _curl_callback_compatible((expr), _curl_debug_callback7) ||                \
548   _curl_callback_compatible((expr), _curl_debug_callback8))
549typedef int (_curl_debug_callback1) (CURL *,
550    curl_infotype, char *, size_t, void *);
551typedef int (_curl_debug_callback2) (CURL *,
552    curl_infotype, char *, size_t, const void *);
553typedef int (_curl_debug_callback3) (CURL *,
554    curl_infotype, const char *, size_t, void *);
555typedef int (_curl_debug_callback4) (CURL *,
556    curl_infotype, const char *, size_t, const void *);
557typedef int (_curl_debug_callback5) (CURL *,
558    curl_infotype, unsigned char *, size_t, void *);
559typedef int (_curl_debug_callback6) (CURL *,
560    curl_infotype, unsigned char *, size_t, const void *);
561typedef int (_curl_debug_callback7) (CURL *,
562    curl_infotype, const unsigned char *, size_t, void *);
563typedef int (_curl_debug_callback8) (CURL *,
564    curl_infotype, const unsigned char *, size_t, const void *);
565
566/* evaluates to true if expr is of type curl_ssl_ctx_callback or "similar" */
567/* this is getting even messier... */
568#define _curl_is_ssl_ctx_cb(expr)                                       \
569  (_curl_is_NULL(expr) ||                                                     \
570   __builtin_types_compatible_p(__typeof__(expr), curl_ssl_ctx_callback) ||   \
571   _curl_callback_compatible((expr), _curl_ssl_ctx_callback1) ||              \
572   _curl_callback_compatible((expr), _curl_ssl_ctx_callback2) ||              \
573   _curl_callback_compatible((expr), _curl_ssl_ctx_callback3) ||              \
574   _curl_callback_compatible((expr), _curl_ssl_ctx_callback4) ||              \
575   _curl_callback_compatible((expr), _curl_ssl_ctx_callback5) ||              \
576   _curl_callback_compatible((expr), _curl_ssl_ctx_callback6) ||              \
577   _curl_callback_compatible((expr), _curl_ssl_ctx_callback7) ||              \
578   _curl_callback_compatible((expr), _curl_ssl_ctx_callback8))
579typedef CURLcode (_curl_ssl_ctx_callback1)(CURL *, void *, void *);
580typedef CURLcode (_curl_ssl_ctx_callback2)(CURL *, void *, const void *);
581typedef CURLcode (_curl_ssl_ctx_callback3)(CURL *, const void *, void *);
582typedef CURLcode (_curl_ssl_ctx_callback4)(CURL *, const void *, const void *);
583#ifdef HEADER_SSL_H
584/* hack: if we included OpenSSL's ssl.h, we know about SSL_CTX
585 * this will of course break if we're included before OpenSSL headers...
586 */
587typedef CURLcode (_curl_ssl_ctx_callback5)(CURL *, SSL_CTX, void *);
588typedef CURLcode (_curl_ssl_ctx_callback6)(CURL *, SSL_CTX, const void *);
589typedef CURLcode (_curl_ssl_ctx_callback7)(CURL *, const SSL_CTX, void *);
590typedef CURLcode (_curl_ssl_ctx_callback8)(CURL *, const SSL_CTX,
591                                           const void *);
592#else
593typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback5;
594typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback6;
595typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback7;
596typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback8;
597#endif
598
599/* evaluates to true if expr is of type curl_conv_callback or "similar" */
600#define _curl_is_conv_cb(expr)                                          \
601  (_curl_is_NULL(expr) ||                                                     \
602   __builtin_types_compatible_p(__typeof__(expr), curl_conv_callback) ||      \
603   _curl_callback_compatible((expr), _curl_conv_callback1) ||                 \
604   _curl_callback_compatible((expr), _curl_conv_callback2) ||                 \
605   _curl_callback_compatible((expr), _curl_conv_callback3) ||                 \
606   _curl_callback_compatible((expr), _curl_conv_callback4))
607typedef CURLcode (*_curl_conv_callback1)(char *, size_t length);
608typedef CURLcode (*_curl_conv_callback2)(const char *, size_t length);
609typedef CURLcode (*_curl_conv_callback3)(void *, size_t length);
610typedef CURLcode (*_curl_conv_callback4)(const void *, size_t length);
611
612/* evaluates to true if expr is of type curl_seek_callback or "similar" */
613#define _curl_is_seek_cb(expr)                                          \
614  (_curl_is_NULL(expr) ||                                                     \
615   __builtin_types_compatible_p(__typeof__(expr), curl_seek_callback) ||      \
616   _curl_callback_compatible((expr), _curl_seek_callback1) ||                 \
617   _curl_callback_compatible((expr), _curl_seek_callback2))
618typedef CURLcode (*_curl_seek_callback1)(void *, curl_off_t, int);
619typedef CURLcode (*_curl_seek_callback2)(const void *, curl_off_t, int);
620
621
622#endif /* __CURL_TYPECHECK_GCC_H */
623