cookie.d 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. Short: b
  2. Long: cookie
  3. Arg: <data|filename>
  4. Protocols: HTTP
  5. Help: Send cookies from string/file
  6. Category: http
  7. Example: -b cookiefile $URL
  8. Example: -b cookiefile -c cookiefile $URL
  9. See-also: cookie-jar junk-session-cookies
  10. Added: 4.9
  11. ---
  12. Pass the data to the HTTP server in the Cookie header. It is supposedly the
  13. data previously received from the server in a "Set-Cookie:" line. The data
  14. should be in the format "NAME1=VALUE1; NAME2=VALUE2". This makes curl use the
  15. cookie header with this content explicitly in all outgoing request(s). If
  16. multiple requests are done due to authentication, followed redirects or
  17. similar, they will all get this cookie passed on.
  18. If no '=' symbol is used in the argument, it is instead treated as a filename
  19. to read previously stored cookie from. This option also activates the cookie
  20. engine which will make curl record incoming cookies, which may be handy if
  21. you are using this in combination with the --location option or do multiple URL
  22. transfers on the same invoke. If the file name is exactly a minus ("-"), curl
  23. will instead read the contents from stdin.
  24. The file format of the file to read cookies from should be plain HTTP headers
  25. (Set-Cookie style) or the Netscape/Mozilla cookie file format.
  26. The file specified with --cookie is only used as input. No cookies will be
  27. written to the file. To store cookies, use the --cookie-jar option.
  28. If you use the Set-Cookie file format and do not specify a domain then the
  29. cookie is not sent since the domain will never match. To address this, set a
  30. domain in Set-Cookie line (doing that will include sub-domains) or preferably:
  31. use the Netscape format.
  32. This option can be used multiple times.
  33. Users often want to both read cookies from a file and write updated cookies
  34. back to a file, so using both --cookie and --cookie-jar in the same command
  35. line is common.