CINXE.COM

<!DOCTYPE HTML> <html lang="en" class="light" dir="ltr"> <head>  <meta charset="UTF-8"> <title>Exit code - everything curl</title>  <meta name="description" content="everything there is to know about curl, libcurl and the cURL project"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="theme-color" content="#ffffff"> <link rel="icon" href="../favicon.svg"> <link rel="shortcut icon" href="../favicon.png"> <link rel="stylesheet" href="../css/variables.css"> <link rel="stylesheet" href="../css/general.css"> <link rel="stylesheet" href="../css/chrome.css"> <link rel="stylesheet" href="../css/print.css" media="print">  <link rel="stylesheet" href="../FontAwesome/css/font-awesome.css"> <link rel="stylesheet" href="../fonts/fonts.css">  <link rel="stylesheet" href="../highlight.css"> <link rel="stylesheet" href="../tomorrow-night.css"> <link rel="stylesheet" href="../ayu-highlight.css">  </head> <body class="sidebar-visible no-js"> <div id="body-container">  <script> var path_to_root = "../"; var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light"; </script>  <script> try { var theme = localStorage.getItem('mdbook-theme'); var sidebar = localStorage.getItem('mdbook-sidebar'); if (theme.startsWith('"') && theme.endsWith('"')) { localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1)); } if (sidebar.startsWith('"') && sidebar.endsWith('"')) { localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1)); } } catch (e) { } </script>  <script> var theme; try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } if (theme === null || theme === undefined) { theme = default_theme; } var html = document.querySelector('html'); html.classList.remove('light') html.classList.add(theme); var body = document.querySelector('body'); body.classList.remove('no-js') body.classList.add('js'); </script> <input type="checkbox" id="sidebar-toggle-anchor" class="hidden">  <script> var body = document.querySelector('body'); var sidebar = null; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor"); if (document.body.clientWidth >= 1080) { try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } sidebar = sidebar || 'visible'; } else { sidebar = 'hidden'; } sidebar_toggle.checked = sidebar === 'visible'; body.classList.remove('sidebar-visible'); body.classList.add("sidebar-" + sidebar); </script> <nav id="sidebar" class="sidebar" aria-label="Table of contents"> <div class="sidebar-scrollbox"> <ol class="chapter"><li class="chapter-item "><a href="../index.html">1. Everything curl</a></li><li class="chapter-item "><a href="../how-to-read.html">2. How to read</a></li><li class="chapter-item "><a href="../project/index.html">3. The cURL project</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../project/started.html">3.1. How it started</a></li><li class="chapter-item "><a href="../project/name.html">3.2. The name</a></li><li class="chapter-item "><a href="../project/does.html">3.3. What does curl do?</a></li><li class="chapter-item "><a href="../project/comm.html">3.4. Project communication</a></li><li class="chapter-item "><a href="../project/etiquette.html">3.5. Mailing list etiquette</a></li><li class="chapter-item "><a href="../project/maillists.html">3.6. Mailing lists</a></li><li class="chapter-item "><a href="../project/bugs.html">3.7. Reporting bugs</a></li><li class="chapter-item "><a href="../project/support.html">3.8. Commercial support</a></li><li class="chapter-item "><a href="../project/releases.html">3.9. Releases</a></li><li class="chapter-item "><a href="../project/security.html">3.10. Security</a></li><li class="chapter-item "><a href="../project/trust.html">3.11. Trust</a></li><li class="chapter-item "><a href="../project/coc.html">3.12. Code of Conduct</a></li><li class="chapter-item "><a href="../project/devel.html">3.13. Development</a></li><li class="chapter-item "><a href="../project/devteam.html">3.14. The development team</a></li><li class="chapter-item "><a href="../project/users.html">3.15. Users of curl</a></li><li class="chapter-item "><a href="../project/future.html">3.16. Future</a></li></ol></li><li class="chapter-item "><a href="../protocols/index.html">4. Network and protocols</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../protocols/network.html">4.1. Networking simplified</a></li><li class="chapter-item "><a href="../protocols/protocols.html">4.2. Protocols</a></li><li class="chapter-item "><a href="../protocols/curl.html">4.3. curl protocols</a></li><li class="chapter-item "><a href="../protocols/http.html">4.4. HTTP basics</a></li></ol></li><li class="chapter-item "><a href="../install/index.html">5. Install curl and libcurl</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../install/linux.html">5.1. Linux</a></li><li class="chapter-item "><a href="../install/windows/index.html">5.2. Windows</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../install/windows/win-msys2.html">5.2.1. MSYS2</a></li><li class="chapter-item "><a href="../install/windows/win-vcpkg.html">5.2.2. vcpkg</a></li></ol></li><li class="chapter-item "><a href="../install/macos.html">5.3. macOS</a></li><li class="chapter-item "><a href="../install/container.html">5.4. Container</a></li></ol></li><li class="chapter-item "><a href="../source/index.html">6. Source code</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../source/opensource/index.html">6.1. Open Source</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../source/opensource/license.html">6.1.1. License</a></li><li class="chapter-item "><a href="../source/opensource/copyright.html">6.1.2. Copyright</a></li></ol></li><li class="chapter-item "><a href="../source/layout.html">6.2. Code layout</a></li><li class="chapter-item "><a href="../source/options.html">6.3. Handling build options</a></li><li class="chapter-item "><a href="../source/style.html">6.4. Code style</a></li><li class="chapter-item "><a href="../source/contributing.html">6.5. Contributing</a></li><li class="chapter-item "><a href="../source/reportvuln.html">6.6. Reporting vulnerabilities</a></li><li class="chapter-item "><a href="../source/web.html">6.7. Website</a></li></ol></li><li class="chapter-item "><a href="../build/index.html">7. Build curl and libcurl</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../build/autotools.html">7.1. Autotools</a></li><li class="chapter-item "><a href="../build/cmake.html">7.2. CMake</a></li><li class="chapter-item "><a href="../build/separate.html">7.3. Separate install</a></li><li class="chapter-item "><a href="../build/windows.html">7.4. Windows</a></li><li class="chapter-item "><a href="../build/deps.html">7.5. Dependencies</a></li><li class="chapter-item "><a href="../build/tls.html">7.6. TLS libraries</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../build/boringssl.html">7.6.1. BoringSSL</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../cmdline/index.html">8. Command line concepts</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../cmdline/differences.html">8.1. Differences</a></li><li class="chapter-item "><a href="../cmdline/options/index.html">8.2. Command line options</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../cmdline/options/short.html">8.2.1. Short options</a></li><li class="chapter-item "><a href="../cmdline/options/long.html">8.2.2. Long options</a></li><li class="chapter-item "><a href="../cmdline/options/args.html">8.2.3. Arguments to options</a></li><li class="chapter-item "><a href="../cmdline/options/negative.html">8.2.4. Negative options</a></li></ol></li><li class="chapter-item "><a href="../cmdline/help.html">8.3. Help</a></li><li class="chapter-item "><a href="../cmdline/versions.html">8.4. Options depend on version</a></li><li class="chapter-item "><a href="../cmdline/urls/index.html">8.5. URLs</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../cmdline/urls/scheme.html">8.5.1. Scheme</a></li><li class="chapter-item "><a href="../cmdline/urls/auth.html">8.5.2. Name and password</a></li><li class="chapter-item "><a href="../cmdline/urls/host.html">8.5.3. Host</a></li><li class="chapter-item "><a href="../cmdline/urls/port.html">8.5.4. Port number</a></li><li class="chapter-item "><a href="../cmdline/urls/path.html">8.5.5. Path</a></li><li class="chapter-item "><a href="../cmdline/urls/query.html">8.5.6. Query</a></li><li class="chapter-item "><a href="../cmdline/urls/ftptype.html">8.5.7. FTP type</a></li><li class="chapter-item "><a href="../cmdline/urls/fragment.html">8.5.8. Fragment</a></li><li class="chapter-item "><a href="../cmdline/urls/browsers.html">8.5.9. Browsers</a></li><li class="chapter-item "><a href="../cmdline/urls/options.html">8.5.10. Many options and URLs</a></li><li class="chapter-item "><a href="../cmdline/urls/globbing.html">8.5.11. URL globbing</a></li><li class="chapter-item "><a href="../cmdline/urls/connreuse.html">8.5.12. Connection reuse</a></li><li class="chapter-item "><a href="../cmdline/urls/parallel.html">8.5.13. Parallel transfers</a></li><li class="chapter-item "><a href="../cmdline/urls/trurl.html">8.5.14. trurl</a></li></ol></li><li class="chapter-item "><a href="../cmdline/configfile.html">8.6. Config file</a></li><li class="chapter-item "><a href="../cmdline/variables.html">8.7. Variables</a></li><li class="chapter-item "><a href="../cmdline/passwords.html">8.8. Passwords</a></li><li class="chapter-item "><a href="../cmdline/progressmeter.html">8.9. Progress meter</a></li><li class="chapter-item "><a href="../cmdline/curlver.html">8.10. Version</a></li><li class="chapter-item expanded "><a href="../cmdline/exitcode.html" class="active">8.11. Exit code</a></li><li class="chapter-item "><a href="../cmdline/copyas.html">8.12. Copy as curl</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/index.html">9. Command line transfers</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/verbose/index.html">9.1. Verbose</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/verbose/trace.html">9.1.1. Trace options</a></li><li class="chapter-item "><a href="../usingcurl/verbose/writeout.html">9.1.2. Write out</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/downloads/index.html">9.2. Downloads</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/downloads/whatis.html">9.2.1. What is downloading?</a></li><li class="chapter-item "><a href="../usingcurl/downloads/storing.html">9.2.2. Storing downloads</a></li><li class="chapter-item "><a href="../usingcurl/downloads/url-named.html">9.2.3. Download to a file named by the URL</a></li><li class="chapter-item "><a href="../usingcurl/downloads/content-disp.html">9.2.4. Use the target filename from the server</a></li><li class="chapter-item "><a href="../usingcurl/downloads/charsets.html">9.2.5. HTML and charsets</a></li><li class="chapter-item "><a href="../usingcurl/downloads/redirects.html">9.2.6. Shell redirects</a></li><li class="chapter-item "><a href="../usingcurl/downloads/multiple.html">9.2.7. Multiple downloads</a></li><li class="chapter-item "><a href="../usingcurl/downloads/browsers.html">9.2.8. My browser shows something else</a></li><li class="chapter-item "><a href="../usingcurl/downloads/max-filesize.html">9.2.9. Maximum filesize</a></li><li class="chapter-item "><a href="../usingcurl/downloads/metadata-fs.html">9.2.10. Storing metadata in file system</a></li><li class="chapter-item "><a href="../usingcurl/downloads/raw.html">9.2.11. Raw</a></li><li class="chapter-item "><a href="../usingcurl/downloads/retry.html">9.2.12. Retry</a></li><li class="chapter-item "><a href="../usingcurl/downloads/resume.html">9.2.13. Resuming and ranges</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/uploads.html">9.3. Uploads</a></li><li class="chapter-item "><a href="../usingcurl/transfers/index.html">9.4. Transfer controls</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/transfers/tooslow.html">9.4.1. Stop slow transfers</a></li><li class="chapter-item "><a href="../usingcurl/transfers/rate-limiting.html">9.4.2. Rate limiting</a></li><li class="chapter-item "><a href="../usingcurl/transfers/request-rate.html">9.4.3. Request rate limiting</a></li><li class="chapter-item "><a href="../usingcurl/transfers/compression.html">9.4.4. Compression</a></li><li class="chapter-item "><a href="../usingcurl/transfers/skip.html">9.4.5. Skip download if already done</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/connections/index.html">9.5. Connections</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/connections/setup.html">9.5.1. Setup</a></li><li class="chapter-item "><a href="../usingcurl/connections/name.html">9.5.2. Name resolve tricks</a></li><li class="chapter-item "><a href="../usingcurl/connections/timeout.html">9.5.3. Connection timeout</a></li><li class="chapter-item "><a href="../usingcurl/connections/happy.html">9.5.4. Happy Eyeballs</a></li><li class="chapter-item "><a href="../usingcurl/connections/interface.html">9.5.5. Network interface</a></li><li class="chapter-item "><a href="../usingcurl/connections/local-port.html">9.5.6. Local port number</a></li><li class="chapter-item "><a href="../usingcurl/connections/keepalive.html">9.5.7. Keep alive</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/timeouts.html">9.6. Timeouts</a></li><li class="chapter-item "><a href="../usingcurl/netrc.html">9.7. .netrc</a></li><li class="chapter-item "><a href="../usingcurl/proxies/index.html">9.8. Proxies</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/proxies/discover.html">9.8.1. Discover your proxy</a></li><li class="chapter-item "><a href="../usingcurl/proxies/pac.html">9.8.2. PAC</a></li><li class="chapter-item "><a href="../usingcurl/proxies/captive.html">9.8.3. Captive portals</a></li><li class="chapter-item "><a href="../usingcurl/proxies/type.html">9.8.4. Proxy type</a></li><li class="chapter-item "><a href="../usingcurl/proxies/http.html">9.8.5. HTTP proxy</a></li><li class="chapter-item "><a href="../usingcurl/proxies/socks.html">9.8.6. SOCKS proxy</a></li><li class="chapter-item "><a href="../usingcurl/proxies/mitm.html">9.8.7. MITM proxy</a></li><li class="chapter-item "><a href="../usingcurl/proxies/auth.html">9.8.8. Proxy authentication</a></li><li class="chapter-item "><a href="../usingcurl/proxies/https.html">9.8.9. HTTPS proxy</a></li><li class="chapter-item "><a href="../usingcurl/proxies/env.html">9.8.10. Proxy environment variables</a></li><li class="chapter-item "><a href="../usingcurl/proxies/headers.html">9.8.11. Proxy headers</a></li><li class="chapter-item "><a href="../usingcurl/proxies/haproxy.html">9.8.12. haproxy</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/tls.html">9.9. TLS</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/tls/ciphers.html">9.9.1. Ciphers</a></li><li class="chapter-item "><a href="../usingcurl/tls/enable.html">9.9.2. Enable TLS</a></li><li class="chapter-item "><a href="../usingcurl/tls/versions.html">9.9.3. TLS versions</a></li><li class="chapter-item "><a href="../usingcurl/tls/verify.html">9.9.4. Verifying server certificates</a></li><li class="chapter-item "><a href="../usingcurl/tls/pinning.html">9.9.5. Certificate pinning</a></li><li class="chapter-item "><a href="../usingcurl/tls/stapling.html">9.9.6. OCSP stapling</a></li><li class="chapter-item "><a href="../usingcurl/tls/clientcert.html">9.9.7. Client certificates</a></li><li class="chapter-item "><a href="../usingcurl/tls/auth.html">9.9.8. TLS auth</a></li><li class="chapter-item "><a href="../usingcurl/tls/backends.html">9.9.9. TLS backends</a></li><li class="chapter-item "><a href="../usingcurl/tls/sslkeylogfile.html">9.9.10. SSLKEYLOGFILE</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/ssh/index.html">9.10. SCP and SFTP</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../usingcurl/ssh/url.html">9.10.1. URLs</a></li><li class="chapter-item "><a href="../usingcurl/ssh/auth.html">9.10.2. Authentication</a></li><li class="chapter-item "><a href="../usingcurl/ssh/knownhosts.html">9.10.3. Known hosts</a></li></ol></li><li class="chapter-item "><a href="../usingcurl/reademail.html">9.11. Reading email</a></li><li class="chapter-item "><a href="../usingcurl/smtp.html">9.12. Sending email</a></li><li class="chapter-item "><a href="../usingcurl/dict.html">9.13. DICT</a></li><li class="chapter-item "><a href="../usingcurl/ipfs.html">9.14. IPFS</a></li><li class="chapter-item "><a href="../usingcurl/mqtt.html">9.15. MQTT</a></li><li class="chapter-item "><a href="../usingcurl/telnet.html">9.16. TELNET</a></li><li class="chapter-item "><a href="../usingcurl/tftp.html">9.17. TFTP</a></li></ol></li><li class="chapter-item "><a href="../http/index.html">10. Command line HTTP</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/method.html">10.1. Method</a></li><li class="chapter-item "><a href="../http/response.html">10.2. Responses</a></li><li class="chapter-item "><a href="../http/auth.html">10.3. Authentication</a></li><li class="chapter-item "><a href="../http/versions/index.html">10.4. HTTP versions</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/versions/http09.html">10.4.1. HTTP/0.9</a></li><li class="chapter-item "><a href="../http/versions/http2.html">10.4.2. HTTP/2</a></li><li class="chapter-item "><a href="../http/versions/http3.html">10.4.3. HTTP/3</a></li></ol></li><li class="chapter-item "><a href="../http/post/index.html">10.5. HTTP POST</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/post/simple.html">10.5.1. Simple POST</a></li><li class="chapter-item "><a href="../http/post/content-type.html">10.5.2. Content-Type</a></li><li class="chapter-item "><a href="../http/post/binary.html">10.5.3. Posting binary</a></li><li class="chapter-item "><a href="../http/post/json.html">10.5.4. JSON</a></li><li class="chapter-item "><a href="../http/post/url-encode.html">10.5.5. URL encode data</a></li><li class="chapter-item "><a href="../http/post/convert-to-get.html">10.5.6. Convert to GET</a></li><li class="chapter-item "><a href="../http/post/expect100.html">10.5.7. Expect 100-continue</a></li><li class="chapter-item "><a href="../http/post/chunked.html">10.5.8. Chunked encoded POSTs</a></li><li class="chapter-item "><a href="../http/post/hiddenfields.html">10.5.9. Hidden form fields</a></li><li class="chapter-item "><a href="../http/post/browsersends.html">10.5.10. Figure out what a browser sends</a></li><li class="chapter-item "><a href="../http/post/javascript.html">10.5.11. JavaScript and forms</a></li><li class="chapter-item "><a href="../http/post/multipart.html">10.5.12. Multipart formposts</a></li><li class="chapter-item "><a href="../http/post/postvspost.html">10.5.13. -d vs -F</a></li></ol></li><li class="chapter-item "><a href="../http/put.html">10.6. HTTP PUT</a></li><li class="chapter-item "><a href="../http/redirects.html">10.7. Redirects</a></li><li class="chapter-item "><a href="../http/modify/index.html">10.8. Customize your HTTP</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/modify/method.html">10.8.1. Request method</a></li><li class="chapter-item "><a href="../http/modify/target.html">10.8.2. Request target</a></li><li class="chapter-item "><a href="../http/modify/fragment.html">10.8.3. Fragment</a></li><li class="chapter-item "><a href="../http/modify/headers.html">10.8.4. Customize headers</a></li><li class="chapter-item "><a href="../http/modify/referer.html">10.8.5. Referer</a></li><li class="chapter-item "><a href="../http/modify/user-agent.html">10.8.6. User-agent</a></li><li class="chapter-item "><a href="../http/modify/ranges.html">10.8.7. Ranges</a></li><li class="chapter-item "><a href="../http/modify/conditionals.html">10.8.8. Conditionals</a></li><li class="chapter-item "><a href="../http/modify/compression.html">10.8.9. Compression</a></li></ol></li><li class="chapter-item "><a href="../http/cookies/index.html">10.9. Cookies</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/cookies/engine.html">10.9.1. Cookie engine</a></li><li class="chapter-item "><a href="../http/cookies/reading.html">10.9.2. Reading cookies from file</a></li><li class="chapter-item "><a href="../http/cookies/writing.html">10.9.3. Writing cookies to file</a></li><li class="chapter-item "><a href="../http/cookies/newsession.html">10.9.4. New cookie session</a></li><li class="chapter-item "><a href="../http/cookies/fileformat.html">10.9.5. Cookie file format</a></li></ol></li><li class="chapter-item "><a href="../http/https.html">10.10. HTTPS</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../http/https/hsts.html">10.10.1. HSTS</a></li><li class="chapter-item "><a href="../http/https/altsvc.html">10.10.2. Alternative Services</a></li></ol></li><li class="chapter-item "><a href="../http/browserlike.html">10.11. Scripting browser-like tasks</a></li></ol></li><li class="chapter-item "><a href="../ftp/index.html">11. Command line FTP</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../ftp/dirlist.html">11.1. FTP Directory listing</a></li><li class="chapter-item "><a href="../ftp/upload.html">11.2. Uploading with FTP</a></li><li class="chapter-item "><a href="../ftp/cmds.html">11.3. Custom FTP commands</a></li><li class="chapter-item "><a href="../ftp/twoconnections.html">11.4. Two connections</a></li><li class="chapter-item "><a href="../ftp/traversedir.html">11.5. Directory traversing</a></li><li class="chapter-item "><a href="../ftp/ftps.html">11.6. FTPS</a></li></ol></li><li class="chapter-item "><a href="../libcurl/index.html">12. libcurl</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../libcurl/headers.html">12.1. Header files</a></li><li class="chapter-item "><a href="../libcurl/globalinit.html">12.2. Global initialization</a></li><li class="chapter-item "><a href="../libcurl/api.html">12.3. API compatibility</a></li><li class="chapter-item "><a href="../libcurl/--libcurl.html">12.4. --libcurl</a></li><li class="chapter-item "><a href="../libcurl/threading.html">12.5. multi-threading</a></li><li class="chapter-item "><a href="../libcurl/curlcode.html">12.6. CURLcode return codes</a></li><li class="chapter-item "><a href="../libcurl/verbose.html">12.7. Verbose operations</a></li><li class="chapter-item "><a href="../libcurl/caches.html">12.8. Caches</a></li><li class="chapter-item "><a href="../libcurl/performance.html">12.9. Performance</a></li><li class="chapter-item "><a href="../libcurl/cplusplus.html">12.10. for C++ programmers</a></li></ol></li><li class="chapter-item "><a href="../transfers/index.html">13. libcurl transfers</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/easyhandle.html">13.1. Easy handle</a></li><li class="chapter-item "><a href="../transfers/options/index.html">13.2. curl easy options</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/options/num.html">13.2.1. Set numerical options</a></li><li class="chapter-item "><a href="../transfers/options/strings.html">13.2.2. Set string options</a></li><li class="chapter-item "><a href="../transfers/options/tls.html">13.2.3. TLS options</a></li><li class="chapter-item "><a href="../transfers/options/all.html">13.2.4. All options</a></li><li class="chapter-item "><a href="../transfers/options/info.html">13.2.5. Get option information</a></li></ol></li><li class="chapter-item "><a href="../transfers/drive/index.html">13.3. Drive transfers</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/drive/easy.html">13.3.1. Drive with easy</a></li><li class="chapter-item "><a href="../transfers/drive/multi.html">13.3.2. Drive with multi</a></li><li class="chapter-item "><a href="../transfers/drive/multi-socket.html">13.3.3. Drive with multi_socket</a></li></ol></li><li class="chapter-item "><a href="../transfers/callbacks/index.html">13.4. Callbacks</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/callbacks/write.html">13.4.1. Write data</a></li><li class="chapter-item "><a href="../transfers/callbacks/read.html">13.4.2. Read data</a></li><li class="chapter-item "><a href="../transfers/callbacks/progress.html">13.4.3. Progress information</a></li><li class="chapter-item "><a href="../transfers/callbacks/header.html">13.4.4. Header data</a></li><li class="chapter-item "><a href="../transfers/callbacks/debug.html">13.4.5. Debug</a></li><li class="chapter-item "><a href="../transfers/callbacks/sockopt.html">13.4.6. sockopt</a></li><li class="chapter-item "><a href="../transfers/callbacks/sslcontext.html">13.4.7. SSL context</a></li><li class="chapter-item "><a href="../transfers/callbacks/seek.html">13.4.8. Seek and ioctl</a></li><li class="chapter-item "><a href="../transfers/callbacks/conversions.html">13.4.9. Network data conversion</a></li><li class="chapter-item "><a href="../transfers/callbacks/openclosesocket.html">13.4.10. Opensocket and closesocket</a></li><li class="chapter-item "><a href="../transfers/callbacks/sshkey.html">13.4.11. SSH key</a></li><li class="chapter-item "><a href="../transfers/callbacks/rtsp.html">13.4.12. RTSP interleaved data</a></li><li class="chapter-item "><a href="../transfers/callbacks/ftpmatch.html">13.4.13. FTP wildcard matching</a></li><li class="chapter-item "><a href="../transfers/callbacks/resolver.html">13.4.14. Resolver start</a></li><li class="chapter-item "><a href="../transfers/callbacks/trailers.html">13.4.15. Sending trailers</a></li><li class="chapter-item "><a href="../transfers/callbacks/hsts.html">13.4.16. HSTS</a></li><li class="chapter-item "><a href="../transfers/callbacks/prereq.html">13.4.17. Prereq</a></li></ol></li><li class="chapter-item "><a href="../transfers/conn/index.html">13.5. Connection control</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/conn/how.html">13.5.1. How libcurl connects</a></li><li class="chapter-item "><a href="../transfers/conn/local.html">13.5.2. Local address and port number</a></li><li class="chapter-item "><a href="../transfers/conn/reuse.html">13.5.3. Connection reuse</a></li><li class="chapter-item "><a href="../transfers/conn/keepalive.html">13.5.4. Keep alive</a></li><li class="chapter-item "><a href="../transfers/conn/names.html">13.5.5. Name resolving</a></li><li class="chapter-item "><a href="../transfers/conn/proxies.html">13.5.6. Proxies</a></li></ol></li><li class="chapter-item "><a href="../transfers/control/index.html">13.6. Transfer control</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../transfers/control/stop.html">13.6.1. Stop</a></li><li class="chapter-item "><a href="../transfers/control/stopslow.html">13.6.2. Stop slow transfers</a></li><li class="chapter-item "><a href="../transfers/control/ratelimit.html">13.6.3. Rate limit</a></li><li class="chapter-item "><a href="../transfers/control/meter.html">13.6.4. Progress meter</a></li><li class="chapter-item "><a href="../transfers/control/progress-callback.html">13.6.5. Progress callback</a></li></ol></li><li class="chapter-item "><a href="../transfers/auth.html">13.7. Authentication</a></li><li class="chapter-item "><a href="../transfers/cleanup.html">13.8. Cleanup</a></li><li class="chapter-item "><a href="../transfers/getinfo.html">13.9. Post transfer info</a></li></ol></li><li class="chapter-item "><a href="../libcurl-http/index.html">14. libcurl HTTP</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../libcurl-http/responses.html">14.1. Responses</a></li><li class="chapter-item "><a href="../libcurl-http/requests.html">14.2. Requests</a></li><li class="chapter-item "><a href="../libcurl-http/versions.html">14.3. Versions</a></li><li class="chapter-item "><a href="../libcurl-http/ranges.html">14.4. Ranges</a></li><li class="chapter-item "><a href="../libcurl-http/auth.html">14.5. Authentication</a></li><li class="chapter-item "><a href="../libcurl-http/cookies.html">14.6. Cookies</a></li><li class="chapter-item "><a href="../libcurl-http/download.html">14.7. Download</a></li><li class="chapter-item "><a href="../libcurl-http/upload.html">14.8. Upload</a></li><li class="chapter-item "><a href="../libcurl-http/multiplexing.html">14.9. Multiplexing</a></li><li class="chapter-item "><a href="../libcurl-http/hsts.html">14.10. HSTS</a></li><li class="chapter-item "><a href="../libcurl-http/alt-svc.html">14.11. alt-svc</a></li></ol></li><li class="chapter-item "><a href="../helpers/index.html">15. libcurl helpers</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../helpers/sharing.html">15.1. Share data between handles</a></li><li class="chapter-item "><a href="../helpers/url/index.html">15.2. URL API</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../helpers/url/include.html">15.2.1. Include files</a></li><li class="chapter-item "><a href="../helpers/url/init.html">15.2.2. Create, cleanup, duplicate</a></li><li class="chapter-item "><a href="../helpers/url/parse.html">15.2.3. Parse a URL</a></li><li class="chapter-item "><a href="../helpers/url/redirect.html">15.2.4. Redirect to URL</a></li><li class="chapter-item "><a href="../helpers/url/get.html">15.2.5. Get a URL</a></li><li class="chapter-item "><a href="../helpers/url/get-part.html">15.2.6. Get URL parts</a></li><li class="chapter-item "><a href="../helpers/url/set-part.html">15.2.7. Set URL parts</a></li><li class="chapter-item "><a href="../helpers/url/append-query.html">15.2.8. Append to the query</a></li><li class="chapter-item "><a href="../helpers/url/setopt.html">15.2.9. CURLOPT_CURLU</a></li></ol></li><li class="chapter-item "><a href="../helpers/ws/index.html">15.3. WebSocket</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../helpers/ws/support.html">15.3.1. Support</a></li><li class="chapter-item "><a href="../helpers/ws/urls.html">15.3.2. URLs</a></li><li class="chapter-item "><a href="../helpers/ws/concept.html">15.3.3. Concept</a></li><li class="chapter-item "><a href="../helpers/ws/options.html">15.3.4. Options</a></li><li class="chapter-item "><a href="../helpers/ws/read.html">15.3.5. Read</a></li><li class="chapter-item "><a href="../helpers/ws/meta.html">15.3.6. Meta</a></li><li class="chapter-item "><a href="../helpers/ws/write.html">15.3.7. Write</a></li></ol></li><li class="chapter-item "><a href="../helpers/headerapi/index.html">15.4. Headers API</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../helpers/headerapi/struct.html">15.4.1. Header struct</a></li><li class="chapter-item "><a href="../helpers/headerapi/get.html">15.4.2. Get a header</a></li><li class="chapter-item "><a href="../helpers/headerapi/iterate.html">15.4.3. Iterate over headers</a></li></ol></li></ol></li><li class="chapter-item "><a href="../examples/index.html">16. libcurl examples</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../examples/get.html">16.1. Get a simple HTTP page</a></li><li class="chapter-item "><a href="../examples/getinmem.html">16.2. Get a response into memory</a></li><li class="chapter-item "><a href="../examples/login.html">16.3. Submit a login form over HTTP</a></li><li class="chapter-item "><a href="../examples/ftplist.html">16.4. Get an FTP directory listing</a></li><li class="chapter-item "><a href="../examples/http-ul-nonblock.html">16.5. Non-blocking HTTP form-post</a></li></ol></li><li class="chapter-item "><a href="../bindings/index.html">17. libcurl bindings</a></li><li class="chapter-item "><a href="../internals/index.html">18. libcurl internals</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../internals/easy.html">18.1. Easy handles and connections</a></li><li class="chapter-item "><a href="../internals/multi.html">18.2. Everything is multi</a></li><li class="chapter-item "><a href="../internals/statemachines.html">18.3. State machines</a></li><li class="chapter-item "><a href="../internals/handler.html">18.4. Protocol handler</a></li><li class="chapter-item "><a href="../internals/backends.html">18.5. Backends</a></li><li class="chapter-item "><a href="../internals/caches.html">18.6. Caches and state</a></li><li class="chapter-item "><a href="../internals/timeouts.html">18.7. Timeouts</a></li><li class="chapter-item "><a href="../internals/windows-vs-unix.html">18.8. Windows vs Unix</a></li><li class="chapter-item "><a href="../internals/memory-debugging.html">18.9. Memory debugging</a></li><li class="chapter-item "><a href="../internals/content-encoding.html">18.10. Content Encoding</a></li><li class="chapter-item "><a href="../internals/structs.html">18.11. Structs</a></li><li class="chapter-item "><a href="../internals/resolving.html">18.12. Resolving hostnames</a></li><li class="chapter-item "><a href="../internals/tests/index.html">18.13. Tests</a><a class="toggle"><div>❱</div></a></li><li><ol class="section"><li class="chapter-item "><a href="../internals/tests/file-format.html">18.13.1. Test file format</a></li><li class="chapter-item "><a href="../internals/tests/build.html">18.13.2. Build tests</a></li><li class="chapter-item "><a href="../internals/tests/run.html">18.13.3. Run tests</a></li><li class="chapter-item "><a href="../internals/tests/debug.html">18.13.4. Debug builds</a></li><li class="chapter-item "><a href="../internals/tests/servers.html">18.13.5. Test servers</a></li><li class="chapter-item "><a href="../internals/tests/curl.html">18.13.6. curl tests</a></li><li class="chapter-item "><a href="../internals/tests/libcurl.html">18.13.7. libcurl tests</a></li><li class="chapter-item "><a href="../internals/tests/unit.html">18.13.8. Unit tests</a></li><li class="chapter-item "><a href="../internals/tests/valgrind.html">18.13.9. Valgrind</a></li><li class="chapter-item "><a href="../internals/tests/ci.html">18.13.10. Continuous Integration</a></li><li class="chapter-item "><a href="../internals/tests/autobuilds.html">18.13.11. Autobuilds</a></li><li class="chapter-item "><a href="../internals/tests/torture.html">18.13.12. Torture</a></li></ol></li></ol></li><li class="chapter-item "><a href="../bookindex.html">19. Index</a></li></ol> </div> <div id="sidebar-resize-handle" class="sidebar-resize-handle"> <div class="sidebar-resize-indicator"></div> </div> </nav>  <script> var sidebarScrollbox = document.querySelector('#sidebar .sidebar-scrollbox'); sidebarScrollbox.addEventListener('click', function(e) { if (e.target.tagName === 'A') { sessionStorage.setItem('sidebar-scroll', sidebarScrollbox.scrollTop); } }, { passive: true }); var sidebarScrollTop = sessionStorage.getItem('sidebar-scroll'); sessionStorage.removeItem('sidebar-scroll'); if (sidebarScrollTop) { // preserve sidebar scroll position when navigating via links within sidebar sidebarScrollbox.scrollTop = sidebarScrollTop; } else { // scroll sidebar to current active section when navigating via "next/previous chapter" buttons var activeSection = document.querySelector('#sidebar .active'); if (activeSection) { activeSection.scrollIntoView({ block: 'center' }); } } </script> <div id="page-wrapper" class="page-wrapper"> <div class="page"> <div id="menu-bar-hover-placeholder"></div> <div id="menu-bar" class="menu-bar sticky"> <div class="left-buttons"> <label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar"> </label> <button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list"> </button> <ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <li role="none"><button role="menuitem" class="theme" id="light">Light</button></li> <li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li> <li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li> <li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li> <li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li> </ul> <button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar"> </button> </div> <h1 class="menu-title">everything curl</h1> <div class="right-buttons"> <a href="../print.html" title="Print this book" aria-label="Print this book"> </a> </div> </div> <div id="search-wrapper" class="hidden"> <form id="searchbar-outer" class="searchbar-outer"> <input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header"> </form> <div id="searchresults-outer" class="searchresults-outer hidden"> <div id="searchresults-header" class="searchresults-header"></div> <ul id="searchresults"> </ul> </div> </div>  <script> document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1); }); </script> <div id="content" class="content"> <main> <h1 id="exit-code"><a class="header" href="#exit-code">Exit code</a></h1> A lot of effort has gone into the project to make curl return a usable exit code when something goes wrong and it always returns 0 (zero) when the operation went as planned. If you write a shell script or batch file that invokes curl, you can always check the return code to detect problems in the invoked command. Below, you find a list of return codes as of the time of this writing. Over time we tend to slowly add new ones so if you get a code back not listed here, please refer to more updated curl documentation for aid. A basic Unix shell script could look like something like this: <pre><code>#!/bin/sh curl http://example.com res=$? if test "$res" != "0"; then echo "the curl command failed with: $res" fi </code></pre> <h2 id="available-exit-codes"><a class="header" href="#available-exit-codes">Available exit codes</a></h2> <ol> <li> Unsupported protocol. This build of curl has no support for this protocol. Usually this happens because the URL was misspelled to use a scheme part that either has a space in front of it or spells <code>http</code> like <code>htpt</code> or similar. Another common mistake is that you use a libcurl installation that was built with one or more protocols disabled and you now ask libcurl to use one of those protocols that were disabled in the build. </li> <li> Failed to initialize. This is mostly an internal error or a problem with the libcurl installation or system libcurl runs in. </li> <li> URL malformed. The syntax was not correct. This happens when you mistype a URL so that it ends up wrong, or in rare situations you are using a URL that is accepted by another tool that curl does not support only because there is no universal URL standard that everyone adheres to. </li> <li> A feature or option that was needed to perform the desired request was not enabled or was explicitly disabled at build-time. To make curl able to do this, you probably need another build of libcurl. </li> <li> Could not resolve proxy. The address of the given proxy host could not be resolved. Either the given proxy name is just wrong, or the DNS server is misbehaving and does not know about this name when it should or perhaps even the system you run curl on is misconfigured so that it does not find/use the correct DNS server. </li> <li> Could not resolve host. The given remote host's address was not resolved. The address of the given server could not be resolved. Either the given hostname is just wrong, or the DNS server is misbehaving and does not know about this name when it should or perhaps even the system you run curl on is misconfigured so that it does not find/use the correct DNS server. </li> <li> Failed to connect to host. curl managed to get an IP address to the machine and it tried to set up a TCP connection to the host but failed. This can be because you have specified the wrong port number, entered the wrong hostname, the wrong protocol or perhaps because there is a firewall or other network equipment in between that blocks the traffic from getting through. </li> <li> Unknown FTP server response. The server sent data curl could not parse. This is either because of a bug in curl, a bug in the server or because the server is using an FTP protocol extension that curl does not support. The only real work-around for this is to tweak curl options to try to get it to use other FTP commands that perhaps do not get this unknown server response back. </li> <li> FTP access denied. The server denied login or denied access to the particular resource or directory you wanted to reach. Most often you tried to change to a directory that does not exist on the server. The directory of course is what you specify in the URL. </li> <li> FTP accept failed. While waiting for the server to connect back when an active FTP session is used, an error code was sent over the control connection or similar. </li> <li> FTP weird PASS reply. Curl could not parse the reply sent to the PASS request. PASS in the command curl sends the password to the server with, and even anonymous connections to FTP server actually sends a password - a fixed anonymous string. Getting a response back from this command that curl does not understand is a strong indication that this is not an FTP server at all or that the server is badly broken. </li> <li> During an active FTP session (PORT is used) while waiting for the server to connect, the timeout expired. It took too long for the server to get back. This is usually a sign that something is preventing the server from reaching curl successfully, such as a firewall or other network arrangements. </li> <li> Unknown response to FTP PASV command. Curl could not parse the reply sent to the PASV request. This is a strange server. PASV is used to set up the second data transfer connection in passive mode, see the <a href="../ftp/twoconnections.html">FTP uses two connections</a> section for more on that. You might be able to work-around this problem by using PORT instead, with the <code>--ftp-port</code> option. </li> <li> Unknown FTP 227 format. Curl could not parse the 227-line the server sent. This is most certainly a broken server. A 227 is the FTP server's response when sending back information on how curl should connect back to it in passive mode. You might be able to work-around this problem by using PORT instead, with the <code>--ftp-port</code> option. </li> <li> FTP cannot get host. Could not use the host IP address we got in the 227-line. This is most likely an internal error. </li> <li> HTTP/2 error. A problem was detected in the HTTP2 framing layer. This is somewhat generic and can be one out of several problems, see the error message for details. </li> <li> FTP could not set binary. Could not change transfer method to binary. This server is broken. curl needs to set the transfer to the correct mode before it is started as otherwise the transfer cannot work. </li> <li> Partial file. Only a part of the file was transferred. When the transfer is considered complete, curl verifies that it actually received the same amount of data that it was told before-hand that it was going to get. If the two numbers do not match, this is the error code. It could mean that curl got fewer bytes than advertised or that it got more. curl itself cannot know which number is wrong or which is correct, if any. </li> <li> FTP could not download/access the given file. The RETR (or similar) command failed. curl got an error from the server when trying to download the file. </li> <li> Not used </li> <li> Quote error. A quote command returned an error from the server. curl allows several different ways to send custom commands to an IMAP, POP3, SMTP or FTP server and features a generic check that the commands work. When any of the individually issued commands fails, this is the exit status returned. The advice is generally to watch the headers in the FTP communication to better understand exactly what failed and how. </li> <li> HTTP page not retrieved. The requested URL was not found or returned another error with the HTTP error code being 400 or above. This return code only appears if <code>-f, --fail</code> is used. </li> <li> Write error. Curl could not write data to a local filesystem or similar. curl receives data chunk by chunk from the network and it stores it like at (or writes it to stdout), one piece at a time. If that write action gets an error, this is the exit status. </li> <li> Not used </li> <li> Upload failed. The server refused to accept or store the file that curl tried to send to it. This is usually due to wrong access rights on the server but can also happen due to out of disk space or other resource constraints. This error can happen for many protocols. </li> <li> Read error. Various reading problems. The inverse to exit status 23. When curl sends data to a server, it reads data chunk by chunk from a local file or stdin or similar, and if that reading fails in some way this is the exit status curl returns. </li> <li> Out of memory. A memory allocation request failed. curl needed to allocate more memory than what the system was willing to give it and curl had to exit. Try using smaller files or make sure that curl gets more memory to work with. </li> <li> Operation timeout. The specified time-out period was reached according to the conditions. curl offers several <a href="../usingcurl/timeouts.html">timeouts</a>, and this exit code tells one of those timeout limits were reached. Extend the timeout or try changing something else that allows curl to finish its operation faster. Often, this happens due to network and remote server situations that you cannot affect locally. </li> <li> Not used </li> <li> FTP PORT failed. The PORT command failed. Not all FTP servers support the PORT command; try doing a transfer using PASV instead. The PORT command is used to ask the server to create the data connection by connecting back to curl. See also the <a href="../ftp/twoconnections.html">FTP uses two connections</a> section. </li> <li> FTP could not use REST. The REST command failed. This command is used for resumed FTP transfers. curl needs to issue the REST command to do range or resumed transfers. The server is broken, try the same operation without range/resume as a crude work-around. </li> <li> Not used </li> <li> HTTP range error. The range request did not work. Resumed HTTP requests are not necessarily acknowledged or supported, so this exit code signals that for this resource on this server, there can be no range or resumed transfers. </li> <li> HTTP post error. Internal post-request generation error. If you get this error, please report the exact circumstances to the curl project. </li> <li> A TLS/SSL connect error. The SSL handshake failed. The SSL handshake can fail due to numerous different reasons so the error message may offer some additional clues. Maybe the parties could not agree to a SSL/TLS version, an agreeable cipher suite or similar. </li> <li> Bad download resume. Could not continue an earlier aborted download. When asking to resume a transfer that then ends up not possible to do, this error can get returned. For FILE, FTP or SFTP. </li> <li> Could not read the given file when using the FILE:// scheme. Failed to open the file. The file could be non-existing or is it a permission problem perhaps? </li> <li> LDAP cannot bind. LDAP "bind" operation failed, which is a necessary step in the LDAP operation and thus this means the LDAP query could not be performed. This might happen because of a wrong username or password, or for other reasons. </li> <li> LDAP search failed. The given search terms caused the LDAP search to return an error. </li> <li> Not used </li> <li> Not used </li> <li> Aborted by callback. An application told libcurl to abort the operation. This error code is not generally made visible to users and not to users of the curl tool. </li> <li> Bad function argument. A function was called with a bad parameter - this return code is present to help application authors to understand why libcurl cannot perform certain actions and should never be returned by the curl tool. Please file a bug report to the curl project if this happens to you. </li> <li> Not used </li> <li> Interface error. A specified outgoing network interface could not be used. curl typically decides outgoing network and IP addresses by itself but when explicitly asked to use a specific one that curl cannot use, this error can occur. </li> <li> Not used </li> <li> Too many redirects. When following HTTP redirects, libcurl hit the maximum number set by the application. The maximum number of redirects is unlimited by libcurl but is set to 50 by default by the curl tool. The limit is present to stop endless redirect loops. Change the limit with <code>--max-redirs</code>. </li> <li> Unknown option specified to libcurl. This could happen if you use a curl version that is out of sync with the underlying libcurl version. Perhaps your newer curl tries to use an option in the older libcurl that was not introduced until after the libcurl version you are using but is known to your curl tool code as that is newer. To decrease the risk of this and make sure it does not happen: use curl and libcurl of the same version number. </li> <li> Malformed telnet option. The telnet option you provided to curl did not use the correct syntax. </li> <li> Not used </li> <li> The server's SSL/TLS certificate or SSH fingerprint failed verification. curl can then not be sure of the server being who it claims to be. See the <a href="../usingcurl/tls.html">using TLS with curl</a> and <a href="../usingcurl/ssh/">using SCP and SFTP with curl</a> sections for more details. </li> <li> The server did not reply anything, which in this context is considered an error. When an HTTP(S) server responds to an HTTP(S) request, it always returns something as long as it is alive and sound. All valid HTTP responses have a status line and responses header. Not getting anything at all back is an indication the server is faulty or perhaps that something prevented curl from reaching the right server or that you are trying to connect to the wrong port number etc. </li> <li> SSL crypto engine not found. </li> <li> Cannot set SSL crypto engine as default. </li> <li> Failed sending network data. Sending data over the network is a crucial part of most curl operations and when curl gets an error from the lowest networking layers that the sending failed, this exit status gets returned. To pinpoint why this happens, some serious digging is usually required. Start with enabling verbose mode, do tracing and if possible check the network traffic with a tool like Wireshark or similar. </li> <li> Failure in receiving network data. Receiving data over the network is a crucial part of most curl operations and when curl gets an error from the lowest networking layers that the receiving of data failed, this exit status gets returned. To pinpoint why this happens, some serious digging is usually required. Start with enabling verbose mode, do tracing and if possible check the network traffic with a tool like Wireshark or similar. </li> <li> Not used </li> <li> Problem with the local certificate. The client certificate had a problem so it could not be used. Permissions? The wrong passphrase? </li> <li> Could not use the specified SSL cipher. The cipher names need to be specified exactly and they are also unfortunately specific to the particular TLS backend curl has been built to use. For the current list of support ciphers and how to write them, see the online docs at <a href="https://curl.se/docs/ssl-ciphers.html">https://curl.se/docs/ssl-ciphers.html</a>. </li> <li> Peer certificate cannot be authenticated with known CA certificates. This usually means that the certificate is either self-signed or signed by a CA (Certificate Authority) that is not present in the CA store curl uses. </li> <li> Unrecognized transfer encoding. Content received from the server could not be parsed by curl. </li> <li> Not used </li> <li> Maximum file size exceeded. When curl has been told to restrict downloads to not do it if the file is too big, this is the exit code for that condition. </li> <li> Requested SSL (TLS) level failed. In most cases this means that curl failed to upgrade the connection to TLS when asked to. </li> <li> Sending the data requires a rewind that failed. In some situations curl needs to rewind in order to send the data again and if this cannot be done, the operation fails. </li> <li> Failed to initialize the OpenSSL SSL Engine. This can only happen when OpenSSL is used and would signify a serious internal problem. </li> <li> The username, password, or similar was not accepted and curl failed to log in. Verify that the credentials are provided correctly and that they are encoded the right way. </li> <li> File not found on TFTP server. </li> <li> Permission problem on TFTP server. </li> <li> Out of disk space on TFTP server. </li> <li> Illegal TFTP operation. </li> <li> Unknown TFTP transfer ID. </li> <li> File already exists (TFTP). </li> <li> No such user (TFTP). </li> <li> Not used </li> <li> Not used </li> <li> Problem with reading the SSL CA cert. The default or specified CA cert bundle could not be read/used to verify the server certificate. </li> <li> The resource (file) referenced in the URL does not exist. </li> <li> An unspecified error occurred during the SSH session. This sometimes indicates an incompatibility problem between the SSH libcurl curl uses and the SSH version used by the server curl speaks to. </li> <li> Failed to shut down the SSL connection. </li> <li> Not used </li> <li> Could not load CRL file, missing or wrong format </li> <li> TLS certificate issuer check failed. The most common reason for this is that the server did not send the proper intermediate certificate in the TLS handshake. </li> <li> The FTP <code>PRET</code> command failed. This is a non-standard command and far from all servers support it. </li> <li> RTSP: mismatch of CSeq numbers </li> <li> RTSP: mismatch of Session Identifiers </li> <li> Unable to parse FTP file list. The FTP directory listing format used by the server could not be parsed by curl. FTP wildcards can not be used on this server. </li> <li> FTP chunk callback reported error </li> <li> No connection available, the session is queued </li> <li> SSL public key does not match pinned public key. Either you provided a bad public key, or the server has changed. </li> <li> Invalid SSL certificate status. The server did not provide a proper valid certificate in the TLS handshake. </li> <li> Stream error in HTTP/2 framing layer. This is usually an unrecoverable error, but trying to force curl to speak HTTP/1 instead might circumvent it. </li> <li> An API function was called from inside a callback. If the curl tool returns this, something has gone wrong internally </li> <li> Authentication error. </li> <li> HTTP/3 layer error. This is somewhat generic and can be one out of several problems, see the error message for details. </li> <li> QUIC connection error. This error may be caused by an TLS library error. QUIC is the transport protocol used for HTTP/3. </li> <li> Proxy handshake error. Usually that means that a SOCKS proxy did not play along. </li> <li> A TLS client certificate is required but was not provided. </li> <li> An internal call to poll() or select() returned error that is not recoverable. </li> </ol> <h2 id="error-message"><a class="header" href="#error-message">Error message</a></h2> When curl exits with a non-zero code, it also outputs an error message (unless <code>--silent</code> is used). That error message may add some additional information or circumstances to the exit status number itself so the same error number can get different error messages. Users can also craft their own error messages with <a href="../usingcurl/verbose/writeout.html">--write-out</a>. The pseudo variable <code>%{onerror}</code> allows you to set a message that only gets displayed on errors, and it offers <code>%{errormsg}</code> and <code>%{exitcode}</code> among all the variables. For example: <pre><code>curl --write-out "%{onerror}curl says: (%{exitcode}) %{errormsg}" \ https://curl.se/ </code></pre> <h2 id="not-used"><a class="header" href="#not-used">"Not used"</a></h2> The list of exit codes above contains a number of values marked as 'not used'. Those are exit status codes that are not used in modern versions of curl but that have been used or were intended to be used in the past. They may be used in a future version of curl. Additionally, the highest used error status in this list is 99, but future curl versions might have added more exit codes after that number. </main> <nav class="nav-wrapper" aria-label="Page navigation">  <a rel="prev" href="../cmdline/curlver.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> </a> <a rel="next prefetch" href="../cmdline/copyas.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> </a> <div style="clear: both"></div> </nav> </div> </div> <nav class="nav-wide-wrapper" aria-label="Page navigation"> <a rel="prev" href="../cmdline/curlver.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> </a> <a rel="next prefetch" href="../cmdline/copyas.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> </a> </nav> </div> <script> window.playground_copyable = true; </script> <script src="../elasticlunr.min.js"></script> <script src="../mark.min.js"></script> <script src="../searcher.js"></script> <script src="../clipboard.min.js"></script> <script src="../highlight.js"></script> <script src="../book.js"></script>  </div> </body> </html>