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