aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDerek Buitenhuis <derek.buitenhuis@gmail.com>2024-04-22 15:25:47 +0100
committerDerek Buitenhuis <derek.buitenhuis@gmail.com>2024-04-25 14:21:25 +0100
commit1f8e5b6d9533a7fa816945d11b1839622398519f (patch)
treef23df66645b53474e06f599e4cd41b6b619187ed /doc
parent5d568b16a0ab46328ece18bdcd615d7d0fbd7e49 (diff)
downloadffmpeg-1f8e5b6d9533a7fa816945d11b1839622398519f.tar.gz
doc/protocols: Fill in missing HTTP options
Signed-off-by: Derek Buitenhuis <derek.buitenhuis@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/protocols.texi30
1 files changed, 29 insertions, 1 deletions
diff --git a/doc/protocols.texi b/doc/protocols.texi
index 5ce1ddc8f4..571d78ec43 100644
--- a/doc/protocols.texi
+++ b/doc/protocols.texi
@@ -492,6 +492,10 @@ contains the last non-empty metadata packet sent by the server. It should be
polled in regular intervals by applications interested in mid-stream metadata
updates.
+@item metadata
+Set an exported dictionary containing Icecast metadata from the bitstream, if present.
+Only useful with the C API.
+
@item auth_type
Set HTTP authentication type. No option for Digest, since this method requires
@@ -519,6 +523,10 @@ 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.
+@item location
+An exported dictionary containing the content location. Only useful with the C
+API.
+
@item offset
Set initial byte offset.
@@ -535,6 +543,9 @@ be given a Bad Request response.
When unset the HTTP method is not checked for now. This will be replaced by
autodetection in the future.
+@item reconnect
+Reconnect automatically when disconnected before EOF is hit.
+
@item reconnect_at_eof
If set then eof is treated like an error and causes reconnection, this is useful
for live / endless streams.
@@ -550,7 +561,13 @@ include specific status codes (e.g. '503') or the strings '4xx' / '5xx'.
If set then even streamed/non seekable streams will be reconnected on errors.
@item reconnect_delay_max
-Sets the maximum delay in seconds after which to give up reconnecting
+Set the maximum delay in seconds after which to give up reconnecting.
+
+@item reconnect_max_retries
+Set the maximum number of times to retry a connection. Default unset.
+
+@item reconnect_delay_total_max
+Set the maximum total delay in seconds after which to give up reconnecting.
@item listen
If set to 1 enables experimental HTTP server. This can be used to send data when
@@ -578,6 +595,17 @@ ffmpeg -i somefile.ogg -chunked_post 0 -c copy -f ogg http://@var{server}:@var{p
wget --post-file=somefile.ogg http://@var{server}:@var{port}
@end example
+@item resource
+The resource requested by a client, when the experimental HTTP server is in use.
+
+@item reply_code
+The HTTP code returned to the client, when the experimental HTTP server is in use.
+
+@item short_seek_size
+Set the threshold, in bytes, for when a readahead should be prefered over a seek and
+new HTTP request. This is useful, for example, to make sure the same connection
+is used for reading large video packets with small audio packets in between.
+
@end table
@subsection HTTP Cookies