SUMMARY.md

Table of contents

• Introduction
• How to read
• The cURL project
  • How it started
  • The name
  • What does curl do?
  • Project communication
  • Mailing list etiquette
  • Mailing lists
  • Reporting bugs
  • Commercial support
  • Releases
  • Security
  • Trust
  • Code of Conduct
  • Development
  • The development team
  • Users of curl
  • Future
• Network and protocols
  • Networking simplified
  • Protocols
  • curl protocols
  • HTTP basics
• Install curl and libcurl
  • Linux
  • Windows
    • MSYS2
    • vcpkg
  • macOS
  • Container
• Source code
  • Open Source
    • License
    • Copyright
  • Code layout
  • Handling build options
  • Code style
  • Contributing
  • Reporting vulnerabilities
  • Website
• Build curl and libcurl
  • Autotools
  • CMake
  • Separate install
  • Windows
  • Dependencies
  • TLS libraries
    • BoringSSL
• Command line concepts
  • Differences
  • Command line options
  • Options depend on version
  • URLs
    • Scheme
    • Name and password
    • Host
    • Port number
    • Path
    • Query
    • FTP type
    • Fragment
    • Browsers
    • Many options and URLs
    • Connection reuse
    • Parallel transfers
    • trurl
  • URL globbing
  • List options
  • Config file
  • Variables
  • Passwords
  • Progress meter
  • Version
  • Persistent connections
  • Exit code
  • Copy as curl
• Command line transfers
  • Verbose
    • Trace options
    • Write out
  • Downloads
    • What exactly is downloading?
    • Storing downloads
    • Download to a file named by the URL
    • Use the target filename from the server
    • HTML and charsets
    • Compression
    • Shell redirects
    • Multiple downloads
    • My browser shows something else
    • Maximum filesize
    • Storing metadata in file system
    • Raw
    • Retry
    • Resuming and ranges
  • Uploads
  • Transfer controls
    • Stop slow transfers
    • Rate limiting
    • Request rate limiting
  • Connections
    • Name resolve tricks
    • Connection timeout
    • Network interface
    • Local port number
    • Keep alive
  • Timeouts
  • .netrc
  • Proxies
    • Discover your proxy
    • PAC
    • Captive portals
    • Proxy type
    • HTTP proxy
    • SOCKS proxy
    • MITM proxy
    • Proxy authentication
    • HTTPS proxy
    • Proxy environment variables
    • Proxy headers
    • haproxy
  • TLS
    • Ciphers
    • Enable TLS
    • TLS versions
    • Verifying server certificates
    • Certificate pinning
    • OCSP stapling
    • Client certificates
    • TLS auth
    • TLS backends
    • SSLKEYLOGFILE
  • SCP and SFTP
  • Reading email
  • Sending email
  • DICT
  • IPFS
  • MQTT
  • TELNET
  • TFTP
• Command line HTTP
  • Method
  • Responses
  • Authentication
  • Ranges
  • HTTP versions
    • HTTP/0.9
    • HTTP/2
    • HTTP/3
  • Conditionals
  • HTTPS
  • HTTP POST
    • Simple POST
    • Content-Type
    • Posting binary
    • JSON
    • URL encode data
    • Convert to GET
    • Expect 100-continue
    • Chunked encoded POSTs
    • Hidden form fields
    • Figure out what a browser sends
    • JavaScript and forms
    • Multipart formposts
    • -d vs -F
  • Redirects
  • Modify the HTTP request
    • Request method
    • Request target
    • Fragment
    • Customize headers
    • Referer
    • User-agent
  • HTTP PUT
  • Cookies
    • Cookie file format
  • Alternative Services
  • HSTS
  • Scripting browser-like tasks
• Command line FTP
  • FTP Directory listing
  • Uploading with FTP
  • Custom FTP commands
  • Two connections
  • Directory traversing
  • FTPS
• libcurl
  • Header files
  • Global initialization
  • API compatibility
  • --libcurl
  • multi-threading
  • CURLcode return codes
  • Verbose operations
  • Caches
  • Performance
  • for C++ programmers
• libcurl transfers
  • Easy handle
  • curl easy options
    • Set numerical options
    • Set string options
    • TLS options
    • All options
    • Get option information
  • Drive transfers
    • Drive with easy
    • Drive with multi
    • Drive with multi_socket
  • Callbacks
    • Write data
    • Read data
    • Progress information
    • Header data
    • Debug
    • sockopt
    • SSL context
    • Seek and ioctl
    • Network data conversion
    • Opensocket and closesocket
    • SSH key
    • RTSP interleaved data
    • FTP wildcard matching
    • Resolver start
    • Sending trailers
    • HSTS
    • Prereq
  • Connection control
    • How libcurl connects
    • Local address and port number
    • Connection reuse
    • Name resolving
    • Proxies
  • Transfer control
    • Stop
    • Stop slow transfers
    • Rate limit
    • Progress meter
    • Progress callback
  • Cleanup
  • Post transfer info
• libcurl HTTP
  • Responses
  • Requests
  • Versions
  • Ranges
  • Authentication
  • Cookies
  • Download
  • Upload
  • Multiplexing
  • HSTS
  • alt-svc
• libcurl helpers
  • Share data between handles
  • URL API
    • Include files
    • Create, cleanup, duplicate
    • Parse a URL
    • Redirect to URL
    • Get a URL
    • Get URL parts
    • Set URL parts
    • Append to the query
    • CURLOPT_CURLU
  • WebSocket
    • Support
    • URLs
    • Concept
    • Options
    • Read
    • Meta
    • Write
  • Headers API
    • Header struct
    • Get a header
    • Iterate over headers
• libcurl examples
  • Get a simple HTTP page
  • Get a response into memory
  • Submit a login form over HTTP
  • Get an FTP directory listing
  • Non-blocking HTTP form-post
• libcurl bindings
• libcurl internals
  • Easy handles and connections
  • Everything is multi
  • State machines
  • Protocol handler
  • Backends
  • Caches and state
  • Timeouts
  • Windows vs Unix
  • Memory debugging
  • Content Encoding
  • Structs
  • Resolving hostnames
  • Tests
    • Test file format
    • Build tests
    • Run tests
    • Debug builds
    • Test servers
    • curl tests
    • libcurl tests
    • Unit tests
    • Valgrind
    • Continuous Integration
    • Autobuilds
    • Torture
• Index