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 - 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))
 458 typedef size_t (_curl_read_callback1)(char *, size_t, size_t, void*);
 459 typedef size_t (_curl_read_callback2)(char *, size_t, size_t, const void*);
 460 typedef size_t (_curl_read_callback3)(char *, size_t, size_t, FILE*);
 461 typedef size_t (_curl_read_callback4)(void *, size_t, size_t, void*);
 462 typedef size_t (_curl_read_callback5)(void *, size_t, size_t, const void*);
 463 typedef 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))
 476 typedef size_t (_curl_write_callback1)(const char *, size_t, size_t, void*);
 477 typedef size_t (_curl_write_callback2)(const char *, size_t, size_t,
 478                                        const void*);
 479 typedef size_t (_curl_write_callback3)(const char *, size_t, size_t, FILE*);
 480 typedef size_t (_curl_write_callback4)(const void *, size_t, size_t, void*);
 481 typedef size_t (_curl_write_callback5)(const void *, size_t, size_t,
 482                                        const void*);
 483 typedef 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))
 493 typedef curlioerr (_curl_ioctl_callback1)(CURL *, int, void*);
 494 typedef curlioerr (_curl_ioctl_callback2)(CURL *, int, const void*);
 495 typedef curlioerr (_curl_ioctl_callback3)(CURL *, curliocmd, void*);
 496 typedef 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))
 504 typedef int (_curl_sockopt_callback1)(void *, curl_socket_t, curlsocktype);
 505 typedef 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))
 517 typedef curl_socket_t (_curl_opensocket_callback1)
 518   (void *, curlsocktype, struct curl_sockaddr *);
 519 typedef curl_socket_t (_curl_opensocket_callback2)
 520   (void *, curlsocktype, const struct curl_sockaddr *);
 521 typedef curl_socket_t (_curl_opensocket_callback3)
 522   (const void *, curlsocktype, struct curl_sockaddr *);
 523 typedef 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))
 532 typedef int (_curl_progress_callback1)(void *,
 533     double, double, double, double);
 534 typedef 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))
 549 typedef int (_curl_debug_callback1) (CURL *,
 550     curl_infotype, char *, size_t, void *);
 551 typedef int (_curl_debug_callback2) (CURL *,
 552     curl_infotype, char *, size_t, const void *);
 553 typedef int (_curl_debug_callback3) (CURL *,
 554     curl_infotype, const char *, size_t, void *);
 555 typedef int (_curl_debug_callback4) (CURL *,
 556     curl_infotype, const char *, size_t, const void *);
 557 typedef int (_curl_debug_callback5) (CURL *,
 558     curl_infotype, unsigned char *, size_t, void *);
 559 typedef int (_curl_debug_callback6) (CURL *,
 560     curl_infotype, unsigned char *, size_t, const void *);
 561 typedef int (_curl_debug_callback7) (CURL *,
 562     curl_infotype, const unsigned char *, size_t, void *);
 563 typedef 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))
 579 typedef CURLcode (_curl_ssl_ctx_callback1)(CURL *, void *, void *);
 580 typedef CURLcode (_curl_ssl_ctx_callback2)(CURL *, void *, const void *);
 581 typedef CURLcode (_curl_ssl_ctx_callback3)(CURL *, const void *, void *);
 582 typedef 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  */
 587 typedef CURLcode (_curl_ssl_ctx_callback5)(CURL *, SSL_CTX, void *);
 588 typedef CURLcode (_curl_ssl_ctx_callback6)(CURL *, SSL_CTX, const void *);
 589 typedef CURLcode (_curl_ssl_ctx_callback7)(CURL *, const SSL_CTX, void *);
 590 typedef CURLcode (_curl_ssl_ctx_callback8)(CURL *, const SSL_CTX,
 591                                            const void *);
 592 #else
 593 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback5;
 594 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback6;
 595 typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback7;
 596 typedef _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))
 607 typedef CURLcode (*_curl_conv_callback1)(char *, size_t length);
 608 typedef CURLcode (*_curl_conv_callback2)(const char *, size_t length);
 609 typedef CURLcode (*_curl_conv_callback3)(void *, size_t length);
 610 typedef 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))
 618 typedef CURLcode (*_curl_seek_callback1)(void *, curl_off_t, int);
 619 typedef CURLcode (*_curl_seek_callback2)(const void *, curl_off_t, int);
 620
 621
 622 #endif /* __CURL_TYPECHECK_GCC_H */