include/curl/typecheck-gcc.h

   1 #ifndef __CURL_TYPECHECK_GCC_H
   2 #define __CURL_TYPECHECK_GCC_H
   3 /***************************************************************************
   4  *                                  _   _ ____  _
   5  *  Project                     ___| | | |  _ \| |
   6  *                             / __| | | | |_) | |
   7  *                            | (__| |_| |  _ <| |___
   8  *                             \___|\___/|_| \_\_____|
   9  *
  10  * Copyright (C) 1998 - 2016, 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 *' "
 190               "argument for this option")
 191 _CURL_WARNING(_curl_easy_setopt_err_curl_slist,
 192   "curl_easy_setopt expects a 'struct curl_slist *' argument for this option")
 193 _CURL_WARNING(_curl_easy_setopt_err_CURLSH,
 194   "curl_easy_setopt expects a CURLSH* argument for this option")
 195
 196 _CURL_WARNING(_curl_easy_getinfo_err_string,
 197   "curl_easy_getinfo expects a pointer to 'char *' for this info")
 198 _CURL_WARNING(_curl_easy_getinfo_err_long,
 199   "curl_easy_getinfo expects a pointer to long for this info")
 200 _CURL_WARNING(_curl_easy_getinfo_err_double,
 201   "curl_easy_getinfo expects a pointer to double for this info")
 202 _CURL_WARNING(_curl_easy_getinfo_err_curl_slist,
 203   "curl_easy_getinfo expects a pointer to 'struct curl_slist *' for this info")
 204
 205 /* groups of curl_easy_setops options that take the same type of argument */
 206
 207 /* To add a new option to one of the groups, just add
 208  *   (option) == CURLOPT_SOMETHING
 209  * to the or-expression. If the option takes a long or curl_off_t, you don't
 210  * have to do anything
 211  */
 212
 213 /* evaluates to true if option takes a long argument */
 214 #define _curl_is_long_option(option)                                          \
 215   (0 < (option) && (option) < CURLOPTTYPE_OBJECTPOINT)
 216
 217 #define _curl_is_off_t_option(option)                                         \
 218   ((option) > CURLOPTTYPE_OFF_T)
 219
 220 /* evaluates to true if option takes a char* argument */
 221 #define _curl_is_string_option(option)                                        \
 222   ((option) == CURLOPT_ABSTRACT_UNIX_SOCKET ||                                \
 223    (option) == CURLOPT_ACCEPT_ENCODING ||                                     \
 224    (option) == CURLOPT_CAINFO ||                                              \
 225    (option) == CURLOPT_CAPATH ||                                              \
 226    (option) == CURLOPT_COOKIE ||                                              \
 227    (option) == CURLOPT_COOKIEFILE ||                                          \
 228    (option) == CURLOPT_COOKIEJAR ||                                           \
 229    (option) == CURLOPT_COOKIELIST ||                                          \
 230    (option) == CURLOPT_CRLFILE ||                                             \
 231    (option) == CURLOPT_CUSTOMREQUEST ||                                       \
 232    (option) == CURLOPT_DEFAULT_PROTOCOL ||                                    \
 233    (option) == CURLOPT_DNS_INTERFACE ||                                       \
 234    (option) == CURLOPT_DNS_LOCAL_IP4 ||                                       \
 235    (option) == CURLOPT_DNS_LOCAL_IP6 ||                                       \
 236    (option) == CURLOPT_DNS_SERVERS ||                                         \
 237    (option) == CURLOPT_EGDSOCKET ||                                           \
 238    (option) == CURLOPT_FTPPORT ||                                             \
 239    (option) == CURLOPT_FTP_ACCOUNT ||                                         \
 240    (option) == CURLOPT_FTP_ALTERNATIVE_TO_USER ||                             \
 241    (option) == CURLOPT_INTERFACE ||                                           \
 242    (option) == CURLOPT_ISSUERCERT ||                                          \
 243    (option) == CURLOPT_KEYPASSWD ||                                           \
 244    (option) == CURLOPT_KRBLEVEL ||                                            \
 245    (option) == CURLOPT_LOGIN_OPTIONS ||                                       \
 246    (option) == CURLOPT_MAIL_AUTH ||                                           \
 247    (option) == CURLOPT_MAIL_FROM ||                                           \
 248    (option) == CURLOPT_NETRC_FILE ||                                          \
 249    (option) == CURLOPT_NOPROXY ||                                             \
 250    (option) == CURLOPT_PASSWORD ||                                            \
 251    (option) == CURLOPT_PINNEDPUBLICKEY ||                                     \
 252    (option) == CURLOPT_PROXY ||                                               \
 253    (option) == CURLOPT_PROXYPASSWORD ||                                       \
 254    (option) == CURLOPT_PROXYUSERNAME ||                                       \
 255    (option) == CURLOPT_PROXYUSERPWD ||                                        \
 256    (option) == CURLOPT_PROXY_SERVICE_NAME ||                                  \
 257    (option) == CURLOPT_RANDOM_FILE ||                                         \
 258    (option) == CURLOPT_RANGE ||                                               \
 259    (option) == CURLOPT_REFERER ||                                             \
 260    (option) == CURLOPT_RTSP_SESSION_ID ||                                     \
 261    (option) == CURLOPT_RTSP_STREAM_URI ||                                     \
 262    (option) == CURLOPT_RTSP_TRANSPORT ||                                      \
 263    (option) == CURLOPT_SERVICE_NAME ||                                        \
 264    (option) == CURLOPT_SOCKS5_GSSAPI_SERVICE ||                               \
 265    (option) == CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 ||                             \
 266    (option) == CURLOPT_SSH_KNOWNHOSTS ||                                      \
 267    (option) == CURLOPT_SSH_PRIVATE_KEYFILE ||                                 \
 268    (option) == CURLOPT_SSH_PUBLIC_KEYFILE ||                                  \
 269    (option) == CURLOPT_SSLCERT ||                                             \
 270    (option) == CURLOPT_SSLCERTTYPE ||                                         \
 271    (option) == CURLOPT_SSLENGINE ||                                           \
 272    (option) == CURLOPT_SSLKEY ||                                              \
 273    (option) == CURLOPT_SSLKEYTYPE ||                                          \
 274    (option) == CURLOPT_SSL_CIPHER_LIST ||                                     \
 275    (option) == CURLOPT_TLSAUTH_PASSWORD ||                                    \
 276    (option) == CURLOPT_TLSAUTH_TYPE ||                                        \
 277    (option) == CURLOPT_TLSAUTH_USERNAME ||                                    \
 278    (option) == CURLOPT_UNIX_SOCKET_PATH ||                                    \
 279    (option) == CURLOPT_URL ||                                                 \
 280    (option) == CURLOPT_USERAGENT ||                                           \
 281    (option) == CURLOPT_USERNAME ||                                            \
 282    (option) == CURLOPT_USERPWD ||                                             \
 283    (option) == CURLOPT_XOAUTH2_BEARER ||                                      \
 284    0)
 285
 286 /* evaluates to true if option takes a curl_write_callback argument */
 287 #define _curl_is_write_cb_option(option)                                      \
 288   ((option) == CURLOPT_HEADERFUNCTION ||                                      \
 289    (option) == CURLOPT_WRITEFUNCTION)
 290
 291 /* evaluates to true if option takes a curl_conv_callback argument */
 292 #define _curl_is_conv_cb_option(option)                                       \
 293   ((option) == CURLOPT_CONV_TO_NETWORK_FUNCTION ||                            \
 294    (option) == CURLOPT_CONV_FROM_NETWORK_FUNCTION ||                          \
 295    (option) == CURLOPT_CONV_FROM_UTF8_FUNCTION)
 296
 297 /* evaluates to true if option takes a data argument to pass to a callback */
 298 #define _curl_is_cb_data_option(option)                                       \
 299   ((option) == CURLOPT_CHUNK_DATA ||                                          \
 300    (option) == CURLOPT_CLOSESOCKETDATA ||                                     \
 301    (option) == CURLOPT_DEBUGDATA ||                                           \
 302    (option) == CURLOPT_FNMATCH_DATA ||                                        \
 303    (option) == CURLOPT_HEADERDATA ||                                          \
 304    (option) == CURLOPT_INTERLEAVEDATA ||                                      \
 305    (option) == CURLOPT_IOCTLDATA ||                                           \
 306    (option) == CURLOPT_OPENSOCKETDATA ||                                      \
 307    (option) == CURLOPT_PRIVATE ||                                             \
 308    (option) == CURLOPT_PROGRESSDATA ||                                        \
 309    (option) == CURLOPT_READDATA ||                                            \
 310    (option) == CURLOPT_SEEKDATA ||                                            \
 311    (option) == CURLOPT_SOCKOPTDATA ||                                         \
 312    (option) == CURLOPT_SSH_KEYDATA ||                                         \
 313    (option) == CURLOPT_SSL_CTX_DATA ||                                        \
 314    (option) == CURLOPT_WRITEDATA ||                                           \
 315    0)
 316
 317 /* evaluates to true if option takes a POST data argument (void* or char*) */
 318 #define _curl_is_postfields_option(option)                                    \
 319   ((option) == CURLOPT_POSTFIELDS ||                                          \
 320    (option) == CURLOPT_COPYPOSTFIELDS ||                                      \
 321    0)
 322
 323 /* evaluates to true if option takes a struct curl_slist * argument */
 324 #define _curl_is_slist_option(option)                                         \
 325   ((option) == CURLOPT_HTTP200ALIASES ||                                      \
 326    (option) == CURLOPT_HTTPHEADER ||                                          \
 327    (option) == CURLOPT_MAIL_RCPT ||                                           \
 328    (option) == CURLOPT_POSTQUOTE ||                                           \
 329    (option) == CURLOPT_PREQUOTE ||                                            \
 330    (option) == CURLOPT_PROXYHEADER ||                                         \
 331    (option) == CURLOPT_QUOTE ||                                               \
 332    (option) == CURLOPT_RESOLVE ||                                             \
 333    (option) == CURLOPT_TELNETOPTIONS ||                                       \
 334    0)
 335
 336 /* groups of curl_easy_getinfo infos that take the same type of argument */
 337
 338 /* evaluates to true if info expects a pointer to char * argument */
 339 #define _curl_is_string_info(info)                                            \
 340   (CURLINFO_STRING < (info) && (info) < CURLINFO_LONG)
 341
 342 /* evaluates to true if info expects a pointer to long argument */
 343 #define _curl_is_long_info(info)                                              \
 344   (CURLINFO_LONG < (info) && (info) < CURLINFO_DOUBLE)
 345
 346 /* evaluates to true if info expects a pointer to double argument */
 347 #define _curl_is_double_info(info)                                            \
 348   (CURLINFO_DOUBLE < (info) && (info) < CURLINFO_SLIST)
 349
 350 /* true if info expects a pointer to struct curl_slist * argument */
 351 #define _curl_is_slist_info(info)                                             \
 352   (CURLINFO_SLIST < (info))
 353
 354
 355 /* typecheck helpers -- check whether given expression has requested type*/
 356
 357 /* For pointers, you can use the _curl_is_ptr/_curl_is_arr macros,
 358  * otherwise define a new macro. Search for __builtin_types_compatible_p
 359  * in the GCC manual.
 360  * NOTE: these macros MUST NOT EVALUATE their arguments! The argument is
 361  * the actual expression passed to the curl_easy_setopt macro. This
 362  * means that you can only apply the sizeof and __typeof__ operators, no
 363  * == or whatsoever.
 364  */
 365
 366 /* XXX: should evaluate to true iff expr is a pointer */
 367 #define _curl_is_any_ptr(expr)                                                \
 368   (sizeof(expr) == sizeof(void *))
 369
 370 /* evaluates to true if expr is NULL */
 371 /* XXX: must not evaluate expr, so this check is not accurate */
 372 #define _curl_is_NULL(expr)                                                   \
 373   (__builtin_types_compatible_p(__typeof__(expr), __typeof__(NULL)))
 374
 375 /* evaluates to true if expr is type*, const type* or NULL */
 376 #define _curl_is_ptr(expr, type)                                              \
 377   (_curl_is_NULL(expr) ||                                                     \
 378    __builtin_types_compatible_p(__typeof__(expr), type *) ||                  \
 379    __builtin_types_compatible_p(__typeof__(expr), const type *))
 380
 381 /* evaluates to true if expr is one of type[], type*, NULL or const type* */
 382 #define _curl_is_arr(expr, type)                                              \
 383   (_curl_is_ptr((expr), type) ||                                              \
 384    __builtin_types_compatible_p(__typeof__(expr), type []))
 385
 386 /* evaluates to true if expr is a string */
 387 #define _curl_is_string(expr)                                                 \
 388   (_curl_is_arr((expr), char) ||                                              \
 389    _curl_is_arr((expr), signed char) ||                                       \
 390    _curl_is_arr((expr), unsigned char))
 391
 392 /* evaluates to true if expr is a long (no matter the signedness)
 393  * XXX: for now, int is also accepted (and therefore short and char, which
 394  * are promoted to int when passed to a variadic function) */
 395 #define _curl_is_long(expr)                                                   \
 396   (__builtin_types_compatible_p(__typeof__(expr), long) ||                    \
 397    __builtin_types_compatible_p(__typeof__(expr), signed long) ||             \
 398    __builtin_types_compatible_p(__typeof__(expr), unsigned long) ||           \
 399    __builtin_types_compatible_p(__typeof__(expr), int) ||                     \
 400    __builtin_types_compatible_p(__typeof__(expr), signed int) ||              \
 401    __builtin_types_compatible_p(__typeof__(expr), unsigned int) ||            \
 402    __builtin_types_compatible_p(__typeof__(expr), short) ||                   \
 403    __builtin_types_compatible_p(__typeof__(expr), signed short) ||            \
 404    __builtin_types_compatible_p(__typeof__(expr), unsigned short) ||          \
 405    __builtin_types_compatible_p(__typeof__(expr), char) ||                    \
 406    __builtin_types_compatible_p(__typeof__(expr), signed char) ||             \
 407    __builtin_types_compatible_p(__typeof__(expr), unsigned char))
 408
 409 /* evaluates to true if expr is of type curl_off_t */
 410 #define _curl_is_off_t(expr)                                                  \
 411   (__builtin_types_compatible_p(__typeof__(expr), curl_off_t))
 412
 413 /* evaluates to true if expr is abuffer suitable for CURLOPT_ERRORBUFFER */
 414 /* XXX: also check size of an char[] array? */
 415 #define _curl_is_error_buffer(expr)                                           \
 416   (_curl_is_NULL(expr) ||                                                     \
 417    __builtin_types_compatible_p(__typeof__(expr), char *) ||                  \
 418    __builtin_types_compatible_p(__typeof__(expr), char[]))
 419
 420 /* evaluates to true if expr is of type (const) void* or (const) FILE* */
 421 #if 0
 422 #define _curl_is_cb_data(expr)                                                \
 423   (_curl_is_ptr((expr), void) ||                                              \
 424    _curl_is_ptr((expr), FILE))
 425 #else /* be less strict */
 426 #define _curl_is_cb_data(expr)                                                \
 427   _curl_is_any_ptr(expr)
 428 #endif
 429
 430 /* evaluates to true if expr is of type FILE* */
 431 #define _curl_is_FILE(expr)                                                   \
 432   (__builtin_types_compatible_p(__typeof__(expr), FILE *))
 433
 434 /* evaluates to true if expr can be passed as POST data (void* or char*) */
 435 #define _curl_is_postfields(expr)                                             \
 436   (_curl_is_ptr((expr), void) ||                                              \
 437    _curl_is_arr((expr), char))
 438
 439 /* FIXME: the whole callback checking is messy...
 440  * The idea is to tolerate char vs. void and const vs. not const
 441  * pointers in arguments at least
 442  */
 443 /* helper: __builtin_types_compatible_p distinguishes between functions and
 444  * function pointers, hide it */
 445 #define _curl_callback_compatible(func, type)                                 \
 446   (__builtin_types_compatible_p(__typeof__(func), type) ||                    \
 447    __builtin_types_compatible_p(__typeof__(func), type*))
 448
 449 /* evaluates to true if expr is of type curl_read_callback or "similar" */
 450 #define _curl_is_read_cb(expr)                                          \
 451   (_curl_is_NULL(expr) ||                                                     \
 452    __builtin_types_compatible_p(__typeof__(expr), __typeof__(fread)) ||       \
 453    __builtin_types_compatible_p(__typeof__(expr), curl_read_callback) ||      \
 454    _curl_callback_compatible((expr), _curl_read_callback1) ||                 \
 455    _curl_callback_compatible((expr), _curl_read_callback2) ||                 \
 456    _curl_callback_compatible((expr), _curl_read_callback3) ||                 \
 457    _curl_callback_compatible((expr), _curl_read_callback4) ||                 \
 458    _curl_callback_compatible((expr), _curl_read_callback5) ||                 \
 459    _curl_callback_compatible((expr), _curl_read_callback6))
 460 typedef size_t (_curl_read_callback1)(char *, size_t, size_t, void *);
 461 typedef size_t (_curl_read_callback2)(char *, size_t, size_t, const void *);
 462 typedef size_t (_curl_read_callback3)(char *, size_t, size_t, FILE *);
 463 typedef size_t (_curl_read_callback4)(void *, size_t, size_t, void *);
 464 typedef size_t (_curl_read_callback5)(void *, size_t, size_t, const void *);
 465 typedef size_t (_curl_read_callback6)(void *, size_t, size_t, FILE *);
 466
 467 /* evaluates to true if expr is of type curl_write_callback or "similar" */
 468 #define _curl_is_write_cb(expr)                                               \
 469   (_curl_is_read_cb(expr) ||                                            \
 470    __builtin_types_compatible_p(__typeof__(expr), __typeof__(fwrite)) ||      \
 471    __builtin_types_compatible_p(__typeof__(expr), curl_write_callback) ||     \
 472    _curl_callback_compatible((expr), _curl_write_callback1) ||                \
 473    _curl_callback_compatible((expr), _curl_write_callback2) ||                \
 474    _curl_callback_compatible((expr), _curl_write_callback3) ||                \
 475    _curl_callback_compatible((expr), _curl_write_callback4) ||                \
 476    _curl_callback_compatible((expr), _curl_write_callback5) ||                \
 477    _curl_callback_compatible((expr), _curl_write_callback6))
 478 typedef size_t (_curl_write_callback1)(const char *, size_t, size_t, void *);
 479 typedef size_t (_curl_write_callback2)(const char *, size_t, size_t,
 480                                        const void *);
 481 typedef size_t (_curl_write_callback3)(const char *, size_t, size_t, FILE *);
 482 typedef size_t (_curl_write_callback4)(const void *, size_t, size_t, void *);
 483 typedef size_t (_curl_write_callback5)(const void *, size_t, size_t,
 484                                        const void *);
 485 typedef size_t (_curl_write_callback6)(const void *, size_t, size_t, FILE *);
 486
 487 /* evaluates to true if expr is of type curl_ioctl_callback or "similar" */
 488 #define _curl_is_ioctl_cb(expr)                                         \
 489   (_curl_is_NULL(expr) ||                                                     \
 490    __builtin_types_compatible_p(__typeof__(expr), curl_ioctl_callback) ||     \
 491    _curl_callback_compatible((expr), _curl_ioctl_callback1) ||                \
 492    _curl_callback_compatible((expr), _curl_ioctl_callback2) ||                \
 493    _curl_callback_compatible((expr), _curl_ioctl_callback3) ||                \
 494    _curl_callback_compatible((expr), _curl_ioctl_callback4))
 495 typedef curlioerr (_curl_ioctl_callback1)(CURL *, int, void *);
 496 typedef curlioerr (_curl_ioctl_callback2)(CURL *, int, const void *);
 497 typedef curlioerr (_curl_ioctl_callback3)(CURL *, curliocmd, void *);
 498 typedef curlioerr (_curl_ioctl_callback4)(CURL *, curliocmd, const void *);
 499
 500 /* evaluates to true if expr is of type curl_sockopt_callback or "similar" */
 501 #define _curl_is_sockopt_cb(expr)                                       \
 502   (_curl_is_NULL(expr) ||                                                     \
 503    __builtin_types_compatible_p(__typeof__(expr), curl_sockopt_callback) ||   \
 504    _curl_callback_compatible((expr), _curl_sockopt_callback1) ||              \
 505    _curl_callback_compatible((expr), _curl_sockopt_callback2))
 506 typedef int (_curl_sockopt_callback1)(void *, curl_socket_t, curlsocktype);
 507 typedef int (_curl_sockopt_callback2)(const void *, curl_socket_t,
 508                                       curlsocktype);
 509
 510 /* evaluates to true if expr is of type curl_opensocket_callback or
 511    "similar" */
 512 #define _curl_is_opensocket_cb(expr)                                    \
 513   (_curl_is_NULL(expr) ||                                                     \
 514    __builtin_types_compatible_p(__typeof__(expr), curl_opensocket_callback) ||\
 515    _curl_callback_compatible((expr), _curl_opensocket_callback1) ||           \
 516    _curl_callback_compatible((expr), _curl_opensocket_callback2) ||           \
 517    _curl_callback_compatible((expr), _curl_opensocket_callback3) ||           \
 518    _curl_callback_compatible((expr), _curl_opensocket_callback4))
 519 typedef curl_socket_t (_curl_opensocket_callback1)
 520   (void *, curlsocktype, struct curl_sockaddr *);
 521 typedef curl_socket_t (_curl_opensocket_callback2)
 522   (void *, curlsocktype, const struct curl_sockaddr *);
 523 typedef curl_socket_t (_curl_opensocket_callback3)
 524   (const void *, curlsocktype, struct curl_sockaddr *);
 525 typedef curl_socket_t (_curl_opensocket_callback4)
 526   (const void *, curlsocktype, const struct curl_sockaddr *);
 527
 528 /* evaluates to true if expr is of type curl_progress_callback or "similar" */
 529 #define _curl_is_progress_cb(expr)                                      \
 530   (_curl_is_NULL(expr) ||                                                     \
 531    __builtin_types_compatible_p(__typeof__(expr), curl_progress_callback) ||  \
 532    _curl_callback_compatible((expr), _curl_progress_callback1) ||             \
 533    _curl_callback_compatible((expr), _curl_progress_callback2))
 534 typedef int (_curl_progress_callback1)(void *,
 535     double, double, double, double);
 536 typedef int (_curl_progress_callback2)(const void *,
 537     double, double, double, double);
 538
 539 /* evaluates to true if expr is of type curl_debug_callback or "similar" */
 540 #define _curl_is_debug_cb(expr)                                         \
 541   (_curl_is_NULL(expr) ||                                                     \
 542    __builtin_types_compatible_p(__typeof__(expr), curl_debug_callback) ||     \
 543    _curl_callback_compatible((expr), _curl_debug_callback1) ||                \
 544    _curl_callback_compatible((expr), _curl_debug_callback2) ||                \
 545    _curl_callback_compatible((expr), _curl_debug_callback3) ||                \
 546    _curl_callback_compatible((expr), _curl_debug_callback4) ||                \
 547    _curl_callback_compatible((expr), _curl_debug_callback5) ||                \
 548    _curl_callback_compatible((expr), _curl_debug_callback6) ||                \
 549    _curl_callback_compatible((expr), _curl_debug_callback7) ||                \
 550    _curl_callback_compatible((expr), _curl_debug_callback8))
 551 typedef int (_curl_debug_callback1) (CURL *,
 552     curl_infotype, char *, size_t, void *);
 553 typedef int (_curl_debug_callback2) (CURL *,
 554     curl_infotype, char *, size_t, const void *);
 555 typedef int (_curl_debug_callback3) (CURL *,
 556     curl_infotype, const char *, size_t, void *);
 557 typedef int (_curl_debug_callback4) (CURL *,
 558     curl_infotype, const char *, size_t, const void *);
 559 typedef int (_curl_debug_callback5) (CURL *,
 560     curl_infotype, unsigned char *, size_t, void *);
 561 typedef int (_curl_debug_callback6) (CURL *,
 562     curl_infotype, unsigned char *, size_t, const void *);
 563 typedef int (_curl_debug_callback7) (CURL *,
 564     curl_infotype, const unsigned char *, size_t, void *);
 565 typedef int (_curl_debug_callback8) (CURL *,
 566     curl_infotype, const unsigned char *, size_t, const void *);
 567
 568 /* evaluates to true if expr is of type curl_ssl_ctx_callback or "similar" */
 569 /* this is getting even messier... */
 570 #define _curl_is_ssl_ctx_cb(expr)                                       \
 571   (_curl_is_NULL(expr) ||                                                     \
 572    __builtin_types_compatible_p(__typeof__(expr), curl_ssl_ctx_callback) ||   \
 573    _curl_callback_compatible((expr), _curl_ssl_ctx_callback1) ||              \
 574    _curl_callback_compatible((expr), _curl_ssl_ctx_callback2) ||              \
 575    _curl_callback_compatible((expr), _curl_ssl_ctx_callback3) ||              \
 576    _curl_callback_compatible((expr), _curl_ssl_ctx_callback4) ||              \
 577    _curl_callback_compatible((expr), _curl_ssl_ctx_callback5) ||              \
 578    _curl_callback_compatible((expr), _curl_ssl_ctx_callback6) ||              \
 579    _curl_callback_compatible((expr), _curl_ssl_ctx_callback7) ||              \
 580    _curl_callback_compatible((expr), _curl_ssl_ctx_callback8))
 581 typedef CURLcode (_curl_ssl_ctx_callback1)(CURL *, void *, void *);
 582 typedef CURLcode (_curl_ssl_ctx_callback2)(CURL *, void *, const void *);
 583 typedef CURLcode (_curl_ssl_ctx_callback3)(CURL *, const void *, void *);
 584 typedef CURLcode (_curl_ssl_ctx_callback4)(CURL *, const void *, const void *);
 585 #ifdef HEADER_SSL_H
 586 /* hack: if we included OpenSSL's ssl.h, we know about SSL_CTX
 587  * this will of course break if we're included before OpenSSL headers...
 588  */
 589 typedef CURLcode (_curl_ssl_ctx_callback5)(CURL *, SSL_CTX, void *);
 590 typedef CURLcode (_curl_ssl_ctx_callback6)(CURL *, SSL_CTX, const void *);
 591 typedef CURLcode (_curl_ssl_ctx_callback7)(CURL *, const SSL_CTX, void *);
 592 typedef CURLcode (_curl_ssl_ctx_callback8)(CURL *, const SSL_CTX,
 593                                            const void *);
 594 #else
 595 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback5;
 596 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback6;
 597 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback7;
 598 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback8;
 599 #endif
 600
 601 /* evaluates to true if expr is of type curl_conv_callback or "similar" */
 602 #define _curl_is_conv_cb(expr)                                          \
 603   (_curl_is_NULL(expr) ||                                                     \
 604    __builtin_types_compatible_p(__typeof__(expr), curl_conv_callback) ||      \
 605    _curl_callback_compatible((expr), _curl_conv_callback1) ||                 \
 606    _curl_callback_compatible((expr), _curl_conv_callback2) ||                 \
 607    _curl_callback_compatible((expr), _curl_conv_callback3) ||                 \
 608    _curl_callback_compatible((expr), _curl_conv_callback4))
 609 typedef CURLcode (*_curl_conv_callback1)(char *, size_t length);
 610 typedef CURLcode (*_curl_conv_callback2)(const char *, size_t length);
 611 typedef CURLcode (*_curl_conv_callback3)(void *, size_t length);
 612 typedef CURLcode (*_curl_conv_callback4)(const void *, size_t length);
 613
 614 /* evaluates to true if expr is of type curl_seek_callback or "similar" */
 615 #define _curl_is_seek_cb(expr)                                          \
 616   (_curl_is_NULL(expr) ||                                                     \
 617    __builtin_types_compatible_p(__typeof__(expr), curl_seek_callback) ||      \
 618    _curl_callback_compatible((expr), _curl_seek_callback1) ||                 \
 619    _curl_callback_compatible((expr), _curl_seek_callback2))
 620 typedef CURLcode (*_curl_seek_callback1)(void *, curl_off_t, int);
 621 typedef CURLcode (*_curl_seek_callback2)(const void *, curl_off_t, int);
 622
 623
 624 #endif /* __CURL_TYPECHECK_GCC_H */