curl/docs/cmdline-opts/proto-redir.d

Long: proto-redir
Arg: <protocols>
Help: Enable/disable PROTOCOLS on redirect
Added: 7.20.2
Category: connection curl
Example: --proto-redir =http,https $URL
---
Tells curl to limit what protocols it may use on redirect. Protocols denied by
--proto are not overridden by this option. See --proto for how protocols are
represented.

Example, allow only HTTP and HTTPS on redirect:

 curl --proto-redir -all,http,https http://example.com

By default curl will only allow HTTP, HTTPS, FTP and FTPS on redirect (since
7.65.2). Specifying *all* or *+all* enables all protocols on redirects, which
is not good for security.
cmdline-docs: more conversion 2016-11-16 21:20:36 +08:00			`Long: proto-redir`
			`Arg: <protocols>`
			`Help: Enable/disable PROTOCOLS on redirect`
			`Added: 7.20.2`
docs: add categories to all cmdline opts Adapted gen.pl with 'listcats' This commit is a part of "--help me if you can" Closes #5680 2020-07-13 20:15:04 +08:00			`Category: connection curl`
curl.1: provide examples for each option The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654 2021-08-31 22:37:14 +08:00			`Example: --proto-redir =http,https $URL`
cmdline-docs: more conversion 2016-11-16 21:20:36 +08:00			`---`
			`Tells curl to limit what protocols it may use on redirect. Protocols denied by`
			`--proto are not overridden by this option. See --proto for how protocols are`
			`represented.`

			`Example, allow only HTTP and HTTPS on redirect:`

			`curl --proto-redir -all,http,https http://example.com`

curl.1: remove mentions of really old version changes To make the man page more readable, this change removes all references to changes in support/versions etc that happened before 7.30.0 from the curl.1 output file. 7.30.0 was released on Apr 12 2013. This particular limit is a bit arbitrary but was fairly easy to grep for. It is handled like this: the 'Added' keyword is only used in output if it refers to 7.30.0 or later. All occurances of "(Added in $VERSION)" in description will be stripped out if the mentioned $VERSION is from before 7.30.0. It is therefore important that the "Added in..." references are always written exactly like that - and on a single line, not split over two. This change removes about 80 version number references from curl.1, down to 138 from 218. Closes #7786 2021-09-28 16:30:59 +08:00			`By default curl will only allow HTTP, HTTPS, FTP and FTPS on redirect (since`
			`7.65.2). Specifying all or +all enables all protocols on redirects, which`
			`is not good for security.`