typecheck-gcc.h 43 KB

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