sync opam
[ocurl.git] / curl.ml
blobf7d1d54603f8b447748603a1f22bb6c05e280903
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
169 | HTTP_VERSION_3
171 type curlDebugType =
172 | DEBUGTYPE_TEXT
173 | DEBUGTYPE_HEADER_IN
174 | DEBUGTYPE_HEADER_OUT
175 | DEBUGTYPE_DATA_IN
176 | DEBUGTYPE_DATA_OUT
177 | DEBUGTYPE_SSL_DATA_IN
178 | DEBUGTYPE_SSL_DATA_OUT
179 | DEBUGTYPE_END
181 type curlAuth =
182 | CURLAUTH_BASIC
183 | CURLAUTH_DIGEST
184 | CURLAUTH_GSSNEGOTIATE
185 | CURLAUTH_NTLM
186 | CURLAUTH_ANY
187 | CURLAUTH_ANYSAFE
189 type curlIPResolve =
190 | IPRESOLVE_WHATEVER
191 | IPRESOLVE_V4
192 | IPRESOLVE_V6
194 type curlFTPSSL =
195 | FTPSSL_NONE
196 | FTPSSL_TRY
197 | FTPSSL_CONTROL
198 | FTPSSL_ALL
200 type curlFTPSSLAuth =
201 | FTPAUTH_DEFAULT
202 | FTPAUTH_SSL
203 | FTPAUTH_TLS
205 type curlIOCmd =
206 | IOCMD_NOP
207 | IOCMD_RESTARTREAD
209 type curlIOErr =
210 | IOE_OK
211 | IOE_UNKNOWNCMD
212 | IOE_FAILRESTART
214 type curlSeekResult =
215 | SEEKFUNC_OK
216 | SEEKFUNC_FAIL
217 | SEEKFUNC_CANTSEEK
219 type curlFTPMethod =
220 | FTPMETHOD_DEFAULT
221 | FTPMETHOD_MULTICWD
222 | FTPMETHOD_NOCWD
223 | FTPMETHOD_SINGLECWD
225 type curlSSHAuthTypes =
226 | SSHAUTH_ANY
227 | SSHAUTH_PUBLICKEY
228 | SSHAUTH_PASSWORD
229 | SSHAUTH_HOST
230 | SSHAUTH_KEYBOARD
232 type curlFTPSSLCCC =
233 | FTPSSL_CCC_NONE
234 | FTPSSL_CCC_PASSIVE
235 | FTPSSL_CCC_ACTIVE
237 type curlSeek =
238 | SEEK_SET
239 | SEEK_CUR
240 | SEEK_END
242 type curlProxyType =
243 | CURLPROXY_HTTP
244 | CURLPROXY_HTTP_1_0 (** added in 7.19.4 *)
245 | CURLPROXY_SOCKS4 (** added in 7.15.2 *)
246 | CURLPROXY_SOCKS5
247 | CURLPROXY_SOCKS4A (** added in 7.18.0 *)
248 | CURLPROXY_SOCKS5_HOSTNAME (** added in 7.18.0 *)
250 type data_source =
251 | String of string (** Equivalent to `CURLMIME_DATA` *)
252 | File of string (** Equivalent to `CURLMIME_FILEDATA` *)
254 type curlMIMEPartData =
255 | CURLMIME_DATA of string
256 | CURLMIME_FILEDATA of string
257 | CURLMIME_DATA_WITH_NAME of {
258 data: data_source;
259 name: string option;
260 filename: string option;
263 type curlMIMEEncoding =
264 | CURLMIME_8BIT
265 | CURLMIME_BINARY
266 | CURLMIME_7BIT
267 | CURLMIME_QUOTEDPRINTABLE
268 | CURLMIME_BASE64
269 | CURLMIME_NONE
271 type curlMIMEPart =
273 encoding: curlMIMEEncoding;
274 headers: string list;
275 subparts: curlMIMEPart list;
276 data: curlMIMEPartData;
279 type curlKHMatch =
280 | CURLKHMATCH_OK
281 | CURLKHMATCH_MISMATCH of string
282 | CURLKHMATCH_MISSING
284 type curlKHStat =
285 | CURLKHSTAT_FINE_ADD_TO_FILE
286 | CURLKHSTAT_FINE
287 | CURLKHSTAT_REJECT
288 | CURLKHSTAT_DEFER
290 (** Protocols to enable (via CURLOPT_PROTOCOLS and CURLOPT_REDIR_PROTOCOLS) *)
291 type curlProto =
292 | CURLPROTO_ALL (** enable everything *)
293 | CURLPROTO_HTTP
294 | CURLPROTO_HTTPS
295 | CURLPROTO_FTP
296 | CURLPROTO_FTPS
297 | CURLPROTO_SCP
298 | CURLPROTO_SFTP
299 | CURLPROTO_TELNET
300 | CURLPROTO_LDAP
301 | CURLPROTO_LDAPS
302 | CURLPROTO_DICT
303 | CURLPROTO_FILE
304 | CURLPROTO_TFTP
305 | CURLPROTO_IMAP
306 | CURLPROTO_IMAPS
307 | CURLPROTO_POP3
308 | CURLPROTO_POP3S
309 | CURLPROTO_SMTP
310 | CURLPROTO_SMTPS
311 | CURLPROTO_RTSP
312 | CURLPROTO_RTMP
313 | CURLPROTO_RTMPT
314 | CURLPROTO_RTMPE
315 | CURLPROTO_RTMPTE
316 | CURLPROTO_RTMPS
317 | CURLPROTO_RTMPTS
318 | CURLPROTO_GOPHER
320 (* sync curlPostRedir_table *)
321 type curlPostRedir =
322 | REDIR_POST_ALL
323 | REDIR_POST_301
324 | REDIR_POST_302
325 | REDIR_POST_303
327 type curlSslOption =
328 | CURLSSLOPT_ALLOW_BEAST
329 | CURLSSLOPT_NO_REVOKE
330 | CURLSSLOPT_NO_PARTIALCHAIN
331 | CURLSSLOPT_REVOKE_BEST_EFFORT
332 | CURLSSLOPT_NATIVE_CA
333 | CURLSSLOPT_AUTO_CLIENT_CERT
335 type curlWritefuncOpt = string -> [`Full | `Partial of int | `Pause]
337 type 'a xfer_result = Proceed of 'a | Pause | Abort
339 type write_result = unit xfer_result
340 type read_result = string xfer_result
342 let proceed = Proceed ()
344 type curlOption =
345 | CURLOPT_WRITEFUNCTION of (string -> int)
346 | CURLOPT_READFUNCTION of (int -> string)
347 | CURLOPT_INFILESIZE of int
348 | CURLOPT_URL of string
349 | CURLOPT_PROXY of string
350 | CURLOPT_PROXYPORT of int
351 | CURLOPT_HTTPPROXYTUNNEL of bool
352 | CURLOPT_VERBOSE of bool
353 | CURLOPT_HEADER of bool
354 | CURLOPT_NOPROGRESS of bool
355 | CURLOPT_NOSIGNAL of bool
356 | CURLOPT_NOBODY of bool
357 | CURLOPT_FAILONERROR of bool
358 | CURLOPT_UPLOAD of bool
359 | CURLOPT_POST of bool
360 | CURLOPT_FTPLISTONLY of bool
361 | CURLOPT_FTPAPPEND of bool
362 | CURLOPT_NETRC of curlNETRCOption
363 | CURLOPT_ENCODING of curlEncoding
364 | CURLOPT_FOLLOWLOCATION of bool
365 | CURLOPT_TRANSFERTEXT of bool
366 | CURLOPT_PUT of bool
367 | CURLOPT_USERPWD of string
368 | CURLOPT_PROXYUSERPWD of string
369 | CURLOPT_RANGE of string
370 | CURLOPT_ERRORBUFFER of string ref
371 | CURLOPT_TIMEOUT of int
372 | CURLOPT_POSTFIELDS of string
373 | CURLOPT_POSTFIELDSIZE of int
374 | CURLOPT_REFERER of string
375 | CURLOPT_USERAGENT of string
376 | CURLOPT_FTPPORT of string
377 | CURLOPT_LOWSPEEDLIMIT of int
378 | CURLOPT_LOWSPEEDTIME of int
379 | CURLOPT_RESUMEFROM of int
380 | CURLOPT_COOKIE of string
381 | CURLOPT_HTTPHEADER of string list
382 | CURLOPT_HTTPPOST of curlHTTPPost list
383 | CURLOPT_SSLCERT of string
384 | CURLOPT_SSLCERTTYPE of string
385 | CURLOPT_SSLCERTPASSWD of string
386 | CURLOPT_SSLKEY of string
387 | CURLOPT_SSLKEYTYPE of string
388 | CURLOPT_SSLKEYPASSWD of string
389 | CURLOPT_SSLENGINE of string
390 | CURLOPT_SSLENGINEDEFAULT of bool
391 | CURLOPT_CRLF of bool
392 | CURLOPT_QUOTE of string list
393 | CURLOPT_POSTQUOTE of string list
394 | CURLOPT_HEADERFUNCTION of (string -> int)
395 | CURLOPT_COOKIEFILE of string
396 | CURLOPT_SSLVERSION of curlSSLVersion
397 | CURLOPT_TIMECONDITION of curlTimeCondition
398 | CURLOPT_TIMEVALUE of int32
399 | CURLOPT_CUSTOMREQUEST of string
400 | CURLOPT_INTERFACE of string
401 | CURLOPT_KRB4LEVEL of curlKRB4Level
402 | CURLOPT_PROGRESSFUNCTION of (float -> float -> float -> float -> bool)
403 | CURLOPT_SSLVERIFYPEER of bool
404 | CURLOPT_CAINFO of string
405 | CURLOPT_CAPATH of string
406 | CURLOPT_FILETIME of bool
407 | CURLOPT_MAXREDIRS of int
408 | CURLOPT_MAXCONNECTS of int
409 | CURLOPT_CLOSEPOLICY of curlClosePolicy
410 | CURLOPT_FRESHCONNECT of bool
411 | CURLOPT_FORBIDREUSE of bool
412 | CURLOPT_RANDOMFILE of string
413 | CURLOPT_EGDSOCKET of string
414 | CURLOPT_CONNECTTIMEOUT of int
415 | CURLOPT_HTTPGET of bool
416 | CURLOPT_SSLVERIFYHOST of curlSSLVerifyHost
417 | CURLOPT_COOKIEJAR of string
418 | CURLOPT_SSLCIPHERLIST of string
419 | CURLOPT_HTTPVERSION of curlHTTPVersion
420 | CURLOPT_FTPUSEEPSV of bool
421 | CURLOPT_DNSCACHETIMEOUT of int
422 | CURLOPT_DNSUSEGLOBALCACHE of bool
423 | CURLOPT_DEBUGFUNCTION of (t -> curlDebugType -> string -> unit)
424 | CURLOPT_PRIVATE of string
425 | CURLOPT_HTTP200ALIASES of string list
426 | CURLOPT_UNRESTRICTEDAUTH of bool
427 | CURLOPT_FTPUSEEPRT of bool
428 | CURLOPT_HTTPAUTH of curlAuth list
429 | CURLOPT_FTPCREATEMISSINGDIRS of bool
430 | CURLOPT_PROXYAUTH of curlAuth list
431 | CURLOPT_FTPRESPONSETIMEOUT of int
432 | CURLOPT_IPRESOLVE of curlIPResolve
433 | CURLOPT_MAXFILESIZE of int32
434 | CURLOPT_INFILESIZELARGE of int64
435 | CURLOPT_RESUMEFROMLARGE of int64
436 | CURLOPT_MAXFILESIZELARGE of int64
437 | CURLOPT_NETRCFILE of string
438 | CURLOPT_FTPSSL of curlFTPSSL
439 | CURLOPT_POSTFIELDSIZELARGE of int64
440 | CURLOPT_TCPNODELAY of bool
441 | CURLOPT_TCP_FASTOPEN of bool
442 | CURLOPT_FTPSSLAUTH of curlFTPSSLAuth
443 | CURLOPT_IOCTLFUNCTION of (t -> curlIOCmd -> curlIOErr)
444 | CURLOPT_FTPACCOUNT of string
445 | CURLOPT_COOKIELIST of string
446 | CURLOPT_IGNORECONTENTLENGTH of bool
447 | CURLOPT_FTPSKIPPASVIP of bool
448 | CURLOPT_FTPFILEMETHOD of curlFTPMethod
449 | CURLOPT_LOCALPORT of int
450 | CURLOPT_LOCALPORTRANGE of int
451 | CURLOPT_CONNECTONLY of bool
452 | CURLOPT_MAXSENDSPEEDLARGE of int64
453 | CURLOPT_MAXRECVSPEEDLARGE of int64
454 | CURLOPT_FTPALTERNATIVETOUSER of string
455 | CURLOPT_SSLSESSIONIDCACHE of bool
456 | CURLOPT_SSHAUTHTYPES of curlSSHAuthTypes list
457 | CURLOPT_SSHPUBLICKEYFILE of string
458 | CURLOPT_SSHPRIVATEKEYFILE of string
459 | CURLOPT_FTPSSLCCC of curlFTPSSLCCC
460 | CURLOPT_TIMEOUTMS of int
461 | CURLOPT_CONNECTTIMEOUTMS of int
462 | CURLOPT_HTTPTRANSFERDECODING of bool
463 | CURLOPT_HTTPCONTENTDECODING of bool
464 | CURLOPT_NEWFILEPERMS of int
465 | CURLOPT_NEWDIRECTORYPERMS of int
466 | CURLOPT_POST301 of bool
467 | CURLOPT_SSHHOSTPUBLICKEYMD5 of string
468 | CURLOPT_COPYPOSTFIELDS of string
469 | CURLOPT_PROXYTRANSFERMODE of bool
470 | CURLOPT_SEEKFUNCTION of (int64 -> curlSeek -> curlSeekResult)
471 | CURLOPT_AUTOREFERER of bool
472 | CURLOPT_OPENSOCKETFUNCTION of (Unix.file_descr -> unit)
473 (* | CURLOPT_CLOSESOCKETFUNCTION of (Unix.file_descr -> unit) *)
474 | CURLOPT_PROXYTYPE of curlProxyType
475 | CURLOPT_PROTOCOLS of curlProto list
476 | CURLOPT_REDIR_PROTOCOLS of curlProto list
477 | CURLOPT_RESOLVE of string list
478 | CURLOPT_DNS_SERVERS of string
479 | CURLOPT_MAIL_FROM of string
480 | CURLOPT_MAIL_RCPT of string list
481 | CURLOPT_PIPEWAIT of bool
482 | CURLOPT_CERTINFO of bool
483 | CURLOPT_USERNAME of string
484 | CURLOPT_PASSWORD of string
485 | CURLOPT_LOGIN_OPTIONS of string
486 | CURLOPT_CONNECT_TO of string list
487 | CURLOPT_POSTREDIR of curlPostRedir list
488 | CURLOPT_MIMEPOST of curlMIMEPart list
489 | CURLOPT_SSHKNOWNHOSTS of string
490 | CURLOPT_SSHKEYFUNCTION of (curlKHMatch -> string -> curlKHStat)
491 | CURLOPT_BUFFERSIZE of int
492 | CURLOPT_DOH_URL of string
493 | CURLOPT_SSL_OPTIONS of curlSslOption list
494 | CURLOPT_WRITEFUNCTION2 of (string -> write_result)
495 | CURLOPT_READFUNCTION2 of (int -> read_result)
496 | CURLOPT_XFERINFOFUNCTION of (int64 -> int64 -> int64 -> int64 -> bool)
498 type initOption =
499 | CURLINIT_GLOBALALL
500 | CURLINIT_GLOBALSSL
501 | CURLINIT_GLOBALWIN32
502 | CURLINIT_GLOBALNOTHING
504 type curlInfo =
505 | CURLINFO_EFFECTIVE_URL
506 | CURLINFO_HTTP_CODE
507 | CURLINFO_RESPONSE_CODE
508 | CURLINFO_TOTAL_TIME
509 | CURLINFO_NAMELOOKUP_TIME
510 | CURLINFO_CONNECT_TIME
511 | CURLINFO_PRETRANSFER_TIME
512 | CURLINFO_SIZE_UPLOAD
513 | CURLINFO_SIZE_DOWNLOAD
514 | CURLINFO_SPEED_DOWNLOAD
515 | CURLINFO_SPEED_UPLOAD
516 | CURLINFO_HEADER_SIZE
517 | CURLINFO_REQUEST_SIZE
518 | CURLINFO_SSL_VERIFYRESULT
519 | CURLINFO_FILETIME
520 | CURLINFO_CONTENT_LENGTH_DOWNLOAD
521 | CURLINFO_CONTENT_LENGTH_UPLOAD
522 | CURLINFO_STARTTRANSFER_TIME
523 | CURLINFO_CONTENT_TYPE
524 | CURLINFO_REDIRECT_TIME
525 | CURLINFO_REDIRECT_COUNT
526 | CURLINFO_PRIVATE
527 | CURLINFO_HTTP_CONNECTCODE
528 | CURLINFO_HTTPAUTH_AVAIL
529 | CURLINFO_PROXYAUTH_AVAIL
530 | CURLINFO_OS_ERRNO
531 | CURLINFO_NUM_CONNECTS
532 | CURLINFO_SSL_ENGINES
533 | CURLINFO_COOKIELIST
534 | CURLINFO_LASTSOCKET
535 | CURLINFO_FTP_ENTRY_PATH
536 | CURLINFO_REDIRECT_URL
537 | CURLINFO_PRIMARY_IP
538 | CURLINFO_LOCAL_IP
539 | CURLINFO_LOCAL_PORT
540 | CURLINFO_CONDITION_UNMET
541 | CURLINFO_CERTINFO
542 | CURLINFO_ACTIVESOCKET
543 | CURLINFO_HTTP_VERSION
545 type curlInfoResult =
546 | CURLINFO_String of string
547 | CURLINFO_Long of int
548 | CURLINFO_Double of float
549 | CURLINFO_StringList of string list
550 | CURLINFO_StringListList of string list list
551 | CURLINFO_Socket of Unix.file_descr
552 | CURLINFO_Version of curlHTTPVersion
554 type curlSslBackend =
555 | CURLSSLBACKEND_NONE
556 | CURLSSLBACKEND_OPENSSL
557 | CURLSSLBACKEND_GNUTLS
558 | CURLSSLBACKEND_NSS
559 | CURLSSLBACKEND_GSKIT
560 | CURLSSLBACKEND_WOLFSSL
561 | CURLSSLBACKEND_SCHANNEL
562 | CURLSSLBACKEND_SECURETRANSPORT
563 | CURLSSLBACKEND_MBEDTLS
564 | CURLSSLBACKEND_MESALINK
565 | CURLSSLBACKEND_BEARSSL
567 type curlSslSet =
568 | CURLSSLSET_OK
569 | CURLSSLSET_UNKNOWN_BACKEND
570 | CURLSSLSET_TOO_LATE
571 | CURLSSLSET_NO_BACKENDS
573 exception NotImplemented of string
575 let () = Callback.register_exception "Curl.NotImplemented" (NotImplemented "")
577 exception CurlSslSetException of curlSslSet
579 let () =
580 Callback.register_exception "CurlSslSetException"
581 (CurlSslSetException CURLSSLSET_OK)
583 external global_sslset : curlSslBackend -> unit = "caml_curl_global_sslset"
584 external global_sslset_str : string -> unit = "caml_curl_global_sslset_str"
585 external global_sslsetavail : unit -> curlSslBackend list = "caml_curl_global_sslsetavail"
586 external global_sslsetavail_str : unit -> string list = "caml_curl_global_sslsetavail_str"
587 external global_init : initOption -> unit = "caml_curl_global_init"
588 external global_cleanup : unit -> unit = "caml_curl_global_cleanup"
589 external init : unit -> t = "caml_curl_easy_init"
590 external reset : t -> unit = "caml_curl_easy_reset"
591 external setopt : t -> curlOption -> unit = "caml_curl_easy_setopt"
592 external perform : t -> unit = "caml_curl_easy_perform"
593 external cleanup : t -> unit = "caml_curl_easy_cleanup"
594 external getinfo : t -> curlInfo -> curlInfoResult = "caml_curl_easy_getinfo"
595 external escape : string -> string = "caml_curl_escape"
596 external unescape : string -> string = "caml_curl_unescape"
597 external getdate : string -> float -> float = "caml_curl_getdate"
598 external version : unit -> string = "caml_curl_version"
600 type version_info = {
601 version : string;
602 number : int * int * int;
603 host : string;
604 features : string list;
605 ssl_version : string option;
606 libz_version : string option;
607 protocols : string list;
608 ares : string;
609 ares_num : int;
610 libidn : string;
611 iconv_ver_num : int;
612 libssh_version : string;
615 external version_info : unit -> version_info = "caml_curl_version_info"
617 external strerror : curlCode -> string = "caml_curl_strerror"
618 external curlCode_of_int : int -> curlCode option = "caml_curl_curlCode_of_int"
619 external int_of_curlCode : curlCode -> int = "caml_curl_int_of_curlCode"
620 let errno = int_of_curlCode
622 type pauseOption = PAUSE_SEND | PAUSE_RECV | PAUSE_ALL
624 external pause : t -> pauseOption list -> unit = "caml_curl_pause"
626 let set_writefunction conn closure =
627 setopt conn (CURLOPT_WRITEFUNCTION closure)
629 let set_writefunction2 conn closure =
630 setopt conn (CURLOPT_WRITEFUNCTION2 closure)
632 let set_readfunction conn closure =
633 setopt conn (CURLOPT_READFUNCTION closure)
635 let set_readfunction2 conn closure =
636 setopt conn (CURLOPT_READFUNCTION2 closure)
638 let set_infilesize conn size =
639 setopt conn (CURLOPT_INFILESIZE size)
641 let set_url conn url =
642 setopt conn (CURLOPT_URL url)
644 let set_proxy conn proxy =
645 setopt conn (CURLOPT_PROXY proxy)
647 let set_proxyport conn proxyport =
648 setopt conn (CURLOPT_PROXYPORT proxyport)
650 let set_httpproxytunnel conn flag =
651 setopt conn (CURLOPT_HTTPPROXYTUNNEL flag)
653 let set_verbose conn flag =
654 setopt conn (CURLOPT_VERBOSE flag)
656 let set_header conn flag =
657 setopt conn (CURLOPT_HEADER flag)
659 let set_noprogress conn flag =
660 setopt conn (CURLOPT_NOPROGRESS flag)
662 let set_nosignal conn flag =
663 setopt conn (CURLOPT_NOSIGNAL flag)
665 let set_nobody conn flag =
666 setopt conn (CURLOPT_NOBODY flag)
668 let set_failonerror conn flag =
669 setopt conn (CURLOPT_FAILONERROR flag)
671 let set_upload conn flag =
672 setopt conn (CURLOPT_UPLOAD flag)
674 let set_post conn flag =
675 setopt conn (CURLOPT_POST flag)
677 let set_ftplistonly conn flag =
678 setopt conn (CURLOPT_FTPLISTONLY flag)
680 let set_ftpappend conn flag =
681 setopt conn (CURLOPT_FTPAPPEND flag)
683 let set_netrc conn netrc =
684 setopt conn (CURLOPT_NETRC netrc)
686 let set_encoding conn encoding =
687 setopt conn (CURLOPT_ENCODING encoding)
689 let set_followlocation conn flag =
690 setopt conn (CURLOPT_FOLLOWLOCATION flag)
692 let set_transfertext conn flag =
693 setopt conn (CURLOPT_TRANSFERTEXT flag)
695 let set_put conn flag =
696 setopt conn (CURLOPT_PUT flag)
698 let set_userpwd conn userpwd =
699 setopt conn (CURLOPT_USERPWD userpwd)
701 let set_proxyuserpwd conn proxyuserpwd =
702 setopt conn (CURLOPT_PROXYUSERPWD proxyuserpwd)
704 let set_range conn range =
705 setopt conn (CURLOPT_RANGE range)
707 let set_errorbuffer conn errorbuffer =
708 setopt conn (CURLOPT_ERRORBUFFER errorbuffer)
710 let set_timeout conn timeout =
711 setopt conn (CURLOPT_TIMEOUT timeout)
713 let set_postfields conn postfields =
714 setopt conn (CURLOPT_POSTFIELDS postfields)
716 let set_postfieldsize conn postfieldsize =
717 setopt conn (CURLOPT_POSTFIELDSIZE postfieldsize)
719 let set_referer conn referer =
720 setopt conn (CURLOPT_REFERER referer)
722 let set_useragent conn useragent =
723 setopt conn (CURLOPT_USERAGENT useragent)
725 let set_ftpport conn ftpport =
726 setopt conn (CURLOPT_FTPPORT ftpport)
728 let set_lowspeedlimit conn lowspeedlimit =
729 setopt conn (CURLOPT_LOWSPEEDLIMIT lowspeedlimit)
731 let set_lowspeedtime conn lowspeedtime =
732 setopt conn (CURLOPT_LOWSPEEDTIME lowspeedtime)
734 let set_resumefrom conn resumefrom =
735 setopt conn (CURLOPT_RESUMEFROM resumefrom)
737 let set_cookie conn cookie =
738 setopt conn (CURLOPT_COOKIE cookie)
740 let set_httpheader conn httpheader =
741 setopt conn (CURLOPT_HTTPHEADER httpheader)
743 let set_httppost conn httppost =
744 setopt conn (CURLOPT_HTTPPOST httppost)
746 let set_sslcert conn sslcert =
747 setopt conn (CURLOPT_SSLCERT sslcert)
749 let set_sslcerttype conn sslcerttype =
750 setopt conn (CURLOPT_SSLCERTTYPE sslcerttype)
752 let set_sslcertpasswd conn sslcertpasswd =
753 setopt conn (CURLOPT_SSLCERTPASSWD sslcertpasswd)
755 let set_sslkey conn sslkey =
756 setopt conn (CURLOPT_SSLKEY sslkey)
758 let set_sslkeytype conn sslkeytype =
759 setopt conn (CURLOPT_SSLKEYTYPE sslkeytype)
761 let set_sslkeypasswd conn sslkeypasswd =
762 setopt conn (CURLOPT_SSLKEYPASSWD sslkeypasswd)
764 let set_sslengine conn sslengine =
765 setopt conn (CURLOPT_SSLENGINE sslengine)
767 let set_sslenginedefault conn flag =
768 setopt conn (CURLOPT_SSLENGINEDEFAULT flag)
770 let set_certinfo conn flag =
771 setopt conn (CURLOPT_CERTINFO flag)
773 let set_crlf conn flag =
774 setopt conn (CURLOPT_CRLF flag)
776 let set_quote conn quote =
777 setopt conn (CURLOPT_QUOTE quote)
779 let set_postquote conn postquote =
780 setopt conn (CURLOPT_POSTQUOTE postquote)
782 let set_headerfunction conn closure =
783 setopt conn (CURLOPT_HEADERFUNCTION closure)
785 let set_cookiefile conn cookiefile =
786 setopt conn (CURLOPT_COOKIEFILE cookiefile)
788 let set_sslversion conn sslversion =
789 setopt conn (CURLOPT_SSLVERSION sslversion)
791 let set_timecondition conn timecondition =
792 setopt conn (CURLOPT_TIMECONDITION timecondition)
794 let set_timevalue conn timevalue =
795 setopt conn (CURLOPT_TIMEVALUE timevalue)
797 let set_customrequest conn customrequest =
798 setopt conn (CURLOPT_CUSTOMREQUEST customrequest)
800 let set_interface conn interface =
801 setopt conn (CURLOPT_INTERFACE interface)
803 let set_krb4level conn krb4level =
804 setopt conn (CURLOPT_KRB4LEVEL krb4level)
806 let set_progressfunction conn closure =
807 setopt conn (CURLOPT_PROGRESSFUNCTION closure)
809 let set_xferinfofunction conn closure =
810 setopt conn (CURLOPT_XFERINFOFUNCTION closure)
812 let set_sslverifypeer conn flag =
813 setopt conn (CURLOPT_SSLVERIFYPEER flag)
815 let set_cainfo conn cainfo =
816 setopt conn (CURLOPT_CAINFO cainfo)
818 let set_capath conn capath =
819 setopt conn (CURLOPT_CAPATH capath)
821 let set_filetime conn filetime =
822 setopt conn (CURLOPT_FILETIME filetime)
824 let set_maxredirs conn maxredirs =
825 setopt conn (CURLOPT_MAXREDIRS maxredirs)
827 let set_maxconnects conn maxconnects =
828 setopt conn (CURLOPT_MAXCONNECTS maxconnects)
830 let set_closepolicy conn closepolicy =
831 setopt conn (CURLOPT_CLOSEPOLICY closepolicy)
833 let set_freshconnect conn flag =
834 setopt conn (CURLOPT_FRESHCONNECT flag)
836 let set_forbidreuse conn flag =
837 setopt conn (CURLOPT_FORBIDREUSE flag)
839 let set_randomfile conn randomfile =
840 setopt conn (CURLOPT_RANDOMFILE randomfile)
842 let set_egdsocket conn egdsocket =
843 setopt conn (CURLOPT_EGDSOCKET egdsocket)
845 let set_connecttimeout conn connecttimeout =
846 setopt conn (CURLOPT_CONNECTTIMEOUT connecttimeout)
848 let set_httpget conn flag =
849 setopt conn (CURLOPT_HTTPGET flag)
851 let set_sslverifyhost conn sslverifyhost =
852 setopt conn (CURLOPT_SSLVERIFYHOST sslverifyhost)
854 let set_cookiejar conn cookiejar =
855 setopt conn (CURLOPT_COOKIEJAR cookiejar)
857 let set_sslcipherlist conn sslcipherlist =
858 setopt conn (CURLOPT_SSLCIPHERLIST sslcipherlist)
860 let set_httpversion conn httpversion =
861 setopt conn (CURLOPT_HTTPVERSION httpversion)
863 let set_ftpuseepsv conn flag =
864 setopt conn (CURLOPT_FTPUSEEPSV flag)
866 let set_dnscachetimeout conn dnscachetimeout =
867 setopt conn (CURLOPT_DNSCACHETIMEOUT dnscachetimeout)
869 let set_dnsuseglobalcache conn flag =
870 setopt conn (CURLOPT_DNSUSEGLOBALCACHE flag)
872 let set_debugfunction conn closure =
873 setopt conn (CURLOPT_DEBUGFUNCTION closure)
875 let set_private conn privateData =
876 setopt conn (CURLOPT_PRIVATE privateData)
878 let set_http200aliases conn aliases =
879 setopt conn (CURLOPT_HTTP200ALIASES aliases)
881 let set_unrestrictedauth conn flag =
882 setopt conn (CURLOPT_UNRESTRICTEDAUTH flag)
884 let set_ftpuseeprt conn flag =
885 setopt conn (CURLOPT_FTPUSEEPRT flag)
887 let set_httpauth conn auth =
888 setopt conn (CURLOPT_HTTPAUTH auth)
890 let set_ftpcreatemissingdirs conn flag =
891 setopt conn (CURLOPT_FTPCREATEMISSINGDIRS flag)
893 let set_proxyauth conn auth =
894 setopt conn (CURLOPT_PROXYAUTH auth)
896 let set_ftpresponsetimeout conn timeout =
897 setopt conn (CURLOPT_FTPRESPONSETIMEOUT timeout)
899 let set_ipresolve conn ipresolve =
900 setopt conn (CURLOPT_IPRESOLVE ipresolve)
902 let set_maxfilesize conn size =
903 setopt conn (CURLOPT_MAXFILESIZE size)
905 let set_infilesizelarge conn size =
906 setopt conn (CURLOPT_INFILESIZELARGE size)
908 let set_resumefromlarge conn size =
909 setopt conn (CURLOPT_RESUMEFROMLARGE size)
911 let set_maxfilesizelarge conn size =
912 setopt conn (CURLOPT_MAXFILESIZELARGE size)
914 let set_netrcfile conn file =
915 setopt conn (CURLOPT_NETRCFILE file)
917 let set_ftpssl conn ftpssl =
918 setopt conn (CURLOPT_FTPSSL ftpssl)
920 let set_postfieldsizelarge conn size =
921 setopt conn (CURLOPT_POSTFIELDSIZELARGE size)
923 let set_tcpnodelay conn flag =
924 setopt conn (CURLOPT_TCPNODELAY flag)
926 let set_tcpfastopen conn flag =
927 setopt conn (CURLOPT_TCP_FASTOPEN flag)
929 let set_ftpsslauth conn auth =
930 setopt conn (CURLOPT_FTPSSLAUTH auth)
932 let set_ioctlfunction conn closure =
933 setopt conn (CURLOPT_IOCTLFUNCTION closure)
935 let set_ftpaccount conn account =
936 setopt conn (CURLOPT_FTPACCOUNT account)
938 let set_cookielist conn cookielist =
939 setopt conn (CURLOPT_COOKIELIST cookielist)
941 let set_ignorecontentlength conn flag =
942 setopt conn (CURLOPT_IGNORECONTENTLENGTH flag)
944 let set_ftpskippasvip conn flag =
945 setopt conn (CURLOPT_FTPSKIPPASVIP flag)
947 let set_ftpfilemethod conn ftpMethod =
948 setopt conn (CURLOPT_FTPFILEMETHOD ftpMethod)
950 let set_localport conn port =
951 setopt conn (CURLOPT_LOCALPORT port)
953 let set_localportrange conn range =
954 setopt conn (CURLOPT_LOCALPORTRANGE range)
956 let set_connectonly conn flag =
957 setopt conn (CURLOPT_CONNECTONLY flag)
959 let set_maxsendspeedlarge conn speed =
960 setopt conn (CURLOPT_MAXSENDSPEEDLARGE speed)
962 let set_maxrecvspeedlarge conn speed =
963 setopt conn (CURLOPT_MAXRECVSPEEDLARGE speed)
965 let set_ftpalternativetouser conn user =
966 setopt conn (CURLOPT_FTPALTERNATIVETOUSER user)
968 let set_sslsessionidcache conn flag =
969 setopt conn (CURLOPT_SSLSESSIONIDCACHE flag)
971 let set_sshauthtypes conn types =
972 setopt conn (CURLOPT_SSHAUTHTYPES types)
974 let set_sshpublickeyfile conn keyfile =
975 setopt conn (CURLOPT_SSHPUBLICKEYFILE keyfile)
977 let set_sshprivatekeyfile conn keyfile =
978 setopt conn (CURLOPT_SSHPRIVATEKEYFILE keyfile)
980 let set_ftpsslccc conn ccc =
981 setopt conn (CURLOPT_FTPSSLCCC ccc)
983 let set_timeoutms conn ms =
984 setopt conn (CURLOPT_TIMEOUTMS ms)
986 let set_connecttimeoutms conn ms =
987 setopt conn (CURLOPT_CONNECTTIMEOUTMS ms)
989 let set_httptransferdecoding conn flag =
990 setopt conn (CURLOPT_HTTPTRANSFERDECODING flag)
992 let set_httpcontentdecoding conn flag =
993 setopt conn (CURLOPT_HTTPCONTENTDECODING flag)
995 let set_newfileperms conn perms =
996 setopt conn (CURLOPT_NEWFILEPERMS perms)
998 let set_newdirectoryperms conn perms =
999 setopt conn (CURLOPT_NEWDIRECTORYPERMS perms)
1001 let set_post301 conn flag =
1002 setopt conn (CURLOPT_POST301 flag)
1004 let set_sshhostpublickeymd5 conn key =
1005 setopt conn (CURLOPT_SSHHOSTPUBLICKEYMD5 key)
1007 let set_copypostfields conn post =
1008 setopt conn (CURLOPT_COPYPOSTFIELDS post)
1010 let set_proxytransfermode conn flag =
1011 setopt conn (CURLOPT_PROXYTRANSFERMODE flag)
1013 let set_seekfunction conn closure =
1014 setopt conn (CURLOPT_SEEKFUNCTION closure)
1016 let set_autoreferer conn b =
1017 setopt conn (CURLOPT_AUTOREFERER b)
1019 let set_opensocketfunction conn closure =
1020 setopt conn (CURLOPT_OPENSOCKETFUNCTION closure)
1023 let set_closesocketfunction conn closure =
1024 setopt conn (CURLOPT_CLOSESOCKETFUNCTION closure)
1027 let set_proxytype conn ptype =
1028 setopt conn (CURLOPT_PROXYTYPE ptype)
1030 let set_protocols conn l =
1031 setopt conn (CURLOPT_PROTOCOLS l)
1033 let set_redirprotocols conn l =
1034 setopt conn (CURLOPT_REDIR_PROTOCOLS l)
1036 let set_resolve conn l_add l_del =
1037 let acc = List.fold_left (fun acc (host,port,address) -> (host ^ ":" ^ string_of_int port ^ ":" ^ address) :: acc) [] l_add in
1038 let acc = List.fold_left (fun acc (host,port) -> ("-" ^ host ^ ":" ^ string_of_int port) :: acc) acc l_del in
1039 setopt conn (CURLOPT_RESOLVE acc)
1041 let set_dns_servers conn l =
1042 setopt conn (CURLOPT_DNS_SERVERS (String.concat "," l))
1044 let set_mailfrom conn l =
1045 setopt conn (CURLOPT_MAIL_FROM l)
1047 let set_mailrcpt conn l =
1048 setopt conn (CURLOPT_MAIL_RCPT l)
1050 let set_pipewait conn b =
1051 setopt conn (CURLOPT_PIPEWAIT b)
1053 let set_username conn s =
1054 setopt conn (CURLOPT_USERNAME s)
1056 let set_password conn s =
1057 setopt conn (CURLOPT_PASSWORD s)
1059 let set_login_options conn s =
1060 setopt conn (CURLOPT_LOGIN_OPTIONS s)
1062 let set_connect_to conn l =
1063 setopt conn (CURLOPT_CONNECT_TO l)
1065 let set_postredir conn l =
1066 setopt conn (CURLOPT_POSTREDIR l)
1068 let set_mimepost conn part =
1069 setopt conn (CURLOPT_MIMEPOST part)
1071 let set_sshknownhosts conn s =
1072 setopt conn (CURLOPT_SSHKNOWNHOSTS s)
1074 let set_sshkeyfunction conn f =
1075 setopt conn (CURLOPT_SSHKEYFUNCTION f)
1077 let set_buffersize conn buffersize =
1078 setopt conn (CURLOPT_BUFFERSIZE buffersize)
1080 let set_doh_url conn url =
1081 setopt conn (CURLOPT_DOH_URL url)
1083 let set_ssl_options conn opts =
1084 setopt conn (CURLOPT_SSL_OPTIONS opts)
1086 let get_effectiveurl conn =
1087 match (getinfo conn CURLINFO_EFFECTIVE_URL) with
1088 | CURLINFO_String s -> s
1089 | _ -> ""
1091 let get_redirecturl conn =
1092 match (getinfo conn CURLINFO_REDIRECT_URL) with
1093 | CURLINFO_String s -> s
1094 | _ -> ""
1096 let get_responsecode conn =
1097 match (getinfo conn CURLINFO_HTTP_CODE) with
1098 | CURLINFO_Long l -> l
1099 | _ -> 0
1101 let get_httpcode conn =
1102 get_responsecode conn
1104 let get_totaltime conn =
1105 match (getinfo conn CURLINFO_TOTAL_TIME) with
1106 | CURLINFO_Double d -> d
1107 | _ -> 0.0
1109 let get_namelookuptime conn =
1110 match (getinfo conn CURLINFO_NAMELOOKUP_TIME) with
1111 | CURLINFO_Double d -> d
1112 | _ -> 0.0
1114 let get_connecttime conn =
1115 match (getinfo conn CURLINFO_CONNECT_TIME) with
1116 | CURLINFO_Double d -> d
1117 | _ -> 0.0
1119 let get_pretransfertime conn =
1120 match (getinfo conn CURLINFO_PRETRANSFER_TIME) with
1121 | CURLINFO_Double d -> d
1122 | _ -> 0.0
1124 let get_sizeupload conn =
1125 match (getinfo conn CURLINFO_SIZE_UPLOAD) with
1126 | CURLINFO_Double d -> d
1127 | _ -> 0.0
1129 let get_sizedownload conn =
1130 match (getinfo conn CURLINFO_SIZE_DOWNLOAD) with
1131 | CURLINFO_Double d -> d
1132 | _ -> 0.0
1134 let get_speeddownload conn =
1135 match (getinfo conn CURLINFO_SPEED_DOWNLOAD) with
1136 | CURLINFO_Double d -> d
1137 | _ -> 0.0
1139 let get_speedupload conn =
1140 match (getinfo conn CURLINFO_SPEED_UPLOAD) with
1141 | CURLINFO_Double d -> d
1142 | _ -> 0.0
1144 let get_headersize conn =
1145 match (getinfo conn CURLINFO_HEADER_SIZE) with
1146 | CURLINFO_Long l -> l
1147 | _ -> 0
1149 let get_requestsize conn =
1150 match (getinfo conn CURLINFO_REQUEST_SIZE) with
1151 | CURLINFO_Long l -> l
1152 | _ -> 0
1154 let get_sslverifyresult conn =
1155 match (getinfo conn CURLINFO_SSL_VERIFYRESULT) with
1156 | CURLINFO_Long l -> l
1157 | _ -> 0
1159 let get_filetime conn =
1160 match (getinfo conn CURLINFO_FILETIME) with
1161 | CURLINFO_Double d -> d
1162 | _ -> 0.0
1164 let get_contentlengthdownload conn =
1165 match (getinfo conn CURLINFO_CONTENT_LENGTH_DOWNLOAD) with
1166 | CURLINFO_Double d -> d
1167 | _ -> 0.0
1169 let get_contentlengthupload conn =
1170 match (getinfo conn CURLINFO_CONTENT_LENGTH_UPLOAD) with
1171 | CURLINFO_Double d -> d
1172 | _ -> 0.0
1174 let get_starttransfertime conn =
1175 match (getinfo conn CURLINFO_STARTTRANSFER_TIME) with
1176 | CURLINFO_Double d -> d
1177 | _ -> 0.0
1179 let get_contenttype conn =
1180 match (getinfo conn CURLINFO_CONTENT_TYPE) with
1181 | CURLINFO_String s -> s
1182 | _ -> ""
1184 let get_redirecttime conn =
1185 match (getinfo conn CURLINFO_REDIRECT_TIME) with
1186 | CURLINFO_Double d -> d
1187 | _ -> 0.0
1189 let get_redirectcount conn =
1190 match (getinfo conn CURLINFO_REDIRECT_COUNT) with
1191 | CURLINFO_Long l -> l
1192 | _ -> 0
1194 let get_private conn =
1195 match (getinfo conn CURLINFO_PRIVATE) with
1196 | CURLINFO_String s -> s
1197 | _ -> ""
1199 let get_httpconnectcode conn =
1200 match (getinfo conn CURLINFO_HTTP_CONNECTCODE) with
1201 | CURLINFO_Long l -> l
1202 | _ -> 0
1204 let get_certinfo conn =
1205 match (getinfo conn CURLINFO_CERTINFO) with
1206 | CURLINFO_StringListList l -> l
1207 | _ -> []
1209 let generate_auth auth =
1210 let result = ref [] in
1211 if auth land 1 != 0 then result := [CURLAUTH_BASIC];
1212 if auth land 2 != 0 then result := CURLAUTH_DIGEST :: !result;
1213 if auth land 4 != 0 then result := CURLAUTH_GSSNEGOTIATE :: !result;
1214 if auth land 8 != 0 then result := CURLAUTH_NTLM :: !result;
1215 !result
1217 let get_httpauthavail conn =
1218 match (getinfo conn CURLINFO_HTTPAUTH_AVAIL) with
1219 | CURLINFO_Long l -> generate_auth l
1220 | _ -> []
1222 let get_proxyauthavail conn =
1223 match (getinfo conn CURLINFO_PROXYAUTH_AVAIL) with
1224 | CURLINFO_Long l -> generate_auth l
1225 | _ -> []
1227 let get_oserrno conn =
1228 match (getinfo conn CURLINFO_OS_ERRNO) with
1229 | CURLINFO_Long l -> l
1230 | _ -> 0
1232 let get_numconnects conn =
1233 match (getinfo conn CURLINFO_NUM_CONNECTS) with
1234 | CURLINFO_Long l -> l
1235 | _ -> 0
1237 let get_sslengines conn =
1238 match (getinfo conn CURLINFO_SSL_ENGINES) with
1239 | CURLINFO_StringList l -> l
1240 | _ -> []
1242 let get_cookielist conn =
1243 match (getinfo conn CURLINFO_COOKIELIST) with
1244 | CURLINFO_StringList l -> l
1245 | _ -> []
1247 let get_lastsocket conn =
1248 match (getinfo conn CURLINFO_LASTSOCKET) with
1249 | CURLINFO_Long l -> l
1250 | _ -> 0
1252 let get_activesocket conn =
1253 match (getinfo conn CURLINFO_ACTIVESOCKET) with
1254 | CURLINFO_Socket s -> Some s
1255 | _ -> None
1257 let get_ftpentrypath conn =
1258 match (getinfo conn CURLINFO_FTP_ENTRY_PATH) with
1259 | CURLINFO_String s -> s
1260 | _ -> ""
1262 let get_primaryip conn =
1263 match (getinfo conn CURLINFO_PRIMARY_IP) with
1264 | CURLINFO_String s -> s
1265 | _ -> ""
1267 let get_localip conn =
1268 match (getinfo conn CURLINFO_LOCAL_IP) with
1269 | CURLINFO_String s -> s
1270 | _ -> ""
1272 let get_localport conn =
1273 match (getinfo conn CURLINFO_LOCAL_PORT) with
1274 | CURLINFO_Long n -> n
1275 | _ -> 0
1277 let get_conditionunmet conn =
1278 match (getinfo conn CURLINFO_CONDITION_UNMET) with
1279 | CURLINFO_Long n -> n <> 0
1280 | _ -> assert false
1282 let get_http_version conn =
1283 match (getinfo conn CURLINFO_HTTP_VERSION) with
1284 | CURLINFO_Version v -> v
1285 | _ -> assert false
1287 let () =
1288 Callback.register_exception "CurlException"
1289 (CurlException (CURLE_OK, 0, ""))
1291 class handle =
1292 object
1293 val conn = init ()
1294 method handle = conn
1295 method perform = perform conn
1296 method cleanup = cleanup conn
1297 method set_writefunction closure = set_writefunction conn closure
1298 method set_writefunction2 closure = set_writefunction2 conn closure
1299 method set_readfunction closure = set_readfunction conn closure
1300 method set_readfunction2 closure = set_readfunction2 conn closure
1301 method set_infilesize size = set_infilesize conn size
1302 method set_url url = set_url conn url
1303 method set_proxy proxy = set_proxy conn proxy
1304 method set_proxyport proxyport = set_proxyport conn proxyport
1305 method set_httpproxytunnel flag = set_httpproxytunnel conn flag
1306 method set_verbose flag = set_verbose conn flag
1307 method set_header flag = set_header conn flag
1308 method set_noprogress flag = set_noprogress conn flag
1309 method set_nosignal flag = set_nosignal conn flag
1310 method set_nobody flag = set_nobody conn flag
1311 method set_failonerror flag = set_failonerror conn flag
1312 method set_upload flag = set_upload conn flag
1313 method set_post flag = set_post conn flag
1314 method set_ftplistonly flag = set_ftplistonly conn flag
1315 method set_ftpappend flag = set_ftpappend conn flag
1316 method set_netrc netrc = set_netrc conn netrc
1317 method set_encoding encoding = set_encoding conn encoding
1318 method set_followlocation flag = set_followlocation conn flag
1319 method set_transfertext flag = set_transfertext conn flag
1320 method set_put flag = set_put conn flag
1321 method set_userpwd userpwd = set_userpwd conn userpwd
1322 method set_proxyuserpwd proxyuserpwd = set_proxyuserpwd conn proxyuserpwd
1323 method set_range range = set_range conn range
1324 method set_errorbuffer errorbuffer = set_errorbuffer conn errorbuffer
1325 method set_timeout timeout = set_timeout conn timeout
1326 method set_postfields postfields = set_postfields conn postfields
1327 method set_referer referer = set_referer conn referer
1328 method set_useragent useragent = set_useragent conn useragent
1329 method set_ftpport ftpport = set_ftpport conn ftpport
1330 method set_lowspeedlimit lowspeedlimit = set_lowspeedlimit conn lowspeedlimit
1331 method set_lowspeedtime lowspeedtime = set_lowspeedtime conn lowspeedtime
1332 method set_resumefrom resumefrom = set_resumefrom conn resumefrom
1333 method set_cookie cookie = set_cookie conn cookie
1334 method set_httpheader httpheader = set_httpheader conn httpheader
1335 method set_httppost httppost = set_httppost conn httppost
1336 method set_sslcert sslcert = set_sslcert conn sslcert
1337 method set_sslcerttype sslcerttype = set_sslcerttype conn sslcerttype
1338 method set_sslcertpasswd sslcertpasswd = set_sslcertpasswd conn sslcertpasswd
1339 method set_sslkey sslkey = set_sslkey conn sslkey
1340 method set_sslkeytype sslkeytype = set_sslkeytype conn sslkeytype
1341 method set_sslkeypasswd sslkeypasswd = set_sslkeypasswd conn sslkeypasswd
1342 method set_sslengine sslengine = set_sslengine conn sslengine
1343 method set_sslenginedefault flag = set_sslenginedefault conn flag
1344 method set_certinfo flag = set_certinfo conn flag
1345 method set_crlf flag = set_crlf conn flag
1346 method set_quote quote = set_quote conn quote
1347 method set_postquote postquote = set_postquote conn postquote
1348 method set_headerfunction closure = set_headerfunction conn closure
1349 method set_cookiefile cookiefile = set_cookiefile conn cookiefile
1350 method set_sslversion sslversion = set_sslversion conn sslversion
1351 method set_timecondition timecondition = set_timecondition conn timecondition
1352 method set_timevalue timevalue = set_timevalue conn timevalue
1353 method set_customrequest customrequest = set_customrequest conn customrequest
1354 method set_interface interface = set_interface conn interface
1355 method set_krb4level krb4level = set_krb4level conn krb4level
1356 method set_progressfunction closure = set_progressfunction conn closure
1357 method set_xferinfofunction closure = set_xferinfofunction conn closure
1358 method set_sslverifypeer flag = set_sslverifypeer conn flag
1359 method set_cainfo cainfo = set_cainfo conn cainfo
1360 method set_capath capath = set_capath conn capath
1361 method set_filetime filetime = set_filetime conn filetime
1362 method set_maxredirs maxredirs = set_maxredirs conn maxredirs
1363 method set_maxconnects maxconnects = set_maxconnects conn maxconnects
1364 method set_closepolicy closepolicy = set_closepolicy conn closepolicy
1365 method set_freshconnect flag = set_freshconnect conn flag
1366 method set_forbidreuse flag = set_forbidreuse conn flag
1367 method set_randomfile randomfile = set_randomfile conn randomfile
1368 method set_egdsocket egdsocket = set_egdsocket conn egdsocket
1369 method set_connecttimeout connecttimeout =
1370 set_connecttimeout conn connecttimeout
1371 method set_httpget flag = set_httpget conn flag
1372 method set_sslverifyhost sslverifyhost = set_sslverifyhost conn sslverifyhost
1373 method set_cookiejar cookiejar = set_cookiejar conn cookiejar
1374 method set_sslcipherlist sslcipherlist = set_sslcipherlist conn sslcipherlist
1375 method set_httpversion httpversion = set_httpversion conn httpversion
1376 method set_ftpuseepsv flag = set_ftpuseepsv conn flag
1377 method set_dnscachetimeout dnscachetimeout = set_dnscachetimeout conn dnscachetimeout
1378 method set_dnsuseglobalcache flag = set_dnsuseglobalcache conn flag
1379 method set_debugfunction closure = set_debugfunction conn closure
1380 method set_private privateData = set_private conn privateData
1381 method set_http200aliases aliases = set_http200aliases conn aliases
1382 method set_unrestrictedauth flag = set_unrestrictedauth conn flag
1383 method set_ftpuseeprt flag = set_ftpuseeprt conn flag
1384 method set_httpauth auth = set_httpauth conn auth
1385 method set_ftpcreatemissingdirs flag = set_ftpcreatemissingdirs conn flag
1386 method set_proxyauth auth = set_proxyauth conn auth
1387 method set_ftpresponsetimeout timeout = set_ftpresponsetimeout conn timeout
1388 method set_ipresolve ipresolve = set_ipresolve conn ipresolve
1389 method set_maxfilesize size = set_maxfilesize conn size
1390 method set_infilesizelarge size = set_infilesizelarge conn size
1391 method set_resumefromlarge size = set_resumefromlarge conn size
1392 method set_maxfilesizelarge size = set_maxfilesizelarge conn size
1393 method set_netrcfile file = set_netrcfile conn file
1394 method set_ftpssl ftpssl = set_ftpssl conn ftpssl
1395 method set_postfieldsize size = set_postfieldsize conn size
1396 method set_postfieldsizelarge size = set_postfieldsizelarge conn size
1397 method set_tcpnodelay flag = set_tcpnodelay conn flag
1398 method set_tcpfastopen flag = set_tcpfastopen conn flag
1399 method set_ftpsslauth flag = set_ftpsslauth conn flag
1400 method set_ioctlfunction closure = set_ioctlfunction conn closure
1401 method set_ftpaccount account = set_ftpaccount conn account
1402 method set_cookielist cookielist = set_cookielist conn cookielist
1403 method set_ignorecontentlength flag = set_ignorecontentlength conn flag
1404 method set_ftpskippasvip flag = set_ftpskippasvip conn flag
1405 method set_ftpfilemethod ftpMethod = set_ftpfilemethod conn ftpMethod
1406 method set_localport port = set_localport conn port
1407 method set_localportrange range = set_localportrange conn range
1408 method set_connectonly flag = set_connectonly conn flag
1409 method set_maxsendspeedlarge speed = set_maxsendspeedlarge conn speed
1410 method set_maxrecvspeedlarge speed = set_maxrecvspeedlarge conn speed
1411 method set_ftpalternativetouser user = set_ftpalternativetouser conn user
1412 method set_sslsessionidcache flag = set_sslsessionidcache conn flag
1413 method set_sshauthtypes types = set_sshauthtypes conn types
1414 method set_sshpublickeyfile keyfile = set_sshpublickeyfile conn keyfile
1415 method set_sshprivatekeyfile keyfile = set_sshprivatekeyfile conn keyfile
1416 method set_ftpsslccc ccc = set_ftpsslccc conn ccc
1417 method set_timeoutms ms = set_timeoutms conn ms
1418 method set_connecttimeoutms ms = set_connecttimeoutms conn ms
1419 method set_httptransferdecoding flag = set_httptransferdecoding conn flag
1420 method set_httpcontentdecoding flag = set_httpcontentdecoding conn flag
1421 method set_newfileperms perms = set_newfileperms conn perms
1422 method set_newdirectoryperms perms = set_newdirectoryperms conn perms
1423 method set_post301 flag = set_post301 conn flag
1424 method set_sshhostpublickeymd5 key = set_sshhostpublickeymd5 conn key
1425 method set_copypostfields post = set_copypostfields conn post
1426 method set_proxytransfermode flag = set_proxytransfermode conn flag
1427 method set_seekfunction closure = set_seekfunction conn closure
1428 method set_resolve l = set_resolve conn l
1429 method set_dns_servers l = set_dns_servers conn l
1430 method set_autoreferer b = set_autoreferer conn b
1431 method set_opensocketfunction closure = set_opensocketfunction conn closure
1432 (* method set_closesocketfunction closure = set_closesocketfunction conn closure *)
1433 method set_proxytype t = set_proxytype conn t
1434 method set_mimepost p = set_mimepost conn p
1435 method set_sshknownhosts s = set_sshknownhosts conn s
1436 method set_sshkeyfunction f = set_sshkeyfunction conn f
1437 method set_buffersize buffersize = set_buffersize conn buffersize
1438 method set_doh_url url = set_doh_url conn url
1439 method set_ssl_options opts = set_ssl_options conn opts
1441 method get_effectiveurl = get_effectiveurl conn
1442 method get_redirecturl = get_redirecturl conn
1443 method get_responsecode = get_responsecode conn
1444 method get_httpcode = get_responsecode conn
1445 method get_totaltime = get_totaltime conn
1446 method get_namelookuptime = get_namelookuptime conn
1447 method get_connecttime = get_connecttime conn
1448 method get_pretransfertime = get_pretransfertime conn
1449 method get_sizeupload = get_sizeupload conn
1450 method get_sizedownload = get_sizedownload conn
1451 method get_speeddownload = get_speeddownload conn
1452 method get_speedupload = get_speedupload conn
1453 method get_headersize = get_headersize conn
1454 method get_requestsize = get_requestsize conn
1455 method get_sslverifyresult = get_sslverifyresult conn
1456 method get_filetime = get_filetime conn
1457 method get_contentlengthdownload = get_contentlengthdownload conn
1458 method get_contentlengthupload = get_contentlengthupload conn
1459 method get_starttransfertime = get_starttransfertime conn
1460 method get_contenttype = get_contenttype conn
1461 method get_redirecttime = get_redirecttime conn
1462 method get_redirectcount = get_redirectcount conn
1463 method get_private = get_private conn
1464 method get_httpconnectcode = get_httpconnectcode conn
1465 method get_httpauthavail = get_httpauthavail conn
1466 method get_proxyauthavail = get_proxyauthavail conn
1467 method get_oserrno = get_oserrno conn
1468 method get_numconnects = get_numconnects conn
1469 method get_sslengines = get_sslengines conn
1470 method get_cookielist = get_cookielist conn
1471 method get_lastsocket = get_lastsocket conn
1472 method get_activesocket = get_activesocket conn
1473 method get_ftpentrypath = get_ftpentrypath conn
1474 method get_primaryip = get_primaryip conn
1475 method get_localip = get_localip conn
1476 method get_localport = get_localport conn
1477 method get_conditionunmet = get_conditionunmet conn
1478 method get_certinfo = get_certinfo conn
1479 method get_http_version = get_http_version conn
1482 module Multi = struct
1484 type mt
1486 type curlPipelining = PIPE_NOTHING | PIPE_HTTP1 | PIPE_MULTIPLEX
1488 type curlMultiOption =
1489 | CURLMOPT_PIPELINING of curlPipelining list
1490 | CURLMOPT_MAXCONNECTS of int
1491 | CURLMOPT_MAX_PIPELINE_LENGTH of int
1492 | CURLMOPT_MAX_HOST_CONNECTIONS of int
1493 | CURLMOPT_MAX_TOTAL_CONNECTIONS of int
1495 exception Error of string
1497 type cerror = int
1499 exception CError of string * cerror * string
1501 let () = Callback.register_exception "Curl.Multi.Error" (Error "")
1502 let () = Callback.register_exception "Curl.Multi.CError" (CError ("",0,""))
1504 external create : unit -> mt = "caml_curl_multi_init"
1505 external add : mt -> t -> unit = "caml_curl_multi_add_handle"
1506 external perform : mt -> int = "caml_curl_multi_perform_all"
1507 external wait : int -> mt -> bool = "caml_curl_multi_wait"
1508 let wait ?(timeout_ms=1000) mt = wait timeout_ms mt
1509 external poll : int -> mt -> bool = "caml_curl_multi_poll"
1510 let poll ?(timeout_ms=1000) mt = poll timeout_ms mt
1511 external remove : mt -> t -> unit = "caml_curl_multi_remove_handle"
1512 external remove_finished : mt -> (t * curlCode) option = "caml_curlm_remove_finished"
1513 external cleanup : mt -> unit = "caml_curl_multi_cleanup"
1515 (* see curlm_sock_cb *)
1516 type poll = POLL_NONE | POLL_IN | POLL_OUT | POLL_INOUT | POLL_REMOVE
1518 (* see caml_curl_multi_socket_action *)
1519 type fd_status = EV_AUTO | EV_IN | EV_OUT | EV_INOUT
1521 external set_socket_function : mt -> (Unix.file_descr -> poll -> unit) -> unit = "caml_curl_multi_socketfunction"
1522 external set_timer_function : mt -> (int -> unit) -> unit = "caml_curl_multi_timerfunction"
1523 external action_all : mt -> int = "caml_curl_multi_socket_all"
1524 external socket_action : mt -> Unix.file_descr option -> fd_status -> int = "caml_curl_multi_socket_action"
1526 let action_timeout mt = ignore (socket_action mt None EV_AUTO)
1527 let action mt fd status = socket_action mt (Some fd) status
1529 external timeout : mt -> int = "caml_curl_multi_timeout"
1531 external setopt : mt -> curlMultiOption -> unit = "caml_curl_multi_setopt"