configure guards for HTTP_VERSION_2_PRIOR_KNOWLEDGE
[ocurl.git] / curl.ml
blob4007040f426d994ff07fc9c58b84f95b722bb56a
1 (*
2 * curl.ml
4 * Copyright (c) 2003-2008, Lars Nilsson, <lars@quantumchamaeleon.com>
5 * Copyright (c) 2009, ygrek, <ygrek@autistici.org>
6 *)
8 type t
10 type curlCode =
11 | CURLE_OK
12 | CURLE_UNSUPPORTED_PROTOCOL
13 | CURLE_FAILED_INIT
14 | CURLE_URL_MALFORMAT
15 | CURLE_URL_MALFORMAT_USER
16 | CURLE_COULDNT_RESOLVE_PROXY
17 | CURLE_COULDNT_RESOLVE_HOST
18 | CURLE_COULDNT_CONNECT
19 | CURLE_FTP_WEIRD_SERVER_REPLY
20 | CURLE_FTP_ACCESS_DENIED
21 | CURLE_FTP_USER_PASSWORD_INCORRECT
22 | CURLE_FTP_WEIRD_PASS_REPLY
23 | CURLE_FTP_WEIRD_USER_REPLY
24 | CURLE_FTP_WEIRD_PASV_REPLY
25 | CURLE_FTP_WEIRD_227_FORMAT
26 | CURLE_FTP_CANT_GET_HOST
27 | CURLE_FTP_CANT_RECONNECT
28 | CURLE_FTP_COULDNT_SET_BINARY
29 | CURLE_PARTIAL_FILE
30 | CURLE_FTP_COULDNT_RETR_FILE
31 | CURLE_FTP_WRITE_ERROR
32 | CURLE_FTP_QUOTE_ERROR
33 | CURLE_HTTP_NOT_FOUND
34 | CURLE_WRITE_ERROR
35 | CURLE_MALFORMAT_USER
36 | CURLE_FTP_COULDNT_STOR_FILE
37 | CURLE_READ_ERROR
38 | CURLE_OUT_OF_MEMORY
39 | CURLE_OPERATION_TIMEOUTED
40 | CURLE_FTP_COULDNT_SET_ASCII
41 | CURLE_FTP_PORT_FAILED
42 | CURLE_FTP_COULDNT_USE_REST
43 | CURLE_FTP_COULDNT_GET_SIZE
44 | CURLE_HTTP_RANGE_ERROR
45 | CURLE_HTTP_POST_ERROR
46 | CURLE_SSL_CONNECT_ERROR
47 | CURLE_FTP_BAD_DOWNLOAD_RESUME
48 | CURLE_FILE_COULDNT_READ_FILE
49 | CURLE_LDAP_CANNOT_BIND
50 | CURLE_LDAP_SEARCH_FAILED
51 | CURLE_LIBRARY_NOT_FOUND
52 | CURLE_FUNCTION_NOT_FOUND
53 | CURLE_ABORTED_BY_CALLBACK
54 | CURLE_BAD_FUNCTION_ARGUMENT
55 | CURLE_BAD_CALLING_ORDER
56 | CURLE_HTTP_PORT_FAILED
57 | CURLE_BAD_PASSWORD_ENTERED
58 | CURLE_TOO_MANY_REDIRECTS
59 | CURLE_UNKNOWN_TELNET_OPTION
60 | CURLE_TELNET_OPTION_SYNTAX
61 | CURLE_OBSOLETE
62 | CURLE_SSL_PEER_CERTIFICATE
63 | CURLE_GOT_NOTHING
64 | CURLE_SSL_ENGINE_NOTFOUND
65 | CURLE_SSL_ENGINE_SETFAILED
66 | CURLE_SEND_ERROR
67 | CURLE_RECV_ERROR
68 | CURLE_SHARE_IN_USE
69 | CURLE_SSL_CERTPROBLEM
70 | CURLE_SSL_CIPHER
71 | CURLE_SSL_CACERT
72 | CURLE_BAD_CONTENT_ENCODING
73 | CURLE_LDAP_INVALID_URL
74 | CURLE_FILESIZE_EXCEEDED
75 | CURLE_USE_SSL_FAILED
76 | CURLE_SEND_FAIL_REWIND
77 | CURLE_SSL_ENGINE_INITFAILED
78 | CURLE_LOGIN_DENIED
79 | CURLE_TFTP_NOTFOUND
80 | CURLE_TFTP_PERM
81 | CURLE_REMOTE_DISK_FULL
82 | CURLE_TFTP_ILLEGAL
83 | CURLE_TFTP_UNKNOWNID
84 | CURLE_REMOTE_FILE_EXISTS
85 | CURLE_TFTP_NOSUCHUSER
86 | CURLE_CONV_FAILED
87 | CURLE_CONV_REQD
88 | CURLE_SSL_CACERT_BADFILE
89 | CURLE_REMOTE_FILE_NOT_FOUND
90 | CURLE_SSH
91 | CURLE_SSL_SHUTDOWN_FAILED
92 | CURLE_AGAIN
94 exception CurlException of (curlCode * int * string)
96 type curlNETRCOption =
97 | CURL_NETRC_OPTIONAL
98 | CURL_NETRC_IGNORED
99 | CURL_NETRC_REQUIRED
101 type curlEncoding =
102 | CURL_ENCODING_NONE
103 | CURL_ENCODING_DEFLATE
104 | CURL_ENCODING_GZIP
105 | CURL_ENCODING_ANY
107 type curlContentType =
108 | DEFAULT
109 | CONTENTTYPE of string
111 type curlHTTPPost =
112 | CURLFORM_CONTENT of string * string * curlContentType
113 | CURLFORM_FILECONTENT of string * string * curlContentType
114 | CURLFORM_FILE of string * string * curlContentType
115 | CURLFORM_BUFFER of string * string * string * curlContentType
118 type curlHTTPPost =
119 | CURLFORM_COPYNAME of string
120 | CURLFORM_PTRNAME of string
121 | CURLFORM_NAMELENGTH of int
122 | CURLFORM_COPYCONTENTS of string
123 | CURLFORM_PTRCONTENTS of string
124 | CURLFORM_FILE of string
125 | CURLFORM_FILECONTENT of string
126 | CURLFORM_CONTENTSLENGTH of int
127 | CURLFORM_CONTENTTYPE of string
130 type curlSSLVersion =
131 | SSLVERSION_DEFAULT
132 | SSLVERSION_TLSv1
133 | SSLVERSION_SSLv2
134 | SSLVERSION_SSLv3
135 | SSLVERSION_TLSv1_0
136 | SSLVERSION_TLSv1_1
137 | SSLVERSION_TLSv1_2
138 | SSLVERSION_TLSv1_3
140 type curlTimeCondition =
141 | TIMECOND_NONE
142 | TIMECOND_IFMODSINCE
143 | TIMECOND_IFUNMODSINCE
144 | TIMECOND_LASTMOD
146 type curlKRB4Level =
147 | KRB4_NONE
148 | KRB4_CLEAR
149 | KRB4_SAFE
150 | KRB4_CONFIDENTIAL
151 | KRB4_PRIVATE
153 type curlClosePolicy =
154 | CLOSEPOLICY_OLDEST
155 | CLOSEPOLICY_LEAST_RECENTLY_USED
157 type curlSSLVerifyHost =
158 | SSLVERIFYHOST_NONE
159 | SSLVERIFYHOST_EXISTENCE
160 | SSLVERIFYHOST_HOSTNAME
162 type curlHTTPVersion =
163 | HTTP_VERSION_NONE
164 | HTTP_VERSION_1_0
165 | HTTP_VERSION_1_1
166 | HTTP_VERSION_2
167 | HTTP_VERSION_2TLS
168 | HTTP_VERSION_2_PRIOR_KNOWLEDGE
170 type curlDebugType =
171 | DEBUGTYPE_TEXT
172 | DEBUGTYPE_HEADER_IN
173 | DEBUGTYPE_HEADER_OUT
174 | DEBUGTYPE_DATA_IN
175 | DEBUGTYPE_DATA_OUT
176 | DEBUGTYPE_SSL_DATA_IN
177 | DEBUGTYPE_SSL_DATA_OUT
178 | DEBUGTYPE_END
180 type curlAuth =
181 | CURLAUTH_BASIC
182 | CURLAUTH_DIGEST
183 | CURLAUTH_GSSNEGOTIATE
184 | CURLAUTH_NTLM
185 | CURLAUTH_ANY
186 | CURLAUTH_ANYSAFE
188 type curlIPResolve =
189 | IPRESOLVE_WHATEVER
190 | IPRESOLVE_V4
191 | IPRESOLVE_V6
193 type curlFTPSSL =
194 | FTPSSL_NONE
195 | FTPSSL_TRY
196 | FTPSSL_CONTROL
197 | FTPSSL_ALL
199 type curlFTPSSLAuth =
200 | FTPAUTH_DEFAULT
201 | FTPAUTH_SSL
202 | FTPAUTH_TLS
204 type curlIOCmd =
205 | IOCMD_NOP
206 | IOCMD_RESTARTREAD
208 type curlIOErr =
209 | IOE_OK
210 | IOE_UNKNOWNCMD
211 | IOE_FAILRESTART
213 type curlSeekResult =
214 | SEEKFUNC_OK
215 | SEEKFUNC_FAIL
216 | SEEKFUNC_CANTSEEK
218 type curlFTPMethod =
219 | FTPMETHOD_DEFAULT
220 | FTPMETHOD_MULTICWD
221 | FTPMETHOD_NOCWD
222 | FTPMETHOD_SINGLECWD
224 type curlSSHAuthTypes =
225 | SSHAUTH_ANY
226 | SSHAUTH_PUBLICKEY
227 | SSHAUTH_PASSWORD
228 | SSHAUTH_HOST
229 | SSHAUTH_KEYBOARD
231 type curlFTPSSLCCC =
232 | FTPSSL_CCC_NONE
233 | FTPSSL_CCC_PASSIVE
234 | FTPSSL_CCC_ACTIVE
236 type curlSeek =
237 | SEEK_SET
238 | SEEK_CUR
239 | SEEK_END
241 type curlProxyType =
242 | CURLPROXY_HTTP
243 | CURLPROXY_HTTP_1_0 (** added in 7.19.4 *)
244 | CURLPROXY_SOCKS4 (** added in 7.15.2 *)
245 | CURLPROXY_SOCKS5
246 | CURLPROXY_SOCKS4A (** added in 7.18.0 *)
247 | CURLPROXY_SOCKS5_HOSTNAME (** added in 7.18.0 *)
249 type curlMIMEPartData =
250 | CURLMIME_DATA of string
251 | CURLMIME_FILEDATA of string
253 type curlMIMEEncoding =
254 | CURLMIME_8BIT
255 | CURLMIME_BINARY
256 | CURLMIME_7BIT
257 | CURLMIME_QUOTEDPRINTABLE
258 | CURLMIME_BASE64
259 | CURLMIME_NONE
261 type curlMIMEPart =
263 encoding: curlMIMEEncoding;
264 headers: string list;
265 subparts: curlMIMEPart list;
266 data: curlMIMEPartData;
269 type curlKHMatch =
270 | CURLKHMATCH_OK
271 | CURLKHMATCH_MISMATCH of string
272 | CURLKHMATCH_MISSING
274 type curlKHStat =
275 | CURLKHSTAT_FINE_ADD_TO_FILE
276 | CURLKHSTAT_FINE
277 | CURLKHSTAT_REJECT
278 | CURLKHSTAT_DEFER
280 (** Protocols to enable (via CURLOPT_PROTOCOLS and CURLOPT_REDIR_PROTOCOLS) *)
281 type curlProto =
282 | CURLPROTO_ALL (** enable everything *)
283 | CURLPROTO_HTTP
284 | CURLPROTO_HTTPS
285 | CURLPROTO_FTP
286 | CURLPROTO_FTPS
287 | CURLPROTO_SCP
288 | CURLPROTO_SFTP
289 | CURLPROTO_TELNET
290 | CURLPROTO_LDAP
291 | CURLPROTO_LDAPS
292 | CURLPROTO_DICT
293 | CURLPROTO_FILE
294 | CURLPROTO_TFTP
295 | CURLPROTO_IMAP
296 | CURLPROTO_IMAPS
297 | CURLPROTO_POP3
298 | CURLPROTO_POP3S
299 | CURLPROTO_SMTP
300 | CURLPROTO_SMTPS
301 | CURLPROTO_RTSP
302 | CURLPROTO_RTMP
303 | CURLPROTO_RTMPT
304 | CURLPROTO_RTMPE
305 | CURLPROTO_RTMPTE
306 | CURLPROTO_RTMPS
307 | CURLPROTO_RTMPTS
308 | CURLPROTO_GOPHER
310 (* sync curlPostRedir_table *)
311 type curlPostRedir =
312 | REDIR_POST_ALL
313 | REDIR_POST_301
314 | REDIR_POST_302
315 | REDIR_POST_303
317 type curlOption =
318 | CURLOPT_WRITEFUNCTION of (string -> int)
319 | CURLOPT_READFUNCTION of (int -> string)
320 | CURLOPT_INFILESIZE of int
321 | CURLOPT_URL of string
322 | CURLOPT_PROXY of string
323 | CURLOPT_PROXYPORT of int
324 | CURLOPT_HTTPPROXYTUNNEL of bool
325 | CURLOPT_VERBOSE of bool
326 | CURLOPT_HEADER of bool
327 | CURLOPT_NOPROGRESS of bool
328 | CURLOPT_NOSIGNAL of bool
329 | CURLOPT_NOBODY of bool
330 | CURLOPT_FAILONERROR of bool
331 | CURLOPT_UPLOAD of bool
332 | CURLOPT_POST of bool
333 | CURLOPT_FTPLISTONLY of bool
334 | CURLOPT_FTPAPPEND of bool
335 | CURLOPT_NETRC of curlNETRCOption
336 | CURLOPT_ENCODING of curlEncoding
337 | CURLOPT_FOLLOWLOCATION of bool
338 | CURLOPT_TRANSFERTEXT of bool
339 | CURLOPT_PUT of bool
340 | CURLOPT_USERPWD of string
341 | CURLOPT_PROXYUSERPWD of string
342 | CURLOPT_RANGE of string
343 | CURLOPT_ERRORBUFFER of string ref
344 | CURLOPT_TIMEOUT of int
345 | CURLOPT_POSTFIELDS of string
346 | CURLOPT_POSTFIELDSIZE of int
347 | CURLOPT_REFERER of string
348 | CURLOPT_USERAGENT of string
349 | CURLOPT_FTPPORT of string
350 | CURLOPT_LOWSPEEDLIMIT of int
351 | CURLOPT_LOWSPEEDTIME of int
352 | CURLOPT_RESUMEFROM of int
353 | CURLOPT_COOKIE of string
354 | CURLOPT_HTTPHEADER of string list
355 | CURLOPT_HTTPPOST of curlHTTPPost list
356 | CURLOPT_SSLCERT of string
357 | CURLOPT_SSLCERTTYPE of string
358 | CURLOPT_SSLCERTPASSWD of string
359 | CURLOPT_SSLKEY of string
360 | CURLOPT_SSLKEYTYPE of string
361 | CURLOPT_SSLKEYPASSWD of string
362 | CURLOPT_SSLENGINE of string
363 | CURLOPT_SSLENGINEDEFAULT of bool
364 | CURLOPT_CRLF of bool
365 | CURLOPT_QUOTE of string list
366 | CURLOPT_POSTQUOTE of string list
367 | CURLOPT_HEADERFUNCTION of (string -> int)
368 | CURLOPT_COOKIEFILE of string
369 | CURLOPT_SSLVERSION of curlSSLVersion
370 | CURLOPT_TIMECONDITION of curlTimeCondition
371 | CURLOPT_TIMEVALUE of int32
372 | CURLOPT_CUSTOMREQUEST of string
373 | CURLOPT_INTERFACE of string
374 | CURLOPT_KRB4LEVEL of curlKRB4Level
375 | CURLOPT_PROGRESSFUNCTION of (float -> float -> float -> float -> bool)
376 | CURLOPT_SSLVERIFYPEER of bool
377 | CURLOPT_CAINFO of string
378 | CURLOPT_CAPATH of string
379 | CURLOPT_FILETIME of bool
380 | CURLOPT_MAXREDIRS of int
381 | CURLOPT_MAXCONNECTS of int
382 | CURLOPT_CLOSEPOLICY of curlClosePolicy
383 | CURLOPT_FRESHCONNECT of bool
384 | CURLOPT_FORBIDREUSE of bool
385 | CURLOPT_RANDOMFILE of string
386 | CURLOPT_EGDSOCKET of string
387 | CURLOPT_CONNECTTIMEOUT of int
388 | CURLOPT_HTTPGET of bool
389 | CURLOPT_SSLVERIFYHOST of curlSSLVerifyHost
390 | CURLOPT_COOKIEJAR of string
391 | CURLOPT_SSLCIPHERLIST of string
392 | CURLOPT_HTTPVERSION of curlHTTPVersion
393 | CURLOPT_FTPUSEEPSV of bool
394 | CURLOPT_DNSCACHETIMEOUT of int
395 | CURLOPT_DNSUSEGLOBALCACHE of bool
396 | CURLOPT_DEBUGFUNCTION of (t -> curlDebugType -> string -> unit)
397 | CURLOPT_PRIVATE of string
398 | CURLOPT_HTTP200ALIASES of string list
399 | CURLOPT_UNRESTRICTEDAUTH of bool
400 | CURLOPT_FTPUSEEPRT of bool
401 | CURLOPT_HTTPAUTH of curlAuth list
402 | CURLOPT_FTPCREATEMISSINGDIRS of bool
403 | CURLOPT_PROXYAUTH of curlAuth list
404 | CURLOPT_FTPRESPONSETIMEOUT of int
405 | CURLOPT_IPRESOLVE of curlIPResolve
406 | CURLOPT_MAXFILESIZE of int32
407 | CURLOPT_INFILESIZELARGE of int64
408 | CURLOPT_RESUMEFROMLARGE of int64
409 | CURLOPT_MAXFILESIZELARGE of int64
410 | CURLOPT_NETRCFILE of string
411 | CURLOPT_FTPSSL of curlFTPSSL
412 | CURLOPT_POSTFIELDSIZELARGE of int64
413 | CURLOPT_TCPNODELAY of bool
414 | CURLOPT_FTPSSLAUTH of curlFTPSSLAuth
415 | CURLOPT_IOCTLFUNCTION of (t -> curlIOCmd -> curlIOErr)
416 | CURLOPT_FTPACCOUNT of string
417 | CURLOPT_COOKIELIST of string
418 | CURLOPT_IGNORECONTENTLENGTH of bool
419 | CURLOPT_FTPSKIPPASVIP of bool
420 | CURLOPT_FTPFILEMETHOD of curlFTPMethod
421 | CURLOPT_LOCALPORT of int
422 | CURLOPT_LOCALPORTRANGE of int
423 | CURLOPT_CONNECTONLY of bool
424 | CURLOPT_MAXSENDSPEEDLARGE of int64
425 | CURLOPT_MAXRECVSPEEDLARGE of int64
426 | CURLOPT_FTPALTERNATIVETOUSER of string
427 | CURLOPT_SSLSESSIONIDCACHE of bool
428 | CURLOPT_SSHAUTHTYPES of curlSSHAuthTypes list
429 | CURLOPT_SSHPUBLICKEYFILE of string
430 | CURLOPT_SSHPRIVATEKEYFILE of string
431 | CURLOPT_FTPSSLCCC of curlFTPSSLCCC
432 | CURLOPT_TIMEOUTMS of int
433 | CURLOPT_CONNECTTIMEOUTMS of int
434 | CURLOPT_HTTPTRANSFERDECODING of bool
435 | CURLOPT_HTTPCONTENTDECODING of bool
436 | CURLOPT_NEWFILEPERMS of int
437 | CURLOPT_NEWDIRECTORYPERMS of int
438 | CURLOPT_POST301 of bool
439 | CURLOPT_SSHHOSTPUBLICKEYMD5 of string
440 | CURLOPT_COPYPOSTFIELDS of string
441 | CURLOPT_PROXYTRANSFERMODE of bool
442 | CURLOPT_SEEKFUNCTION of (int64 -> curlSeek -> curlSeekResult)
443 | CURLOPT_AUTOREFERER of bool
444 | CURLOPT_OPENSOCKETFUNCTION of (Unix.file_descr -> unit)
445 | CURLOPT_PROXYTYPE of curlProxyType
446 | CURLOPT_PROTOCOLS of curlProto list
447 | CURLOPT_REDIR_PROTOCOLS of curlProto list
448 | CURLOPT_RESOLVE of string list
449 | CURLOPT_DNS_SERVERS of string
450 | CURLOPT_MAIL_FROM of string
451 | CURLOPT_MAIL_RCPT of string list
452 | CURLOPT_PIPEWAIT of bool
453 | CURLOPT_CERTINFO of bool
454 | CURLOPT_USERNAME of string
455 | CURLOPT_PASSWORD of string
456 | CURLOPT_LOGIN_OPTIONS of string
457 | CURLOPT_CONNECT_TO of string list
458 | CURLOPT_POSTREDIR of curlPostRedir list
459 | CURLOPT_MIMEPOST of curlMIMEPart list
460 | CURLOPT_SSHKNOWNHOSTS of string
461 | CURLOPT_SSHKEYFUNCTION of (curlKHMatch -> string -> curlKHStat)
463 type initOption =
464 | CURLINIT_GLOBALALL
465 | CURLINIT_GLOBALSSL
466 | CURLINIT_GLOBALWIN32
467 | CURLINIT_GLOBALNOTHING
469 type curlInfo =
470 | CURLINFO_EFFECTIVE_URL
471 | CURLINFO_HTTP_CODE
472 | CURLINFO_RESPONSE_CODE
473 | CURLINFO_TOTAL_TIME
474 | CURLINFO_NAMELOOKUP_TIME
475 | CURLINFO_CONNECT_TIME
476 | CURLINFO_PRETRANSFER_TIME
477 | CURLINFO_SIZE_UPLOAD
478 | CURLINFO_SIZE_DOWNLOAD
479 | CURLINFO_SPEED_DOWNLOAD
480 | CURLINFO_SPEED_UPLOAD
481 | CURLINFO_HEADER_SIZE
482 | CURLINFO_REQUEST_SIZE
483 | CURLINFO_SSL_VERIFYRESULT
484 | CURLINFO_FILETIME
485 | CURLINFO_CONTENT_LENGTH_DOWNLOAD
486 | CURLINFO_CONTENT_LENGTH_UPLOAD
487 | CURLINFO_STARTTRANSFER_TIME
488 | CURLINFO_CONTENT_TYPE
489 | CURLINFO_REDIRECT_TIME
490 | CURLINFO_REDIRECT_COUNT
491 | CURLINFO_PRIVATE
492 | CURLINFO_HTTP_CONNECTCODE
493 | CURLINFO_HTTPAUTH_AVAIL
494 | CURLINFO_PROXYAUTH_AVAIL
495 | CURLINFO_OS_ERRNO
496 | CURLINFO_NUM_CONNECTS
497 | CURLINFO_SSL_ENGINES
498 | CURLINFO_COOKIELIST
499 | CURLINFO_LASTSOCKET
500 | CURLINFO_FTP_ENTRY_PATH
501 | CURLINFO_REDIRECT_URL
502 | CURLINFO_PRIMARY_IP
503 | CURLINFO_LOCAL_IP
504 | CURLINFO_LOCAL_PORT
505 | CURLINFO_CONDITION_UNMET
506 | CURLINFO_CERTINFO
508 type curlInfoResult =
509 | CURLINFO_String of string
510 | CURLINFO_Long of int
511 | CURLINFO_Double of float
512 | CURLINFO_StringList of string list
513 | CURLINFO_StringListList of string list list
515 exception NotImplemented of string
517 let () = Callback.register_exception "Curl.NotImplemented" (NotImplemented "")
519 external global_init : initOption -> unit = "caml_curl_global_init"
520 external global_cleanup : unit -> unit = "caml_curl_global_cleanup"
521 external init : unit -> t = "caml_curl_easy_init"
522 external reset : t -> unit = "caml_curl_easy_reset"
523 external duphandle : t -> t = "caml_curl_easy_duphandle"
524 external setopt : t -> curlOption -> unit = "caml_curl_easy_setopt"
525 external perform : t -> unit = "caml_curl_easy_perform"
526 external cleanup : t -> unit = "caml_curl_easy_cleanup"
527 external getinfo : t -> curlInfo -> curlInfoResult = "caml_curl_easy_getinfo"
528 external escape : string -> string = "caml_curl_escape"
529 external unescape : string -> string = "caml_curl_unescape"
530 external getdate : string -> float -> float = "caml_curl_getdate"
531 external version : unit -> string = "caml_curl_version"
533 type version_info = {
534 version : string;
535 number : int * int * int;
536 host : string;
537 features : string list;
538 ssl_version : string option;
539 libz_version : string option;
540 protocols : string list;
541 ares : string;
542 ares_num : int;
543 libidn : string;
544 iconv_ver_num : int;
545 libssh_version : string;
548 external version_info : unit -> version_info = "caml_curl_version_info"
550 external strerror : curlCode -> string = "caml_curl_strerror"
551 external curlCode_of_int : int -> curlCode option = "caml_curl_curlCode_of_int"
552 external int_of_curlCode : curlCode -> int = "caml_curl_int_of_curlCode"
553 let errno = int_of_curlCode
555 type pauseOption = PAUSE_SEND | PAUSE_RECV | PAUSE_ALL
557 external pause : t -> pauseOption list -> unit = "caml_curl_pause"
559 let set_writefunction conn closure =
560 setopt conn (CURLOPT_WRITEFUNCTION closure)
562 let set_readfunction conn closure =
563 setopt conn (CURLOPT_READFUNCTION closure)
565 let set_infilesize conn size =
566 setopt conn (CURLOPT_INFILESIZE size)
568 let set_url conn url =
569 setopt conn (CURLOPT_URL url)
571 let set_proxy conn proxy =
572 setopt conn (CURLOPT_PROXY proxy)
574 let set_proxyport conn proxyport =
575 setopt conn (CURLOPT_PROXYPORT proxyport)
577 let set_httpproxytunnel conn flag =
578 setopt conn (CURLOPT_HTTPPROXYTUNNEL flag)
580 let set_verbose conn flag =
581 setopt conn (CURLOPT_VERBOSE flag)
583 let set_header conn flag =
584 setopt conn (CURLOPT_HEADER flag)
586 let set_noprogress conn flag =
587 setopt conn (CURLOPT_NOPROGRESS flag)
589 let set_nosignal conn flag =
590 setopt conn (CURLOPT_NOSIGNAL flag)
592 let set_nobody conn flag =
593 setopt conn (CURLOPT_NOBODY flag)
595 let set_failonerror conn flag =
596 setopt conn (CURLOPT_FAILONERROR flag)
598 let set_upload conn flag =
599 setopt conn (CURLOPT_UPLOAD flag)
601 let set_post conn flag =
602 setopt conn (CURLOPT_POST flag)
604 let set_ftplistonly conn flag =
605 setopt conn (CURLOPT_FTPLISTONLY flag)
607 let set_ftpappend conn flag =
608 setopt conn (CURLOPT_FTPAPPEND flag)
610 let set_netrc conn netrc =
611 setopt conn (CURLOPT_NETRC netrc)
613 let set_encoding conn encoding =
614 setopt conn (CURLOPT_ENCODING encoding)
616 let set_followlocation conn flag =
617 setopt conn (CURLOPT_FOLLOWLOCATION flag)
619 let set_transfertext conn flag =
620 setopt conn (CURLOPT_TRANSFERTEXT flag)
622 let set_put conn flag =
623 setopt conn (CURLOPT_PUT flag)
625 let set_userpwd conn userpwd =
626 setopt conn (CURLOPT_USERPWD userpwd)
628 let set_proxyuserpwd conn proxyuserpwd =
629 setopt conn (CURLOPT_PROXYUSERPWD proxyuserpwd)
631 let set_range conn range =
632 setopt conn (CURLOPT_RANGE range)
634 let set_errorbuffer conn errorbuffer =
635 setopt conn (CURLOPT_ERRORBUFFER errorbuffer)
637 let set_timeout conn timeout =
638 setopt conn (CURLOPT_TIMEOUT timeout)
640 let set_postfields conn postfields =
641 setopt conn (CURLOPT_POSTFIELDS postfields)
643 let set_postfieldsize conn postfieldsize =
644 setopt conn (CURLOPT_POSTFIELDSIZE postfieldsize)
646 let set_referer conn referer =
647 setopt conn (CURLOPT_REFERER referer)
649 let set_useragent conn useragent =
650 setopt conn (CURLOPT_USERAGENT useragent)
652 let set_ftpport conn ftpport =
653 setopt conn (CURLOPT_FTPPORT ftpport)
655 let set_lowspeedlimit conn lowspeedlimit =
656 setopt conn (CURLOPT_LOWSPEEDLIMIT lowspeedlimit)
658 let set_lowspeedtime conn lowspeedtime =
659 setopt conn (CURLOPT_LOWSPEEDTIME lowspeedtime)
661 let set_resumefrom conn resumefrom =
662 setopt conn (CURLOPT_RESUMEFROM resumefrom)
664 let set_cookie conn cookie =
665 setopt conn (CURLOPT_COOKIE cookie)
667 let set_httpheader conn httpheader =
668 setopt conn (CURLOPT_HTTPHEADER httpheader)
670 let set_httppost conn httppost =
671 setopt conn (CURLOPT_HTTPPOST httppost)
673 let set_sslcert conn sslcert =
674 setopt conn (CURLOPT_SSLCERT sslcert)
676 let set_sslcerttype conn sslcerttype =
677 setopt conn (CURLOPT_SSLCERTTYPE sslcerttype)
679 let set_sslcertpasswd conn sslcertpasswd =
680 setopt conn (CURLOPT_SSLCERTPASSWD sslcertpasswd)
682 let set_sslkey conn sslkey =
683 setopt conn (CURLOPT_SSLKEY sslkey)
685 let set_sslkeytype conn sslkeytype =
686 setopt conn (CURLOPT_SSLKEYTYPE sslkeytype)
688 let set_sslkeypasswd conn sslkeypasswd =
689 setopt conn (CURLOPT_SSLKEYPASSWD sslkeypasswd)
691 let set_sslengine conn sslengine =
692 setopt conn (CURLOPT_SSLENGINE sslengine)
694 let set_sslenginedefault conn flag =
695 setopt conn (CURLOPT_SSLENGINEDEFAULT flag)
697 let set_certinfo conn flag =
698 setopt conn (CURLOPT_CERTINFO flag)
700 let set_crlf conn flag =
701 setopt conn (CURLOPT_CRLF flag)
703 let set_quote conn quote =
704 setopt conn (CURLOPT_QUOTE quote)
706 let set_postquote conn postquote =
707 setopt conn (CURLOPT_POSTQUOTE postquote)
709 let set_headerfunction conn closure =
710 setopt conn (CURLOPT_HEADERFUNCTION closure)
712 let set_cookiefile conn cookiefile =
713 setopt conn (CURLOPT_COOKIEFILE cookiefile)
715 let set_sslversion conn sslversion =
716 setopt conn (CURLOPT_SSLVERSION sslversion)
718 let set_timecondition conn timecondition =
719 setopt conn (CURLOPT_TIMECONDITION timecondition)
721 let set_timevalue conn timevalue =
722 setopt conn (CURLOPT_TIMEVALUE timevalue)
724 let set_customrequest conn customrequest =
725 setopt conn (CURLOPT_CUSTOMREQUEST customrequest)
727 let set_interface conn interface =
728 setopt conn (CURLOPT_INTERFACE interface)
730 let set_krb4level conn krb4level =
731 setopt conn (CURLOPT_KRB4LEVEL krb4level)
733 let set_progressfunction conn closure =
734 setopt conn (CURLOPT_PROGRESSFUNCTION closure)
736 let set_sslverifypeer conn flag =
737 setopt conn (CURLOPT_SSLVERIFYPEER flag)
739 let set_cainfo conn cainfo =
740 setopt conn (CURLOPT_CAINFO cainfo)
742 let set_capath conn capath =
743 setopt conn (CURLOPT_CAPATH capath)
745 let set_filetime conn filetime =
746 setopt conn (CURLOPT_FILETIME filetime)
748 let set_maxredirs conn maxredirs =
749 setopt conn (CURLOPT_MAXREDIRS maxredirs)
751 let set_maxconnects conn maxconnects =
752 setopt conn (CURLOPT_MAXCONNECTS maxconnects)
754 let set_closepolicy conn closepolicy =
755 setopt conn (CURLOPT_CLOSEPOLICY closepolicy)
757 let set_freshconnect conn flag =
758 setopt conn (CURLOPT_FRESHCONNECT flag)
760 let set_forbidreuse conn flag =
761 setopt conn (CURLOPT_FORBIDREUSE flag)
763 let set_randomfile conn randomfile =
764 setopt conn (CURLOPT_RANDOMFILE randomfile)
766 let set_egdsocket conn egdsocket =
767 setopt conn (CURLOPT_EGDSOCKET egdsocket)
769 let set_connecttimeout conn connecttimeout =
770 setopt conn (CURLOPT_CONNECTTIMEOUT connecttimeout)
772 let set_httpget conn flag =
773 setopt conn (CURLOPT_HTTPGET flag)
775 let set_sslverifyhost conn sslverifyhost =
776 setopt conn (CURLOPT_SSLVERIFYHOST sslverifyhost)
778 let set_cookiejar conn cookiejar =
779 setopt conn (CURLOPT_COOKIEJAR cookiejar)
781 let set_sslcipherlist conn sslcipherlist =
782 setopt conn (CURLOPT_SSLCIPHERLIST sslcipherlist)
784 let set_httpversion conn httpversion =
785 setopt conn (CURLOPT_HTTPVERSION httpversion)
787 let set_ftpuseepsv conn flag =
788 setopt conn (CURLOPT_FTPUSEEPSV flag)
790 let set_dnscachetimeout conn dnscachetimeout =
791 setopt conn (CURLOPT_DNSCACHETIMEOUT dnscachetimeout)
793 let set_dnsuseglobalcache conn flag =
794 setopt conn (CURLOPT_DNSUSEGLOBALCACHE flag)
796 let set_debugfunction conn closure =
797 setopt conn (CURLOPT_DEBUGFUNCTION closure)
799 let set_private conn privateData =
800 setopt conn (CURLOPT_PRIVATE privateData)
802 let set_http200aliases conn aliases =
803 setopt conn (CURLOPT_HTTP200ALIASES aliases)
805 let set_unrestrictedauth conn flag =
806 setopt conn (CURLOPT_UNRESTRICTEDAUTH flag)
808 let set_ftpuseeprt conn flag =
809 setopt conn (CURLOPT_FTPUSEEPRT flag)
811 let set_httpauth conn auth =
812 setopt conn (CURLOPT_HTTPAUTH auth)
814 let set_ftpcreatemissingdirs conn flag =
815 setopt conn (CURLOPT_FTPCREATEMISSINGDIRS flag)
817 let set_proxyauth conn auth =
818 setopt conn (CURLOPT_PROXYAUTH auth)
820 let set_ftpresponsetimeout conn timeout =
821 setopt conn (CURLOPT_FTPRESPONSETIMEOUT timeout)
823 let set_ipresolve conn ipresolve =
824 setopt conn (CURLOPT_IPRESOLVE ipresolve)
826 let set_maxfilesize conn size =
827 setopt conn (CURLOPT_MAXFILESIZE size)
829 let set_infilesizelarge conn size =
830 setopt conn (CURLOPT_INFILESIZELARGE size)
832 let set_resumefromlarge conn size =
833 setopt conn (CURLOPT_RESUMEFROMLARGE size)
835 let set_maxfilesizelarge conn size =
836 setopt conn (CURLOPT_MAXFILESIZELARGE size)
838 let set_netrcfile conn file =
839 setopt conn (CURLOPT_NETRCFILE file)
841 let set_ftpssl conn ftpssl =
842 setopt conn (CURLOPT_FTPSSL ftpssl)
844 let set_postfieldsizelarge conn size =
845 setopt conn (CURLOPT_POSTFIELDSIZELARGE size)
847 let set_tcpnodelay conn flag =
848 setopt conn (CURLOPT_TCPNODELAY flag)
850 let set_ftpsslauth conn auth =
851 setopt conn (CURLOPT_FTPSSLAUTH auth)
853 let set_ioctlfunction conn closure =
854 setopt conn (CURLOPT_IOCTLFUNCTION closure)
856 let set_ftpaccount conn account =
857 setopt conn (CURLOPT_FTPACCOUNT account)
859 let set_cookielist conn cookielist =
860 setopt conn (CURLOPT_COOKIELIST cookielist)
862 let set_ignorecontentlength conn flag =
863 setopt conn (CURLOPT_IGNORECONTENTLENGTH flag)
865 let set_ftpskippasvip conn flag =
866 setopt conn (CURLOPT_FTPSKIPPASVIP flag)
868 let set_ftpfilemethod conn ftpMethod =
869 setopt conn (CURLOPT_FTPFILEMETHOD ftpMethod)
871 let set_localport conn port =
872 setopt conn (CURLOPT_LOCALPORT port)
874 let set_localportrange conn range =
875 setopt conn (CURLOPT_LOCALPORTRANGE range)
877 let set_connectonly conn flag =
878 setopt conn (CURLOPT_CONNECTONLY flag)
880 let set_maxsendspeedlarge conn speed =
881 setopt conn (CURLOPT_MAXSENDSPEEDLARGE speed)
883 let set_maxrecvspeedlarge conn speed =
884 setopt conn (CURLOPT_MAXRECVSPEEDLARGE speed)
886 let set_ftpalternativetouser conn user =
887 setopt conn (CURLOPT_FTPALTERNATIVETOUSER user)
889 let set_sslsessionidcache conn flag =
890 setopt conn (CURLOPT_SSLSESSIONIDCACHE flag)
892 let set_sshauthtypes conn types =
893 setopt conn (CURLOPT_SSHAUTHTYPES types)
895 let set_sshpublickeyfile conn keyfile =
896 setopt conn (CURLOPT_SSHPUBLICKEYFILE keyfile)
898 let set_sshprivatekeyfile conn keyfile =
899 setopt conn (CURLOPT_SSHPRIVATEKEYFILE keyfile)
901 let set_ftpsslccc conn ccc =
902 setopt conn (CURLOPT_FTPSSLCCC ccc)
904 let set_timeoutms conn ms =
905 setopt conn (CURLOPT_TIMEOUTMS ms)
907 let set_connecttimeoutms conn ms =
908 setopt conn (CURLOPT_CONNECTTIMEOUTMS ms)
910 let set_httptransferdecoding conn flag =
911 setopt conn (CURLOPT_HTTPTRANSFERDECODING flag)
913 let set_httpcontentdecoding conn flag =
914 setopt conn (CURLOPT_HTTPCONTENTDECODING flag)
916 let set_newfileperms conn perms =
917 setopt conn (CURLOPT_NEWFILEPERMS perms)
919 let set_newdirectoryperms conn perms =
920 setopt conn (CURLOPT_NEWDIRECTORYPERMS perms)
922 let set_post301 conn flag =
923 setopt conn (CURLOPT_POST301 flag)
925 let set_sshhostpublickeymd5 conn key =
926 setopt conn (CURLOPT_SSHHOSTPUBLICKEYMD5 key)
928 let set_copypostfields conn post =
929 setopt conn (CURLOPT_COPYPOSTFIELDS post)
931 let set_proxytransfermode conn flag =
932 setopt conn (CURLOPT_PROXYTRANSFERMODE flag)
934 let set_seekfunction conn closure =
935 setopt conn (CURLOPT_SEEKFUNCTION closure)
937 let set_autoreferer conn b =
938 setopt conn (CURLOPT_AUTOREFERER b)
940 let set_opensocketfunction conn closure =
941 setopt conn (CURLOPT_OPENSOCKETFUNCTION closure)
943 let set_proxytype conn ptype =
944 setopt conn (CURLOPT_PROXYTYPE ptype)
946 let set_protocols conn l =
947 setopt conn (CURLOPT_PROTOCOLS l)
949 let set_redirprotocols conn l =
950 setopt conn (CURLOPT_REDIR_PROTOCOLS l)
952 let set_resolve conn l_add l_del =
953 let acc = List.fold_left (fun acc (host,port,address) -> (host ^ ":" ^ string_of_int port ^ ":" ^ address) :: acc) [] l_add in
954 let acc = List.fold_left (fun acc (host,port) -> ("-" ^ host ^ ":" ^ string_of_int port) :: acc) acc l_del in
955 setopt conn (CURLOPT_RESOLVE acc)
957 let set_dns_servers conn l =
958 setopt conn (CURLOPT_DNS_SERVERS (String.concat "," l))
960 let set_mailfrom conn l =
961 setopt conn (CURLOPT_MAIL_FROM l)
963 let set_mailrcpt conn l =
964 setopt conn (CURLOPT_MAIL_RCPT l)
966 let set_pipewait conn b =
967 setopt conn (CURLOPT_PIPEWAIT b)
969 let set_username conn s =
970 setopt conn (CURLOPT_USERNAME s)
972 let set_password conn s =
973 setopt conn (CURLOPT_PASSWORD s)
975 let set_login_options conn s =
976 setopt conn (CURLOPT_LOGIN_OPTIONS s)
978 let set_connect_to conn l =
979 setopt conn (CURLOPT_CONNECT_TO l)
981 let set_postredir conn l =
982 setopt conn (CURLOPT_POSTREDIR l)
984 let set_mimepost conn part =
985 setopt conn (CURLOPT_MIMEPOST part)
987 let set_sshknownhosts conn s =
988 setopt conn (CURLOPT_SSHKNOWNHOSTS s)
990 let set_sshkeyfunction conn f =
991 setopt conn (CURLOPT_SSHKEYFUNCTION f)
993 let get_effectiveurl conn =
994 match (getinfo conn CURLINFO_EFFECTIVE_URL) with
995 | CURLINFO_String s -> s
996 | _ -> ""
998 let get_redirecturl conn =
999 match (getinfo conn CURLINFO_REDIRECT_URL) with
1000 | CURLINFO_String s -> s
1001 | _ -> ""
1003 let get_responsecode conn =
1004 match (getinfo conn CURLINFO_HTTP_CODE) with
1005 | CURLINFO_Long l -> l
1006 | _ -> 0
1008 let get_httpcode conn =
1009 get_responsecode conn
1011 let get_totaltime conn =
1012 match (getinfo conn CURLINFO_TOTAL_TIME) with
1013 | CURLINFO_Double d -> d
1014 | _ -> 0.0
1016 let get_namelookuptime conn =
1017 match (getinfo conn CURLINFO_NAMELOOKUP_TIME) with
1018 | CURLINFO_Double d -> d
1019 | _ -> 0.0
1021 let get_connecttime conn =
1022 match (getinfo conn CURLINFO_CONNECT_TIME) with
1023 | CURLINFO_Double d -> d
1024 | _ -> 0.0
1026 let get_pretransfertime conn =
1027 match (getinfo conn CURLINFO_PRETRANSFER_TIME) with
1028 | CURLINFO_Double d -> d
1029 | _ -> 0.0
1031 let get_sizeupload conn =
1032 match (getinfo conn CURLINFO_SIZE_UPLOAD) with
1033 | CURLINFO_Double d -> d
1034 | _ -> 0.0
1036 let get_sizedownload conn =
1037 match (getinfo conn CURLINFO_SIZE_DOWNLOAD) with
1038 | CURLINFO_Double d -> d
1039 | _ -> 0.0
1041 let get_speeddownload conn =
1042 match (getinfo conn CURLINFO_SPEED_DOWNLOAD) with
1043 | CURLINFO_Double d -> d
1044 | _ -> 0.0
1046 let get_speedupload conn =
1047 match (getinfo conn CURLINFO_SPEED_UPLOAD) with
1048 | CURLINFO_Double d -> d
1049 | _ -> 0.0
1051 let get_headersize conn =
1052 match (getinfo conn CURLINFO_HEADER_SIZE) with
1053 | CURLINFO_Long l -> l
1054 | _ -> 0
1056 let get_requestsize conn =
1057 match (getinfo conn CURLINFO_REQUEST_SIZE) with
1058 | CURLINFO_Long l -> l
1059 | _ -> 0
1061 let get_sslverifyresult conn =
1062 match (getinfo conn CURLINFO_SSL_VERIFYRESULT) with
1063 | CURLINFO_Long l -> l
1064 | _ -> 0
1066 let get_filetime conn =
1067 match (getinfo conn CURLINFO_FILETIME) with
1068 | CURLINFO_Double d -> d
1069 | _ -> 0.0
1071 let get_contentlengthdownload conn =
1072 match (getinfo conn CURLINFO_CONTENT_LENGTH_DOWNLOAD) with
1073 | CURLINFO_Double d -> d
1074 | _ -> 0.0
1076 let get_contentlengthupload conn =
1077 match (getinfo conn CURLINFO_CONTENT_LENGTH_UPLOAD) with
1078 | CURLINFO_Double d -> d
1079 | _ -> 0.0
1081 let get_starttransfertime conn =
1082 match (getinfo conn CURLINFO_STARTTRANSFER_TIME) with
1083 | CURLINFO_Double d -> d
1084 | _ -> 0.0
1086 let get_contenttype conn =
1087 match (getinfo conn CURLINFO_CONTENT_TYPE) with
1088 | CURLINFO_String s -> s
1089 | _ -> ""
1091 let get_redirecttime conn =
1092 match (getinfo conn CURLINFO_REDIRECT_TIME) with
1093 | CURLINFO_Double d -> d
1094 | _ -> 0.0
1096 let get_redirectcount conn =
1097 match (getinfo conn CURLINFO_REDIRECT_COUNT) with
1098 | CURLINFO_Long l -> l
1099 | _ -> 0
1101 let get_private conn =
1102 match (getinfo conn CURLINFO_PRIVATE) with
1103 | CURLINFO_String s -> s
1104 | _ -> ""
1106 let get_httpconnectcode conn =
1107 match (getinfo conn CURLINFO_HTTP_CONNECTCODE) with
1108 | CURLINFO_Long l -> l
1109 | _ -> 0
1111 let get_certinfo conn =
1112 match (getinfo conn CURLINFO_CERTINFO) with
1113 | CURLINFO_StringListList l -> l
1114 | _ -> []
1116 let generate_auth auth =
1117 let result = ref [] in
1118 if auth land 1 != 0 then result := [CURLAUTH_BASIC];
1119 if auth land 2 != 0 then result := CURLAUTH_DIGEST :: !result;
1120 if auth land 4 != 0 then result := CURLAUTH_GSSNEGOTIATE :: !result;
1121 if auth land 8 != 0 then result := CURLAUTH_NTLM :: !result;
1122 !result
1124 let get_httpauthavail conn =
1125 match (getinfo conn CURLINFO_HTTPAUTH_AVAIL) with
1126 | CURLINFO_Long l -> generate_auth l
1127 | _ -> []
1129 let get_proxyauthavail conn =
1130 match (getinfo conn CURLINFO_PROXYAUTH_AVAIL) with
1131 | CURLINFO_Long l -> generate_auth l
1132 | _ -> []
1134 let get_oserrno conn =
1135 match (getinfo conn CURLINFO_OS_ERRNO) with
1136 | CURLINFO_Long l -> l
1137 | _ -> 0
1139 let get_numconnects conn =
1140 match (getinfo conn CURLINFO_NUM_CONNECTS) with
1141 | CURLINFO_Long l -> l
1142 | _ -> 0
1144 let get_sslengines conn =
1145 match (getinfo conn CURLINFO_SSL_ENGINES) with
1146 | CURLINFO_StringList l -> l
1147 | _ -> []
1149 let get_cookielist conn =
1150 match (getinfo conn CURLINFO_COOKIELIST) with
1151 | CURLINFO_StringList l -> l
1152 | _ -> []
1154 let get_lastsocket conn =
1155 match (getinfo conn CURLINFO_LASTSOCKET) with
1156 | CURLINFO_Long l -> l
1157 | _ -> 0
1159 let get_ftpentrypath conn =
1160 match (getinfo conn CURLINFO_FTP_ENTRY_PATH) with
1161 | CURLINFO_String s -> s
1162 | _ -> ""
1164 let get_primaryip conn =
1165 match (getinfo conn CURLINFO_PRIMARY_IP) with
1166 | CURLINFO_String s -> s
1167 | _ -> ""
1169 let get_localip conn =
1170 match (getinfo conn CURLINFO_LOCAL_IP) with
1171 | CURLINFO_String s -> s
1172 | _ -> ""
1174 let get_localport conn =
1175 match (getinfo conn CURLINFO_LOCAL_PORT) with
1176 | CURLINFO_Long n -> n
1177 | _ -> 0
1179 let get_conditionunmet conn =
1180 match (getinfo conn CURLINFO_CONDITION_UNMET) with
1181 | CURLINFO_Long n -> n <> 0
1182 | _ -> assert false
1184 let () =
1185 Callback.register_exception "CurlException"
1186 (CurlException (CURLE_OK, 0, ""))
1188 class handle =
1189 object
1190 val conn = init ()
1191 method handle = conn
1192 method duphandle = {< conn = duphandle conn >}
1193 method perform = perform conn
1194 method cleanup = cleanup conn
1195 method set_writefunction closure = set_writefunction conn closure
1196 method set_readfunction closure = set_readfunction conn closure
1197 method set_infilesize size = set_infilesize conn size
1198 method set_url url = set_url conn url
1199 method set_proxy proxy = set_proxy conn proxy
1200 method set_proxyport proxyport = set_proxyport conn proxyport
1201 method set_httpproxytunnel flag = set_httpproxytunnel conn flag
1202 method set_verbose flag = set_verbose conn flag
1203 method set_header flag = set_header conn flag
1204 method set_noprogress flag = set_noprogress conn flag
1205 method set_nosignal flag = set_nosignal conn flag
1206 method set_nobody flag = set_nobody conn flag
1207 method set_failonerror flag = set_failonerror conn flag
1208 method set_upload flag = set_upload conn flag
1209 method set_post flag = set_post conn flag
1210 method set_ftplistonly flag = set_ftplistonly conn flag
1211 method set_ftpappend flag = set_ftpappend conn flag
1212 method set_netrc netrc = set_netrc conn netrc
1213 method set_encoding encoding = set_encoding conn encoding
1214 method set_followlocation flag = set_followlocation conn flag
1215 method set_transfertext flag = set_transfertext conn flag
1216 method set_put flag = set_put conn flag
1217 method set_userpwd userpwd = set_userpwd conn userpwd
1218 method set_proxyuserpwd proxyuserpwd = set_proxyuserpwd conn proxyuserpwd
1219 method set_range range = set_range conn range
1220 method set_errorbuffer errorbuffer = set_errorbuffer conn errorbuffer
1221 method set_timeout timeout = set_timeout conn timeout
1222 method set_postfields postfields = set_postfields conn postfields
1223 method set_referer referer = set_referer conn referer
1224 method set_useragent useragent = set_useragent conn useragent
1225 method set_ftpport ftpport = set_ftpport conn ftpport
1226 method set_lowspeedlimit lowspeedlimit = set_lowspeedlimit conn lowspeedlimit
1227 method set_lowspeedtime lowspeedtime = set_lowspeedtime conn lowspeedtime
1228 method set_resumefrom resumefrom = set_resumefrom conn resumefrom
1229 method set_cookie cookie = set_cookie conn cookie
1230 method set_httpheader httpheader = set_httpheader conn httpheader
1231 method set_httppost httppost = set_httppost conn httppost
1232 method set_sslcert sslcert = set_sslcert conn sslcert
1233 method set_sslcerttype sslcerttype = set_sslcerttype conn sslcerttype
1234 method set_sslcertpasswd sslcertpasswd = set_sslcertpasswd conn sslcertpasswd
1235 method set_sslkey sslkey = set_sslkey conn sslkey
1236 method set_sslkeytype sslkeytype = set_sslkeytype conn sslkeytype
1237 method set_sslkeypasswd sslkeypasswd = set_sslkeypasswd conn sslkeypasswd
1238 method set_sslengine sslengine = set_sslengine conn sslengine
1239 method set_sslenginedefault flag = set_sslenginedefault conn flag
1240 method set_certinfo flag = set_certinfo conn flag
1241 method set_crlf flag = set_crlf conn flag
1242 method set_quote quote = set_quote conn quote
1243 method set_postquote postquote = set_postquote conn postquote
1244 method set_headerfunction closure = set_headerfunction conn closure
1245 method set_cookiefile cookiefile = set_cookiefile conn cookiefile
1246 method set_sslversion sslversion = set_sslversion conn sslversion
1247 method set_timecondition timecondition = set_timecondition conn timecondition
1248 method set_timevalue timevalue = set_timevalue conn timevalue
1249 method set_customrequest customrequest = set_customrequest conn customrequest
1250 method set_interface interface = set_interface conn interface
1251 method set_krb4level krb4level = set_krb4level conn krb4level
1252 method set_progressfunction closure = set_progressfunction conn closure
1253 method set_sslverifypeer flag = set_sslverifypeer conn flag
1254 method set_cainfo cainfo = set_cainfo conn cainfo
1255 method set_capath capath = set_capath conn capath
1256 method set_filetime filetime = set_filetime conn filetime
1257 method set_maxredirs maxredirs = set_maxredirs conn maxredirs
1258 method set_maxconnects maxconnects = set_maxconnects conn maxconnects
1259 method set_closepolicy closepolicy = set_closepolicy conn closepolicy
1260 method set_freshconnect flag = set_freshconnect conn flag
1261 method set_forbidreuse flag = set_forbidreuse conn flag
1262 method set_randomfile randomfile = set_randomfile conn randomfile
1263 method set_egdsocket egdsocket = set_egdsocket conn egdsocket
1264 method set_connecttimeout connecttimeout =
1265 set_connecttimeout conn connecttimeout
1266 method set_httpget flag = set_httpget conn flag
1267 method set_sslverifyhost sslverifyhost = set_sslverifyhost conn sslverifyhost
1268 method set_cookiejar cookiejar = set_cookiejar conn cookiejar
1269 method set_sslcipherlist sslcipherlist = set_sslcipherlist conn sslcipherlist
1270 method set_httpversion httpversion = set_httpversion conn httpversion
1271 method set_ftpuseepsv flag = set_ftpuseepsv conn flag
1272 method set_dnscachetimeout dnscachetimeout = set_dnscachetimeout conn dnscachetimeout
1273 method set_dnsuseglobalcache flag = set_dnsuseglobalcache conn flag
1274 method set_debugfunction closure = set_debugfunction conn closure
1275 method set_private privateData = set_private conn privateData
1276 method set_http200aliases aliases = set_http200aliases conn aliases
1277 method set_unrestrictedauth flag = set_unrestrictedauth conn flag
1278 method set_ftpuseeprt flag = set_ftpuseeprt conn flag
1279 method set_httpauth auth = set_httpauth conn auth
1280 method set_ftpcreatemissingdirs flag = set_ftpcreatemissingdirs conn flag
1281 method set_proxyauth auth = set_proxyauth conn auth
1282 method set_ftpresponsetimeout timeout = set_ftpresponsetimeout conn timeout
1283 method set_ipresolve ipresolve = set_ipresolve conn ipresolve
1284 method set_maxfilesize size = set_maxfilesize conn size
1285 method set_infilesizelarge size = set_infilesizelarge conn size
1286 method set_resumefromlarge size = set_resumefromlarge conn size
1287 method set_maxfilesizelarge size = set_maxfilesizelarge conn size
1288 method set_netrcfile file = set_netrcfile conn file
1289 method set_ftpssl ftpssl = set_ftpssl conn ftpssl
1290 method set_postfieldsize size = set_postfieldsize conn size
1291 method set_postfieldsizelarge size = set_postfieldsizelarge conn size
1292 method set_tcpnodelay flag = set_tcpnodelay conn flag
1293 method set_ftpsslauth flag = set_ftpsslauth conn flag
1294 method set_ioctlfunction closure = set_ioctlfunction conn closure
1295 method set_ftpaccount account = set_ftpaccount conn account
1296 method set_cookielist cookielist = set_cookielist conn cookielist
1297 method set_ignorecontentlength flag = set_ignorecontentlength conn flag
1298 method set_ftpskippasvip flag = set_ftpskippasvip conn flag
1299 method set_ftpfilemethod ftpMethod = set_ftpfilemethod conn ftpMethod
1300 method set_localport port = set_localport conn port
1301 method set_localportrange range = set_localportrange conn range
1302 method set_connectonly flag = set_connectonly conn flag
1303 method set_maxsendspeedlarge speed = set_maxsendspeedlarge conn speed
1304 method set_maxrecvspeedlarge speed = set_maxrecvspeedlarge conn speed
1305 method set_ftpalternativetouser user = set_ftpalternativetouser conn user
1306 method set_sslsessionidcache flag = set_sslsessionidcache conn flag
1307 method set_sshauthtypes types = set_sshauthtypes conn types
1308 method set_sshpublickeyfile keyfile = set_sshpublickeyfile conn keyfile
1309 method set_sshprivatekeyfile keyfile = set_sshprivatekeyfile conn keyfile
1310 method set_ftpsslccc ccc = set_ftpsslccc conn ccc
1311 method set_timeoutms ms = set_timeoutms conn ms
1312 method set_connecttimeoutms ms = set_connecttimeoutms conn ms
1313 method set_httptransferdecoding flag = set_httptransferdecoding conn flag
1314 method set_httpcontentdecoding flag = set_httpcontentdecoding conn flag
1315 method set_newfileperms perms = set_newfileperms conn perms
1316 method set_newdirectoryperms perms = set_newdirectoryperms conn perms
1317 method set_post301 flag = set_post301 conn flag
1318 method set_sshhostpublickeymd5 key = set_sshhostpublickeymd5 conn key
1319 method set_copypostfields post = set_copypostfields conn post
1320 method set_proxytransfermode flag = set_proxytransfermode conn flag
1321 method set_seekfunction closure = set_seekfunction conn closure
1322 method set_resolve l = set_resolve conn l
1323 method set_dns_servers l = set_dns_servers conn l
1324 method set_autoreferer b = set_autoreferer conn b
1325 method set_opensocketfunction closure = set_opensocketfunction conn closure
1326 method set_proxytype t = set_proxytype conn t
1327 method set_mimepost p = set_mimepost conn p
1328 method set_sshknownhosts s = set_sshknownhosts conn s
1329 method set_sshkeyfunction f = set_sshkeyfunction conn f
1331 method get_effectiveurl = get_effectiveurl conn
1332 method get_redirecturl = get_redirecturl conn
1333 method get_responsecode = get_responsecode conn
1334 method get_httpcode = get_responsecode conn
1335 method get_totaltime = get_totaltime conn
1336 method get_namelookuptime = get_namelookuptime conn
1337 method get_connecttime = get_connecttime conn
1338 method get_pretransfertime = get_pretransfertime conn
1339 method get_sizeupload = get_sizeupload conn
1340 method get_sizedownload = get_sizedownload conn
1341 method get_speeddownload = get_speeddownload conn
1342 method get_speedupload = get_speedupload conn
1343 method get_headersize = get_headersize conn
1344 method get_requestsize = get_requestsize conn
1345 method get_sslverifyresult = get_sslverifyresult conn
1346 method get_filetime = get_filetime conn
1347 method get_contentlengthdownload = get_contentlengthdownload conn
1348 method get_contentlengthupload = get_contentlengthupload conn
1349 method get_starttransfertime = get_starttransfertime conn
1350 method get_contenttype = get_contenttype conn
1351 method get_redirecttime = get_redirecttime conn
1352 method get_redirectcount = get_redirectcount conn
1353 method get_private = get_private conn
1354 method get_httpconnectcode = get_httpconnectcode conn
1355 method get_httpauthavail = get_httpauthavail conn
1356 method get_proxyauthavail = get_proxyauthavail conn
1357 method get_oserrno = get_oserrno conn
1358 method get_numconnects = get_numconnects conn
1359 method get_sslengines = get_sslengines conn
1360 method get_cookielist = get_cookielist conn
1361 method get_lastsocket = get_lastsocket conn
1362 method get_ftpentrypath = get_ftpentrypath conn
1363 method get_primaryip = get_primaryip conn
1364 method get_localip = get_localip conn
1365 method get_localport = get_localport conn
1366 method get_conditionunmet = get_conditionunmet conn
1367 method get_certinfo = get_certinfo conn
1370 module Multi = struct
1372 type mt
1374 type curlPipelining = PIPE_NOTHING | PIPE_HTTP1 | PIPE_MULTIPLEX
1376 type curlMultiOption =
1377 | CURLMOPT_PIPELINING of curlPipelining list
1378 | CURLMOPT_MAXCONNECTS of int
1379 | CURLMOPT_MAX_PIPELINE_LENGTH of int
1380 | CURLMOPT_MAX_HOST_CONNECTIONS of int
1382 exception Error of string
1384 let () = Callback.register_exception "Curl.Multi.Error" (Error "")
1386 external create : unit -> mt = "caml_curl_multi_init"
1387 external add : mt -> t -> unit = "caml_curl_multi_add_handle"
1388 external perform : mt -> int = "caml_curl_multi_perform_all"
1389 external wait : int -> mt -> bool = "caml_curl_multi_wait"
1390 let wait ?(timeout_ms=1000) mt = wait timeout_ms mt
1391 external remove : mt -> t -> unit = "caml_curl_multi_remove_handle"
1392 external remove_finished : mt -> (t * curlCode) option = "caml_curlm_remove_finished"
1393 external cleanup : mt -> unit = "caml_curl_multi_cleanup"
1395 (* see curlm_sock_cb *)
1396 type poll = POLL_NONE | POLL_IN | POLL_OUT | POLL_INOUT | POLL_REMOVE
1398 (* see caml_curl_multi_socket_action *)
1399 type fd_status = EV_AUTO | EV_IN | EV_OUT | EV_INOUT
1401 external set_socket_function : mt -> (Unix.file_descr -> poll -> unit) -> unit = "caml_curl_multi_socketfunction"
1402 external set_timer_function : mt -> (int -> unit) -> unit = "caml_curl_multi_timerfunction"
1403 external action_all : mt -> int = "caml_curl_multi_socket_all"
1404 external socket_action : mt -> Unix.file_descr option -> fd_status -> int = "caml_curl_multi_socket_action"
1406 let action_timeout mt = ignore (socket_action mt None EV_AUTO)
1407 let action mt fd status = socket_action mt (Some fd) status
1409 external timeout : mt -> int = "caml_curl_multi_timeout"
1411 external setopt : mt -> curlMultiOption -> unit = "caml_curl_multi_setopt"