location.d 1.2 KB

1234567891011121314151617181920212223242526272829
  1. Long: location
  2. Short: L
  3. Help: Follow redirects
  4. Protocols: HTTP
  5. Category: http
  6. Example: -L $URL
  7. Added: 4.9
  8. See-also: resolve alt-svc
  9. ---
  10. If the server reports that the requested page has moved to a different
  11. location (indicated with a Location: header and a 3XX response code), this
  12. option will make curl redo the request on the new place. If used together with
  13. --include or --head, headers from all requested pages will be shown. When
  14. authentication is used, curl only sends its credentials to the initial
  15. host. If a redirect takes curl to a different host, it will not be able to
  16. intercept the user+password. See also --location-trusted on how to change
  17. this. You can limit the amount of redirects to follow by using the
  18. --max-redirs option.
  19. When curl follows a redirect and if the request is a POST, it will send the
  20. following request with a GET if the HTTP response was 301, 302, or 303. If the
  21. response code was any other 3xx code, curl will re-send the following request
  22. using the same unmodified method.
  23. You can tell curl to not change POST requests to GET after a 30x response by
  24. using the dedicated options for that: --post301, --post302 and --post303.
  25. The method set with --request overrides the method curl would otherwise select
  26. to use.