curl

package module
v0.0.0-...-0446279 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 8, 2023 License: Apache-2.0 Imports: 9 Imported by: 0

README

go-curl

Build Status

my golang libcurl(curl) binding.

See more examples in ./examples/ directory~!

LICENSE

go-curl is licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

Current Development Status

  • currently stable
  • READ, WRITE, HEADER, PROGRESS function callback
  • a Multipart Form supports file uploading
  • Most curl_easy_setopt option
  • partly implement share & multi interface
  • new callback function prototype

How to Install

Make Sure You Have libcurl (and its develop headers, static/dynamic libs) installed!

$ go get -u github.com/andelf/go-curl

Current Status

  • Linux x64
    • passed go1 (ArchLinux)
  • Windows x86
    • passed go1 (win7, mingw-gcc 4.5.2, curl 7.22.0)
  • Mac OS
    • passed go1 (Mac OS X 10.7.3, curl 7.21.4)

Sample Program

package main

import (
    "fmt"
    curl "github.com/andelf/go-curl"
)

func main() {
    easy := curl.EasyInit()
    defer easy.Cleanup()

    easy.Setopt(curl.OPT_URL, "http://www.baidu.com/")

    // make a callback function
    fooTest := func (buf []byte, userdata interface{}) bool {
        println("DEBUG: size=>", len(buf))
        println("DEBUG: content=>", string(buf))
        return true
    }

    easy.Setopt(curl.OPT_WRITEFUNCTION, fooTest)

    if err := easy.Perform(); err != nil {
        fmt.Printf("ERROR: %v\n", err)
    }
}

Documentation

Overview

libcurl go bingding

Index

Constants

View Source
const (
	GLOBAL_SSL     = C.CURL_GLOBAL_SSL
	GLOBAL_WIN32   = C.CURL_GLOBAL_WIN32
	GLOBAL_ALL     = C.CURL_GLOBAL_ALL
	GLOBAL_NOTHING = C.CURL_GLOBAL_NOTHING
	GLOBAL_DEFAULT = C.CURL_GLOBAL_DEFAULT
)

for GlobalInit(flag)

View Source
const (
	M_CALL_MULTI_PERFORM = C.CURLM_CALL_MULTI_PERFORM
	//        M_OK                 = C.CURLM_OK
	M_BAD_HANDLE      = C.CURLM_BAD_HANDLE
	M_BAD_EASY_HANDLE = C.CURLM_BAD_EASY_HANDLE
	M_OUT_OF_MEMORY   = C.CURLM_OUT_OF_MEMORY
	M_INTERNAL_ERROR  = C.CURLM_INTERNAL_ERROR
	M_BAD_SOCKET      = C.CURLM_BAD_SOCKET
	M_UNKNOWN_OPTION  = C.CURLM_UNKNOWN_OPTION
)

CURLMcode

View Source
const (
	MOPT_SOCKETFUNCTION = C.CURLMOPT_SOCKETFUNCTION
	MOPT_SOCKETDATA     = C.CURLMOPT_SOCKETDATA
	MOPT_PIPELINING     = C.CURLMOPT_PIPELINING
	MOPT_TIMERFUNCTION  = C.CURLMOPT_TIMERFUNCTION
	MOPT_TIMERDATA      = C.CURLMOPT_TIMERDATA
	MOPT_MAXCONNECTS    = C.CURLMOPT_MAXCONNECTS
)

for multi.Setopt(flag, ...)

View Source
const (
	//        SHE_OK         = C.CURLSHE_OK
	SHE_BAD_OPTION = C.CURLSHE_BAD_OPTION
	SHE_IN_USE     = C.CURLSHE_IN_USE
	SHE_INVALID    = C.CURLSHE_INVALID
	SHE_NOMEM      = C.CURLSHE_NOMEM
)

CURLSHcode

View Source
const (
	SHOPT_SHARE      = C.CURLSHOPT_SHARE
	SHOPT_UNSHARE    = C.CURLSHOPT_UNSHARE
	SHOPT_LOCKFUNC   = C.CURLSHOPT_LOCKFUNC
	SHOPT_UNLOCKFUNC = C.CURLSHOPT_UNLOCKFUNC
	SHOPT_USERDATA   = C.CURLSHOPT_USERDATA
)

for share.Setopt(flat, ...)

View Source
const (
	LOCK_DATA_SHARE       = C.CURL_LOCK_DATA_SHARE
	LOCK_DATA_COOKIE      = C.CURL_LOCK_DATA_COOKIE
	LOCK_DATA_DNS         = C.CURL_LOCK_DATA_DNS
	LOCK_DATA_SSL_SESSION = C.CURL_LOCK_DATA_SSL_SESSION
	LOCK_DATA_CONNECT     = C.CURL_LOCK_DATA_CONNECT
)

for share.Setopt(SHOPT_SHARE/SHOPT_UNSHARE, flag)

View Source
const (
	VERSION_FIRST  = C.CURLVERSION_FIRST
	VERSION_SECOND = C.CURLVERSION_SECOND
	VERSION_THIRD  = C.CURLVERSION_THIRD
	// VERSION_FOURTH = C.CURLVERSION_FOURTH
	VERSION_LAST = C.CURLVERSION_LAST
	VERSION_NOW  = C.CURLVERSION_NOW
)

for VersionInfo(flag)

View Source
const (
	VERSION_IPV6         = C.CURL_VERSION_IPV6
	VERSION_KERBEROS4    = C.CURL_VERSION_KERBEROS4
	VERSION_SSL          = C.CURL_VERSION_SSL
	VERSION_LIBZ         = C.CURL_VERSION_LIBZ
	VERSION_NTLM         = C.CURL_VERSION_NTLM
	VERSION_GSSNEGOTIATE = C.CURL_VERSION_GSSNEGOTIATE
	VERSION_DEBUG        = C.CURL_VERSION_DEBUG
	VERSION_ASYNCHDNS    = C.CURL_VERSION_ASYNCHDNS
	VERSION_SPNEGO       = C.CURL_VERSION_SPNEGO
	VERSION_LARGEFILE    = C.CURL_VERSION_LARGEFILE
	VERSION_IDN          = C.CURL_VERSION_IDN
	VERSION_SSPI         = C.CURL_VERSION_SSPI
	VERSION_CONV         = C.CURL_VERSION_CONV
	VERSION_CURLDEBUG    = C.CURL_VERSION_CURLDEBUG
	VERSION_TLSAUTH_SRP  = C.CURL_VERSION_TLSAUTH_SRP
	VERSION_NTLM_WB      = C.CURL_VERSION_NTLM_WB
)

for VersionInfo(...).Features mask flag

View Source
const (
	READFUNC_ABORT = C.CURL_READFUNC_ABORT
	READFUNC_PAUSE = C.CURL_READFUNC_PAUSE
)

for OPT_READFUNCTION, return a int flag

View Source
const (
	HTTP_VERSION_NONE = C.CURL_HTTP_VERSION_NONE
	HTTP_VERSION_1_0  = C.CURL_HTTP_VERSION_1_0
	HTTP_VERSION_1_1  = C.CURL_HTTP_VERSION_1_1
)

for easy.Setopt(OPT_HTTP_VERSION, flag)

View Source
const (
	PROXY_HTTP     = C.CURLPROXY_HTTP     /* added in 7.10, new in 7.19.4 default is to use CONNECT HTTP/1.1 */
	PROXY_HTTP_1_0 = C.CURLPROXY_HTTP_1_0 /* added in 7.19.4, force to use CONNECT HTTP/1.0  */
	PROXY_SOCKS4   = C.CURLPROXY_SOCKS4   /* support added in 7.15.2, enum existed already in 7.10 */
	PROXY_SOCKS5   = C.CURLPROXY_SOCKS5   /* added in 7.10 */
	PROXY_SOCKS4A  = C.CURLPROXY_SOCKS4A  /* added in 7.18.0 */
	// Use the SOCKS5 protocol but pass along the host name rather than the IP address.
	PROXY_SOCKS5_HOSTNAME = C.CURLPROXY_SOCKS5_HOSTNAME
)

for easy.Setopt(OPT_PROXYTYPE, flag)

View Source
const (
	SSLVERSION_DEFAULT = C.CURL_SSLVERSION_DEFAULT
	SSLVERSION_TLSv1   = C.CURL_SSLVERSION_TLSv1
	SSLVERSION_SSLv2   = C.CURL_SSLVERSION_SSLv2
	SSLVERSION_SSLv3   = C.CURL_SSLVERSION_SSLv3
	SSLVERSION_TLSv1_3 = C.CURL_SSLVERSION_TLSv1_3
)

for easy.Setopt(OPT_SSLVERSION, flag)

View Source
const (
	TIMECOND_NONE         = C.CURL_TIMECOND_NONE
	TIMECOND_IFMODSINCE   = C.CURL_TIMECOND_IFMODSINCE
	TIMECOND_IFUNMODSINCE = C.CURL_TIMECOND_IFUNMODSINCE
	TIMECOND_LASTMOD      = C.CURL_TIMECOND_LASTMOD
)

for easy.Setopt(OPT_TIMECONDITION, flag)

View Source
const (
	NETRC_IGNORED  = C.CURL_NETRC_IGNORED
	NETRC_OPTIONAL = C.CURL_NETRC_OPTIONAL
	NETRC_REQUIRED = C.CURL_NETRC_REQUIRED
)

for easy.Setopt(OPT_NETRC, flag)

View Source
const (
	FTP_CREATE_DIR_NONE  = C.CURLFTP_CREATE_DIR_NONE
	FTP_CREATE_DIR       = C.CURLFTP_CREATE_DIR
	FTP_CREATE_DIR_RETRY = C.CURLFTP_CREATE_DIR_RETRY
)

for easy.Setopt(OPT_FTP_CREATE_MISSING_DIRS, flag)

View Source
const (
	IPRESOLVE_WHATEVER = C.CURL_IPRESOLVE_WHATEVER
	IPRESOLVE_V4       = C.CURL_IPRESOLVE_V4
	IPRESOLVE_V6       = C.CURL_IPRESOLVE_V6
)

for easy.Setopt(OPT_IPRESOLVE, flag)

View Source
const (
	PAUSE_RECV      = C.CURLPAUSE_RECV
	PAUSE_RECV_CONT = C.CURLPAUSE_RECV_CONT
	PAUSE_SEND      = C.CURLPAUSE_SEND
	PAUSE_SEND_CONT = C.CURLPAUSE_SEND_CONT
	PAUSE_ALL       = C.CURLPAUSE_ALL
	PAUSE_CONT      = C.CURLPAUSE_CONT
)

for easy.Pause(flat)

View Source
const (
	CURLMSG_NONE = C.CURLMSG_NONE
	CURLMSG_DONE = C.CURLMSG_DONE
	CURLMSG_LAST = C.CURLMSG_LAST
)

for multi.Info_read()

View Source
const (
	E_UNSUPPORTED_PROTOCOL        = C.CURLE_UNSUPPORTED_PROTOCOL
	E_FAILED_INIT                 = C.CURLE_FAILED_INIT
	E_URL_MALFORMAT               = C.CURLE_URL_MALFORMAT
	E_URL_MALFORMAT_USER          = C.CURLE_URL_MALFORMAT_USER
	E_COULDNT_RESOLVE_PROXY       = C.CURLE_COULDNT_RESOLVE_PROXY
	E_COULDNT_RESOLVE_HOST        = C.CURLE_COULDNT_RESOLVE_HOST
	E_COULDNT_CONNECT             = C.CURLE_COULDNT_CONNECT
	E_FTP_WEIRD_SERVER_REPLY      = C.CURLE_FTP_WEIRD_SERVER_REPLY
	E_FTP_ACCESS_DENIED           = C.CURLE_FTP_ACCESS_DENIED
	E_FTP_USER_PASSWORD_INCORRECT = C.CURLE_FTP_USER_PASSWORD_INCORRECT
	E_FTP_WEIRD_PASS_REPLY        = C.CURLE_FTP_WEIRD_PASS_REPLY
	E_FTP_WEIRD_USER_REPLY        = C.CURLE_FTP_WEIRD_USER_REPLY
	E_FTP_WEIRD_PASV_REPLY        = C.CURLE_FTP_WEIRD_PASV_REPLY
	E_FTP_WEIRD_227_FORMAT        = C.CURLE_FTP_WEIRD_227_FORMAT
	E_FTP_CANT_GET_HOST           = C.CURLE_FTP_CANT_GET_HOST
	E_FTP_CANT_RECONNECT          = C.CURLE_FTP_CANT_RECONNECT
	E_FTP_COULDNT_SET_BINARY      = C.CURLE_FTP_COULDNT_SET_BINARY
	E_PARTIAL_FILE                = C.CURLE_PARTIAL_FILE
	E_FTP_COULDNT_RETR_FILE       = C.CURLE_FTP_COULDNT_RETR_FILE
	E_FTP_WRITE_ERROR             = C.CURLE_FTP_WRITE_ERROR
	E_FTP_QUOTE_ERROR             = C.CURLE_FTP_QUOTE_ERROR
	E_HTTP_RETURNED_ERROR         = C.CURLE_HTTP_RETURNED_ERROR
	E_WRITE_ERROR                 = C.CURLE_WRITE_ERROR
	E_MALFORMAT_USER              = C.CURLE_MALFORMAT_USER
	E_FTP_COULDNT_STOR_FILE       = C.CURLE_FTP_COULDNT_STOR_FILE
	E_READ_ERROR                  = C.CURLE_READ_ERROR
	E_OUT_OF_MEMORY               = C.CURLE_OUT_OF_MEMORY
	E_OPERATION_TIMEOUTED         = C.CURLE_OPERATION_TIMEOUTED
	E_FTP_COULDNT_SET_ASCII       = C.CURLE_FTP_COULDNT_SET_ASCII
	E_FTP_PORT_FAILED             = C.CURLE_FTP_PORT_FAILED
	E_FTP_COULDNT_USE_REST        = C.CURLE_FTP_COULDNT_USE_REST
	E_FTP_COULDNT_GET_SIZE        = C.CURLE_FTP_COULDNT_GET_SIZE
	E_HTTP_RANGE_ERROR            = C.CURLE_HTTP_RANGE_ERROR
	E_HTTP_POST_ERROR             = C.CURLE_HTTP_POST_ERROR
	E_SSL_CONNECT_ERROR           = C.CURLE_SSL_CONNECT_ERROR
	E_BAD_DOWNLOAD_RESUME         = C.CURLE_BAD_DOWNLOAD_RESUME
	E_FILE_COULDNT_READ_FILE      = C.CURLE_FILE_COULDNT_READ_FILE
	E_LDAP_CANNOT_BIND            = C.CURLE_LDAP_CANNOT_BIND
	E_LDAP_SEARCH_FAILED          = C.CURLE_LDAP_SEARCH_FAILED
	E_LIBRARY_NOT_FOUND           = C.CURLE_LIBRARY_NOT_FOUND
	E_FUNCTION_NOT_FOUND          = C.CURLE_FUNCTION_NOT_FOUND
	E_ABORTED_BY_CALLBACK         = C.CURLE_ABORTED_BY_CALLBACK
	E_BAD_FUNCTION_ARGUMENT       = C.CURLE_BAD_FUNCTION_ARGUMENT
	E_BAD_CALLING_ORDER           = C.CURLE_BAD_CALLING_ORDER
	E_INTERFACE_FAILED            = C.CURLE_INTERFACE_FAILED
	E_BAD_PASSWORD_ENTERED        = C.CURLE_BAD_PASSWORD_ENTERED
	E_UNKNOWN_TELNET_OPTION       = C.CURLE_UNKNOWN_TELNET_OPTION
	E_OBSOLETE                    = C.CURLE_OBSOLETE
	E_SSL_PEER_CERTIFICATE        = C.CURLE_SSL_PEER_CERTIFICATE
	E_GOT_NOTHING                 = C.CURLE_GOT_NOTHING
	E_SSL_ENGINE_NOTFOUND         = C.CURLE_SSL_ENGINE_NOTFOUND
	E_SSL_ENGINE_SETFAILED        = C.CURLE_SSL_ENGINE_SETFAILED
	E_SEND_ERROR                  = C.CURLE_SEND_ERROR
	E_RECV_ERROR                  = C.CURLE_RECV_ERROR
	E_SHARE_IN_USE                = C.CURLE_SHARE_IN_USE
	E_SSL_CERTPROBLEM             = C.CURLE_SSL_CERTPROBLEM
	E_SSL_CIPHER                  = C.CURLE_SSL_CIPHER
	E_SSL_CACERT                  = C.CURLE_SSL_CACERT
	E_BAD_CONTENT_ENCODING        = C.CURLE_BAD_CONTENT_ENCODING
	E_LDAP_INVALID_URL            = C.CURLE_LDAP_INVALID_URL
	E_FILESIZE_EXCEEDED           = C.CURLE_FILESIZE_EXCEEDED
	E_FTP_SSL_FAILED              = C.CURLE_FTP_SSL_FAILED
	E_SEND_FAIL_REWIND            = C.CURLE_SEND_FAIL_REWIND
	E_SSL_ENGINE_INITFAILED       = C.CURLE_SSL_ENGINE_INITFAILED
	E_LOGIN_DENIED                = C.CURLE_LOGIN_DENIED
	E_TFTP_NOTFOUND               = C.CURLE_TFTP_NOTFOUND
	E_TFTP_PERM                   = C.CURLE_TFTP_PERM
	E_TFTP_DISKFULL               = C.CURLE_TFTP_DISKFULL
	E_TFTP_ILLEGAL                = C.CURLE_TFTP_ILLEGAL
	E_TFTP_UNKNOWNID              = C.CURLE_TFTP_UNKNOWNID
	E_TFTP_EXISTS                 = C.CURLE_TFTP_EXISTS
	E_TFTP_NOSUCHUSER             = C.CURLE_TFTP_NOSUCHUSER
	E_CONV_FAILED                 = C.CURLE_CONV_FAILED
	E_CONV_REQD                   = C.CURLE_CONV_REQD
	E_SSL_CACERT_BADFILE          = C.CURLE_SSL_CACERT_BADFILE
	E_OPERATION_TIMEDOUT          = C.CURLE_OPERATION_TIMEDOUT
	E_HTTP_NOT_FOUND              = C.CURLE_HTTP_NOT_FOUND
	E_HTTP_PORT_FAILED            = C.CURLE_HTTP_PORT_FAILED
	E_ALREADY_COMPLETE            = C.CURLE_ALREADY_COMPLETE
	E_FTP_PARTIAL_FILE            = C.CURLE_FTP_PARTIAL_FILE
	E_FTP_BAD_DOWNLOAD_RESUME     = C.CURLE_FTP_BAD_DOWNLOAD_RESUME
)

CURLcode

View Source
const (
	OPT_FILE                       = C.CURLOPT_FILE
	OPT_URL                        = C.CURLOPT_URL
	OPT_PORT                       = C.CURLOPT_PORT
	OPT_PROXY                      = C.CURLOPT_PROXY
	OPT_USERPWD                    = C.CURLOPT_USERPWD
	OPT_PROXYUSERPWD               = C.CURLOPT_PROXYUSERPWD
	OPT_RANGE                      = C.CURLOPT_RANGE
	OPT_INFILE                     = C.CURLOPT_INFILE
	OPT_ERRORBUFFER                = C.CURLOPT_ERRORBUFFER
	OPT_WRITEFUNCTION              = C.CURLOPT_WRITEFUNCTION
	OPT_READFUNCTION               = C.CURLOPT_READFUNCTION
	OPT_TIMEOUT                    = C.CURLOPT_TIMEOUT
	OPT_INFILESIZE                 = C.CURLOPT_INFILESIZE
	OPT_POSTFIELDS                 = C.CURLOPT_POSTFIELDS
	OPT_REFERER                    = C.CURLOPT_REFERER
	OPT_FTPPORT                    = C.CURLOPT_FTPPORT
	OPT_USERAGENT                  = C.CURLOPT_USERAGENT
	OPT_LOW_SPEED_TIME             = C.CURLOPT_LOW_SPEED_TIME
	OPT_RESUME_FROM                = C.CURLOPT_RESUME_FROM
	OPT_COOKIE                     = C.CURLOPT_COOKIE
	OPT_HTTPHEADER                 = C.CURLOPT_HTTPHEADER
	OPT_HTTPPOST                   = C.CURLOPT_HTTPPOST
	OPT_SSLCERT                    = C.CURLOPT_SSLCERT
	OPT_SSLCERTPASSWD              = C.CURLOPT_SSLCERTPASSWD
	OPT_SSLKEYPASSWD               = C.CURLOPT_SSLKEYPASSWD
	OPT_CRLF                       = C.CURLOPT_CRLF
	OPT_QUOTE                      = C.CURLOPT_QUOTE
	OPT_WRITEHEADER                = C.CURLOPT_WRITEHEADER
	OPT_COOKIEFILE                 = C.CURLOPT_COOKIEFILE
	OPT_SSLVERSION                 = C.CURLOPT_SSLVERSION
	OPT_TIMECONDITION              = C.CURLOPT_TIMECONDITION
	OPT_TIMEVALUE                  = C.CURLOPT_TIMEVALUE
	OPT_CUSTOMREQUEST              = C.CURLOPT_CUSTOMREQUEST
	OPT_STDERR                     = C.CURLOPT_STDERR
	OPT_POSTQUOTE                  = C.CURLOPT_POSTQUOTE
	OPT_WRITEINFO                  = C.CURLOPT_WRITEINFO
	OPT_VERBOSE                    = C.CURLOPT_VERBOSE
	OPT_HEADER                     = C.CURLOPT_HEADER
	OPT_NOPROGRESS                 = C.CURLOPT_NOPROGRESS
	OPT_NOBODY                     = C.CURLOPT_NOBODY
	OPT_FAILONERROR                = C.CURLOPT_FAILONERROR
	OPT_UPLOAD                     = C.CURLOPT_UPLOAD
	OPT_POST                       = C.CURLOPT_POST
	OPT_FTPLISTONLY                = C.CURLOPT_FTPLISTONLY
	OPT_FTPAPPEND                  = C.CURLOPT_FTPAPPEND
	OPT_NETRC                      = C.CURLOPT_NETRC
	OPT_FOLLOWLOCATION             = C.CURLOPT_FOLLOWLOCATION
	OPT_TRANSFERTEXT               = C.CURLOPT_TRANSFERTEXT
	OPT_PUT                        = C.CURLOPT_PUT
	OPT_PROGRESSFUNCTION           = C.CURLOPT_PROGRESSFUNCTION
	OPT_PROGRESSDATA               = C.CURLOPT_PROGRESSDATA
	OPT_AUTOREFERER                = C.CURLOPT_AUTOREFERER
	OPT_PROXYPORT                  = C.CURLOPT_PROXYPORT
	OPT_POSTFIELDSIZE              = C.CURLOPT_POSTFIELDSIZE
	OPT_HTTPPROXYTUNNEL            = C.CURLOPT_HTTPPROXYTUNNEL
	OPT_INTERFACE                  = C.CURLOPT_INTERFACE
	OPT_KRB4LEVEL                  = C.CURLOPT_KRB4LEVEL
	OPT_SSL_VERIFYPEER             = C.CURLOPT_SSL_VERIFYPEER
	OPT_CAINFO                     = C.CURLOPT_CAINFO
	OPT_MAXREDIRS                  = C.CURLOPT_MAXREDIRS
	OPT_FILETIME                   = C.CURLOPT_FILETIME
	OPT_TELNETOPTIONS              = C.CURLOPT_TELNETOPTIONS
	OPT_MAXCONNECTS                = C.CURLOPT_MAXCONNECTS
	OPT_CLOSEPOLICY                = C.CURLOPT_CLOSEPOLICY
	OPT_FRESH_CONNECT              = C.CURLOPT_FRESH_CONNECT
	OPT_FORBID_REUSE               = C.CURLOPT_FORBID_REUSE
	OPT_RANDOM_FILE                = C.CURLOPT_RANDOM_FILE
	OPT_EGDSOCKET                  = C.CURLOPT_EGDSOCKET
	OPT_CONNECTTIMEOUT             = C.CURLOPT_CONNECTTIMEOUT
	OPT_HEADERFUNCTION             = C.CURLOPT_HEADERFUNCTION
	OPT_HTTPGET                    = C.CURLOPT_HTTPGET
	OPT_SSL_VERIFYHOST             = C.CURLOPT_SSL_VERIFYHOST
	OPT_COOKIEJAR                  = C.CURLOPT_COOKIEJAR
	OPT_SSL_CIPHER_LIST            = C.CURLOPT_SSL_CIPHER_LIST
	OPT_HTTP_VERSION               = C.CURLOPT_HTTP_VERSION
	OPT_FTP_USE_EPSV               = C.CURLOPT_FTP_USE_EPSV
	OPT_SSLCERTTYPE                = C.CURLOPT_SSLCERTTYPE
	OPT_SSLKEY                     = C.CURLOPT_SSLKEY
	OPT_SSLKEYTYPE                 = C.CURLOPT_SSLKEYTYPE
	OPT_SSLENGINE                  = C.CURLOPT_SSLENGINE
	OPT_SSLENGINE_DEFAULT          = C.CURLOPT_SSLENGINE_DEFAULT
	OPT_DNS_USE_GLOBAL_CACHE       = C.CURLOPT_DNS_USE_GLOBAL_CACHE
	OPT_DNS_CACHE_TIMEOUT          = C.CURLOPT_DNS_CACHE_TIMEOUT
	OPT_PREQUOTE                   = C.CURLOPT_PREQUOTE
	OPT_DEBUGFUNCTION              = C.CURLOPT_DEBUGFUNCTION
	OPT_DEBUGDATA                  = C.CURLOPT_DEBUGDATA
	OPT_COOKIESESSION              = C.CURLOPT_COOKIESESSION
	OPT_CAPATH                     = C.CURLOPT_CAPATH
	OPT_BUFFERSIZE                 = C.CURLOPT_BUFFERSIZE
	OPT_NOSIGNAL                   = C.CURLOPT_NOSIGNAL
	OPT_SHARE                      = C.CURLOPT_SHARE
	OPT_PROXYTYPE                  = C.CURLOPT_PROXYTYPE
	OPT_ENCODING                   = C.CURLOPT_ENCODING
	OPT_PRIVATE                    = C.CURLOPT_PRIVATE
	OPT_HTTP200ALIASES             = C.CURLOPT_HTTP200ALIASES
	OPT_UNRESTRICTED_AUTH          = C.CURLOPT_UNRESTRICTED_AUTH
	OPT_FTP_USE_EPRT               = C.CURLOPT_FTP_USE_EPRT
	OPT_HTTPAUTH                   = C.CURLOPT_HTTPAUTH
	OPT_SSL_CTX_FUNCTION           = C.CURLOPT_SSL_CTX_FUNCTION
	OPT_SSL_CTX_DATA               = C.CURLOPT_SSL_CTX_DATA
	OPT_FTP_CREATE_MISSING_DIRS    = C.CURLOPT_FTP_CREATE_MISSING_DIRS
	OPT_PROXYAUTH                  = C.CURLOPT_PROXYAUTH
	OPT_IPRESOLVE                  = C.CURLOPT_IPRESOLVE
	OPT_MAXFILESIZE                = C.CURLOPT_MAXFILESIZE
	OPT_INFILESIZE_LARGE           = C.CURLOPT_INFILESIZE_LARGE
	OPT_RESUME_FROM_LARGE          = C.CURLOPT_RESUME_FROM_LARGE
	OPT_MAXFILESIZE_LARGE          = C.CURLOPT_MAXFILESIZE_LARGE
	OPT_NETRC_FILE                 = C.CURLOPT_NETRC_FILE
	OPT_FTP_SSL                    = C.CURLOPT_FTP_SSL
	OPT_POSTFIELDSIZE_LARGE        = C.CURLOPT_POSTFIELDSIZE_LARGE
	OPT_TCP_NODELAY                = C.CURLOPT_TCP_NODELAY
	OPT_FTPSSLAUTH                 = C.CURLOPT_FTPSSLAUTH
	OPT_IOCTLFUNCTION              = C.CURLOPT_IOCTLFUNCTION
	OPT_IOCTLDATA                  = C.CURLOPT_IOCTLDATA
	OPT_FTP_ACCOUNT                = C.CURLOPT_FTP_ACCOUNT
	OPT_COOKIELIST                 = C.CURLOPT_COOKIELIST
	OPT_IGNORE_CONTENT_LENGTH      = C.CURLOPT_IGNORE_CONTENT_LENGTH
	OPT_FTP_SKIP_PASV_IP           = C.CURLOPT_FTP_SKIP_PASV_IP
	OPT_FTP_FILEMETHOD             = C.CURLOPT_FTP_FILEMETHOD
	OPT_LOCALPORT                  = C.CURLOPT_LOCALPORT
	OPT_LOCALPORTRANGE             = C.CURLOPT_LOCALPORTRANGE
	OPT_CONNECT_ONLY               = C.CURLOPT_CONNECT_ONLY
	OPT_CONV_FROM_NETWORK_FUNCTION = C.CURLOPT_CONV_FROM_NETWORK_FUNCTION
	OPT_CONV_TO_NETWORK_FUNCTION   = C.CURLOPT_CONV_TO_NETWORK_FUNCTION
	OPT_CONV_FROM_UTF8_FUNCTION    = C.CURLOPT_CONV_FROM_UTF8_FUNCTION
	OPT_MAX_SEND_SPEED_LARGE       = C.CURLOPT_MAX_SEND_SPEED_LARGE
	OPT_MAX_RECV_SPEED_LARGE       = C.CURLOPT_MAX_RECV_SPEED_LARGE
	OPT_FTP_ALTERNATIVE_TO_USER    = C.CURLOPT_FTP_ALTERNATIVE_TO_USER
	OPT_SOCKOPTFUNCTION            = C.CURLOPT_SOCKOPTFUNCTION
	OPT_SOCKOPTDATA                = C.CURLOPT_SOCKOPTDATA
	OPT_SSL_SESSIONID_CACHE        = C.CURLOPT_SSL_SESSIONID_CACHE
	OPT_WRITEDATA                  = C.CURLOPT_WRITEDATA
	OPT_READDATA                   = C.CURLOPT_READDATA
	OPT_HEADERDATA                 = C.CURLOPT_HEADERDATA
)

easy.Setopt(flag, ...)

View Source
const (
	INFO_TEXT                    = C.CURLINFO_TEXT
	INFO_EFFECTIVE_URL           = C.CURLINFO_EFFECTIVE_URL
	INFO_RESPONSE_CODE           = C.CURLINFO_RESPONSE_CODE
	INFO_TOTAL_TIME              = C.CURLINFO_TOTAL_TIME
	INFO_NAMELOOKUP_TIME         = C.CURLINFO_NAMELOOKUP_TIME
	INFO_CONNECT_TIME            = C.CURLINFO_CONNECT_TIME
	INFO_PRETRANSFER_TIME        = C.CURLINFO_PRETRANSFER_TIME
	INFO_SIZE_UPLOAD             = C.CURLINFO_SIZE_UPLOAD
	INFO_SIZE_DOWNLOAD           = C.CURLINFO_SIZE_DOWNLOAD
	INFO_SPEED_DOWNLOAD          = C.CURLINFO_SPEED_DOWNLOAD
	INFO_SPEED_UPLOAD            = C.CURLINFO_SPEED_UPLOAD
	INFO_HEADER_SIZE             = C.CURLINFO_HEADER_SIZE
	INFO_REQUEST_SIZE            = C.CURLINFO_REQUEST_SIZE
	INFO_SSL_VERIFYRESULT        = C.CURLINFO_SSL_VERIFYRESULT
	INFO_FILETIME                = C.CURLINFO_FILETIME
	INFO_CONTENT_LENGTH_DOWNLOAD = C.CURLINFO_CONTENT_LENGTH_DOWNLOAD
	INFO_CONTENT_LENGTH_UPLOAD   = C.CURLINFO_CONTENT_LENGTH_UPLOAD
	INFO_STARTTRANSFER_TIME      = C.CURLINFO_STARTTRANSFER_TIME
	INFO_CONTENT_TYPE            = C.CURLINFO_CONTENT_TYPE
	INFO_REDIRECT_TIME           = C.CURLINFO_REDIRECT_TIME
	INFO_REDIRECT_COUNT          = C.CURLINFO_REDIRECT_COUNT
	INFO_PRIVATE                 = C.CURLINFO_PRIVATE
	INFO_HTTP_CONNECTCODE        = C.CURLINFO_HTTP_CONNECTCODE
	INFO_HTTPAUTH_AVAIL          = C.CURLINFO_HTTPAUTH_AVAIL
	INFO_PROXYAUTH_AVAIL         = C.CURLINFO_PROXYAUTH_AVAIL
	INFO_OS_ERRNO                = C.CURLINFO_OS_ERRNO
	INFO_NUM_CONNECTS            = C.CURLINFO_NUM_CONNECTS
	INFO_SSL_ENGINES             = C.CURLINFO_SSL_ENGINES
	INFO_COOKIELIST              = C.CURLINFO_COOKIELIST
	INFO_LASTSOCKET              = C.CURLINFO_LASTSOCKET
	INFO_FTP_ENTRY_PATH          = C.CURLINFO_FTP_ENTRY_PATH
	INFO_LASTONE                 = C.CURLINFO_LASTONE
	INFO_HTTP_CODE               = C.CURLINFO_HTTP_CODE
)

easy.Getinfo(flag)

View Source
const (
	AUTH_NONE         = C.CURLAUTH_NONE & (1<<32 - 1)
	AUTH_BASIC        = C.CURLAUTH_BASIC & (1<<32 - 1)
	AUTH_DIGEST       = C.CURLAUTH_DIGEST & (1<<32 - 1)
	AUTH_GSSNEGOTIATE = C.CURLAUTH_GSSNEGOTIATE & (1<<32 - 1)
	AUTH_NTLM         = C.CURLAUTH_NTLM & (1<<32 - 1)
	AUTH_ANY          = C.CURLAUTH_ANY & (1<<32 - 1)
	AUTH_ANYSAFE      = C.CURLAUTH_ANYSAFE & (1<<32 - 1)
)

Auth

View Source
const OPT_TLS13_CIPHERS = C.CURLOPT_TLS13_CIPHERS
View Source
const (
	SSLOPT_ALLOW_BEAST = 1
)

for easy.Setopt(OPT_SSL_OPTIONS, flag)

Variables

This section is empty.

Functions

func FreeCurlString

func FreeCurlString(s CurlString)

func Getdate

func Getdate(date string) *time.Time

curl_getdate - Convert a date string to number of seconds since January 1, 1970 In golang, we convert it to a *time.Time

func GlobalCleanup

func GlobalCleanup()

curl_global_cleanup - global libcurl cleanup

func GlobalInit

func GlobalInit(flags int) error

curl_global_init - Global libcurl initialisation

func SetLogLevel

func SetLogLevel(levelName string)

SetLogLevel changes the log level which determines the granularity of the messages that are logged. Available log levels are: "DEBUG", "INFO", "WARN", "ERROR" and "DEFAULT_LOG_LEVEL".

func Version

func Version() string

curl_version - returns the libcurl version string

Types

type CURL

type CURL struct {
	// contains filtered or unexported fields
}

curl_easy interface

func EasyInit

func EasyInit() *CURL

curl_easy_init - Start a libcurl easy session

func (*CURL) Cleanup

func (curl *CURL) Cleanup()

curl_easy_cleanup - End a libcurl easy session

func (*CURL) Duphandle

func (curl *CURL) Duphandle() *CURL

curl_easy_duphandle - Clone a libcurl session handle

func (*CURL) Escape

func (curl *CURL) Escape(url string) string

curl_easy_escape - URL encodes the given string

func (*CURL) GetHandle

func (curl *CURL) GetHandle() unsafe.Pointer

func (*CURL) Getinfo

func (curl *CURL) Getinfo(info CurlInfo) (ret interface{}, err error)

curl_easy_getinfo - extract information from a curl handle

func (*CURL) MallocFreeAfter

func (curl *CURL) MallocFreeAfter(from int)

func (*CURL) MallocGetPos

func (curl *CURL) MallocGetPos() int

func (*CURL) Pause

func (curl *CURL) Pause(bitmask int) error

curl_easy_pause - pause and unpause a connection

func (*CURL) Perform

func (curl *CURL) Perform() error

curl_easy_perform - Perform a file transfer

func (*CURL) Recv

func (curl *CURL) Recv(buffer []byte) (int, error)

curl_easy_recv - receives raw data on an "easy" connection

func (*CURL) Reset

func (curl *CURL) Reset()

curl_easy_reset - reset all options of a libcurl session handle

func (*CURL) Send

func (curl *CURL) Send(buffer []byte) (int, error)

curl_easy_send - sends raw data over an "easy" connection

func (*CURL) Setopt

func (curl *CURL) Setopt(opt int, param interface{}) error

curl_easy_setopt - set options for a curl easy handle WARNING: a function pointer is &fun, but function addr is reflect.ValueOf(fun).Pointer()

func (*CURL) Unescape

func (curl *CURL) Unescape(url string) string

curl_easy_unescape - URL decodes the given string

type CURLM

type CURLM struct {
	// contains filtered or unexported fields
}

func MultiInit

func MultiInit() *CURLM

curl_multi_init - create a multi handle

func (*CURLM) AddHandle

func (mcurl *CURLM) AddHandle(easy *CURL) error

curl_multi_add_handle - add an easy handle to a multi session

func (*CURLM) Cleanup

func (mcurl *CURLM) Cleanup() error

curl_multi_cleanup - close down a multi session

func (*CURLM) Fdset

func (mcurl *CURLM) Fdset(rset, wset, eset *syscall.FdSet) (int, error)

func (*CURLM) Info_read

func (mcurl *CURLM) Info_read() (*CURLMessage, int)

func (*CURLM) Perform

func (mcurl *CURLM) Perform() (int, error)

curl_multi_perform - reads/writes available data from each easy handle

func (*CURLM) RemoveHandle

func (mcurl *CURLM) RemoveHandle(easy *CURL) error

curl_multi_remove_handle - remove an easy handle from a multi session

func (*CURLM) Setopt

func (mcurl *CURLM) Setopt(opt int, param interface{}) error

func (*CURLM) Timeout

func (mcurl *CURLM) Timeout() (int, error)

type CURLMessage

type CURLMessage struct {
	Msg         CurlMultiMsg
	Easy_handle *CURL
	Data        [unsafe.Sizeof(dummy)]byte
}

type CURLSH

type CURLSH struct {
	// contains filtered or unexported fields
}

func ShareInit

func ShareInit() *CURLSH

func (*CURLSH) Cleanup

func (shcurl *CURLSH) Cleanup() error

func (*CURLSH) Setopt

func (shcurl *CURLSH) Setopt(opt int, param interface{}) error

type CurlError

type CurlError C.CURLcode

func (CurlError) Error

func (e CurlError) Error() string

type CurlInfo

type CurlInfo C.CURLINFO

type CurlMultiError

type CurlMultiError C.CURLMcode

func (CurlMultiError) Error

func (e CurlMultiError) Error() string

type CurlMultiMsg

type CurlMultiMsg C.CURLMSG

type CurlShareError

type CurlShareError C.CURLMcode

implement os.Error interface

func (CurlShareError) Error

func (e CurlShareError) Error() string

type CurlString

type CurlString *C.char

func NewCurlString

func NewCurlString(s string) CurlString

type Form

type Form struct {
	// contains filtered or unexported fields
}

A multipart/formdata HTTP POST form

func NewForm

func NewForm() *Form

func (*Form) Add

func (form *Form) Add(name string, content interface{}) error

func (*Form) AddFile

func (form *Form) AddFile(name, filename string) error

func (*Form) AddFromFile

func (form *Form) AddFromFile(name, filename string)

func (*Form) AddWithType

func (form *Form) AddWithType(name string, content interface{}, content_type string) error

type VersionInfoData

type VersionInfoData struct {
	Age C.CURLversion
	// age >= 0
	Version       string
	VersionNum    uint
	Host          string
	Features      int
	SslVersion    string
	SslVersionNum int
	LibzVersion   string
	Protocols     []string
	// age >= 1
	Ares    string
	AresNum int
	// age >= 2
	Libidn string
	// age >= 3
	IconvVerNum   int
	LibsshVersion string
}

func VersionInfo

func VersionInfo(ver C.CURLversion) *VersionInfoData

curl_version_info - returns run-time libcurl version info

Directories

Path Synopsis
A sample program to show how to use PROGRESS callback to calculate downloading percentage and speed
A sample program to show how to use PROGRESS callback to calculate downloading percentage and speed

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL