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