location.d 1.3 KB

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