[FFmpeg-devel] [PATCH 1/3] doc/http: Update HTTP protocol options

[Gyan Doshi]

On 18-07-2020 05:26 pm, Jun Zhao wrote:
> From: Jun Zhao <barryjzhao at tencent.com>
>
> remove the timeout option docs part for HTTP protocol and add
> auth_type option part.
>
> Signed-off-by: Jun Zhao <barryjzhao at tencent.com>
> ---
>   doc/protocols.texi | 27 ++++++++++++++++++++++-----
>   1 file changed, 22 insertions(+), 5 deletions(-)
>
> diff --git a/doc/protocols.texi b/doc/protocols.texi
> index 64ad3f0..7b3df96 100644
> --- a/doc/protocols.texi
> +++ b/doc/protocols.texi
> @@ -392,11 +392,6 @@ string describing the libavformat build. ("Lavf/<version>")
>   @item user-agent
>   This is a deprecated option, you can use user_agent instead it.
>   
> - at item timeout
> -Set timeout in microseconds of socket I/O operations used by the underlying low level
> -operation. By default it is set to -1, which means that the timeout is
> -not specified.
> -
>   @item reconnect_at_eof
>   If set then eof is treated like an error and causes reconnection, this is useful
>   for live / endless streams.
> @@ -481,6 +476,28 @@ Send an Expect: 100-continue header for POST. If set to 1 it will send, if set
>   to 0 it won't, if set to -1 it will try to send if it is applicable. Default
>   value is -1.
>   
> + at item auth_type
> +
> +Set HTTP authentication type. No option for Digest, since this method requires
> +getting nonce parameters from the server first and can't be used straight away like
> +Basic.
> +
> + at table @option
> + at item none
> +Choose the HTTP authentication type automatically. This is the default.
> + at item basic
> +
> +Choose the HTTP basic authentication.
> +
> +Basic authentication sends a Base64-encoded string that contains a user name and password
> +for the client. Base64 is not a form of encryption and should be considered the same as
> +sending the user name and password in clear text (Base64 is a reversible encoding).
> +If a resource needs to be protected, strongly consider using an authentication scheme
> +other than basic authentication. HTTPS/TLS should be used with basic authentication.
> +Without these additional security enhancements, basic authentication should not be used
> +to protect sensitive or valuable information.
> + at end table
> +
>   @end table
>   
>   @subsection HTTP Cookies

LGTM.

Gyan