From patchwork Tue Apr 16 13:55:55 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Derek Buitenhuis X-Patchwork-Id: 48089 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:ce4e:b0:1a9:af23:56c1 with SMTP id id14csp376569pzb; Tue, 16 Apr 2024 06:56:29 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCWZHCTkp+00wXk1uTEiwt4Wl3UaqoUXeApTGno4m1VToYstzNjhDrrHVoqNM9qn7sg6LroNksH3A+rZ0DtstJe7LkIE9rE360KDSg== X-Google-Smtp-Source: AGHT+IHMC3H9LfyhoBbj1GpxJKN0v8cGv32qizkxCjsn+7xWDSs2DIgiDRHrsxuvj1WiTsPAtu6L X-Received: by 2002:a2e:9c93:0:b0:2da:dfd1:8abf with SMTP id x19-20020a2e9c93000000b002dadfd18abfmr1308768lji.48.1713275788814; Tue, 16 Apr 2024 06:56:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1713275788; cv=none; d=google.com; s=arc-20160816; b=0vpOqbxgOpyG/AzGNdid6uJVtuUokKT28lItgag7tqarRUoRzRg27Qjtyr4w723cbR /eR5XvwbSXsDPGconN21etsOLHsY0zg2+kUZ+mFJRZ0C6WwaUrv9fy4fXZgYn8tW5kxD qbgRzodbfu4+m100ttS8ONhG8g1YcniswsQMtb1GwlxAPJacgIwCRS1nizQ0wl2f3kyK wCnPRpVirbQQ1QcSamdEKI6JR10QcZp234zyiGKRhUlsRXh1ivvY2wKNmZ3KgvG7nm3+ Oe/DEDdT+F/1AHsE50YzHvhglRaoz5/VSeylnik9JBeiVwsPe+htJuO7S+bMVNofflK/ 5LiA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:reply-to:list-subscribe :list-help:list-post:list-archive:list-unsubscribe:list-id :precedence:subject:mime-version:references:in-reply-to:message-id :date:to:from:dkim-signature:delivered-to; bh=XhM4cOzY584CGLeRC19Wwb5g/VmTLvvRsv5SjfQQb3A=; fh=YOA8vD9MJZuwZ71F/05pj6KdCjf6jQRmzLS+CATXUQk=; b=qZPu3F3fy2C39QquEDLpHae+nfN8JdWfz63LnNEouXQwrKZKipoJWA3U3uAs/9ruph 4syz/YQzc+6bPIp6KZUtPaATMEUqwJ5ExJie4mVi9EZFaPLEJQNC3/Yk7iAVhDn4CrEj h4dx3cULtouyvYAzCtT2BLpthc0h9ORK5yQOsfVmoopJGTTEdzFHw/YrmEV4QRGCFcTt TbMdcopSM2LQRM+MzDgXKZHpQOjkQztaC0QOUOiAUwKfGZwoSgzbXd/Qim/bPXw5/+cG VEVLKSiX2CD6V+ARtOH+ka+5832TejlMFOXmGMZF9tjiLakgkHnC1J/uSwAbCSm3EcCx rFVg==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20230601 header.b="J3/jTjKd"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id c22-20020a2e9496000000b002d4aa141d28si3182138ljh.288.2024.04.16.06.56.28; Tue, 16 Apr 2024 06:56:28 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20230601 header.b="J3/jTjKd"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 6795B68D25B; Tue, 16 Apr 2024 16:56:15 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-wm1-f41.google.com (mail-wm1-f41.google.com [209.85.128.41]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 7F92068D0B1 for ; Tue, 16 Apr 2024 16:56:08 +0300 (EEST) Received: by mail-wm1-f41.google.com with SMTP id 5b1f17b1804b1-418a776a4a0so1206255e9.1 for ; Tue, 16 Apr 2024 06:56:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1713275767; x=1713880567; darn=ffmpeg.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=IRWr4J3ILRiH6Lg+uifDMa1tL1PBTGWy9cxeqL4J93M=; b=J3/jTjKdUd+zHI02nz6xBXrIO3qRpwsati5GocUp2VAtaflokcG/bjpkBoCU82MXFA DinscYtLAectWJTg6sdcb/5FbPNa9TTEyvn0J3dW8fA9IhTg3CVkrtvARJ6EGAnzaCXq c3RigFzYj9bEJ9HtN8bEe6cOKCBR1uMnJ+Lun5U1KDBMcmakkyb21cs0CTJyBucH2Rlj hIigsdMEsSDeIumraf6hzqQWJxAEIVssupVpet+ek8sJC6DQ+S8Th/GO4G6McQKP44Gf 0NMiiEgWivDjqfpyLMsWb14g6imRh+6pw+LNBO7de6PSRp4R/BR8j697DPT8sVf6GkTa pI6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1713275767; x=1713880567; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=IRWr4J3ILRiH6Lg+uifDMa1tL1PBTGWy9cxeqL4J93M=; b=U7xY4uOW+BHJzDSjpqfV5KTxf7MJZvGwYVsRNRj3u960vo/hZWkApje5h0k3HIG7Cc 1mMmgROifaRPxetqk3t/Z50vosBxylKy+qQRbQU7gFuMgj1cIkJD/pW9USd4Pw+v+/gQ v0uPZaEcUtjxk7K0hXl3V9UTXBYx7xi9hePiBgrmXKO8CHP8HzwXYSHdsyIoy7T0E/4w xgF34pWRCDzCOz3ykvK0PZ/OLgOlyYu9L/TwJhiHKknj3NcQacB32eko5GQGvTgCGjCR IMHLCR86iiEhU8HK/2Ph9EEthSLNgPQ6d9u7w+iE3+H5PO7U7yXkygK8UsxEb+J1CQSc VdCA== X-Gm-Message-State: AOJu0YwzpfVF+ikwqDNjvtSwxRMeQ3XTdvcmUQTUEy7gds4rNFEggR7z qy0+tmTZVUSELNmRYOTK+Qg5oXFTw77MiSyFsCuSZW2ACmO3Qw7NzuWEUg== X-Received: by 2002:a05:600c:5011:b0:418:677d:cded with SMTP id n17-20020a05600c501100b00418677dcdedmr4302414wmr.0.1713275767153; Tue, 16 Apr 2024 06:56:07 -0700 (PDT) Received: from localhost.localdomain (33bf3d9d.skybroadband.com. [51.191.61.157]) by smtp.gmail.com with ESMTPSA id s14-20020a05600c384e00b0041892857924sm2599677wmr.36.2024.04.16.06.56.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Apr 2024 06:56:06 -0700 (PDT) From: Derek Buitenhuis To: ffmpeg-devel@ffmpeg.org Date: Tue, 16 Apr 2024 14:55:55 +0100 Message-ID: <20240416135555.111773-2-derek.buitenhuis@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240416135555.111773-1-derek.buitenhuis@gmail.com> References: <20240415162741.110374-1-derek.buitenhuis@gmail.com> <20240416135555.111773-1-derek.buitenhuis@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 8/6] doc/protocols: Fill in missing HTTP options X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: dFSLeSAhIalU Signed-off-by: Derek Buitenhuis --- doc/protocols.texi | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/doc/protocols.texi b/doc/protocols.texi index 5ce1ddc8f4..60c6d831dd 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 +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. @@ -552,6 +563,14 @@ 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 +@item reconnect_max_retries +Sets the maximum number of times to retry a connection. Default unset. + +@item respect_retry_after +If enabled, and a Retry-After header is encountered, its requested reconnection +delay will be honored, rather than using exponential backoff. Useful for 429 and +503 errors. Default enabled. + @item listen If set to 1 enables experimental HTTP server. This can be used to send data when used as an output option, or read data from a client with HTTP POST when used as @@ -578,6 +597,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 +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