From patchwork Mon Apr 22 14:25:47 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Derek Buitenhuis X-Patchwork-Id: 48219 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:c906:b0:1a9:af23:56c1 with SMTP id gx6csp2325742pzb; Mon, 22 Apr 2024 07:27:04 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCWvc/hlU3vdw5gwHCaioVgvj/W5kJlCxNBEij/ztfEE5seY9UA8mgz2FvO7WuVzPekTpI618Fi6y2x6NibnQWaP0pCKU3UyJAw7AQ== X-Google-Smtp-Source: AGHT+IEdTwQM6WaiuZ8Hb1d8ph1WwnYjncHzA2b9BVx/im/dHZC2XjCcSClXgRgf2UkiMZlux/BZ X-Received: by 2002:ac2:5bd2:0:b0:518:c3b7:bc0 with SMTP id u18-20020ac25bd2000000b00518c3b70bc0mr5481827lfn.10.1713796024169; Mon, 22 Apr 2024 07:27:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1713796024; cv=none; d=google.com; s=arc-20160816; b=f2pVBvlYlRDWCJerEhHGuFTqCjJBBMjCe0ROl249Ea5RDYU1TgBEx5PxlM/6DDLf01 sT+YB9714hYznkc+18OHHEoLaGbfeqtzL/aj0qiB1wOAYjbSwcCPkG/A8m9D+SW2WtPp M88Q6E9ZTHtqmlTbbibtZeS5rTJpPPlugM2TN79c0IyzH55dhaYQtIrQQ5nLAo8IS2kT t4+ak4Eummhen+CLdmLSTEwtbp+k2j8j5AvohklvXTaxoEMYwNif/fUGWW1COiEgpAwC Y3pYRLqqCgL8sEyiRDJuNSQqNF5pk6+P6zM4cC+opwFENnW1zHONxK+6uyD0l4hL8i+Q JSSg== 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=XCfAnexJFwvzQTGn4P+ixAY7Y6KGPUMncMHkToDwN34=; fh=YOA8vD9MJZuwZ71F/05pj6KdCjf6jQRmzLS+CATXUQk=; b=D8pFpzmvVHc8KGJehljOyAnS5yeuLrRbNy9vH8glwLZ1JTB4iFIjqT0h4E1ty96svh xWaKVUQh6Q4Od3MexoW0oLz9ropUq5jrvmDjl2A+gq/rve/s7JjhMZMy8GWmLA0d9HmS MaOc676MwB3ZXfW2ULO0ia6nRKidB8V6XeExZONh3HLvaIXc5IsOnI7QmItvVFp3LA63 qJ5teO7SHE5mpNgBLlX0T6Wuy/VFT6yo2TW8/dmlejpkEd0tRBxPETffca3BNoVpKFwv RQ5GflLdevyMPJKSDYmBTnz8T12lHAAi9Q4ZwOSC66QtmGWB+E+Yxcx/FVnwLDV1QWaq dtnQ==; 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=i2gvwtyU; 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 r7-20020a170906350700b00a51fc671857si5964590eja.457.2024.04.22.07.27.03; Mon, 22 Apr 2024 07:27:04 -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=i2gvwtyU; 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 C130768D2BB; Mon, 22 Apr 2024 17:26:13 +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 19C2F68D2D6 for ; Mon, 22 Apr 2024 17:26:08 +0300 (EEST) Received: by mail-wm1-f41.google.com with SMTP id 5b1f17b1804b1-41a5b68ed0aso6524195e9.2 for ; Mon, 22 Apr 2024 07:26:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1713795967; x=1714400767; 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=JSHq4hFzOGO2Ykaw/26pb9JQBSR968l3EqcOazb7rsc=; b=i2gvwtyUG1Ixn2xmRS0hefj1XBiEjVk15LWL/z1/ayaia4GsjOR6X9E7FtnIZY/tWL EbkBcUUIxgt7fPCfdCyd5GsnZ/ejgjlUojWxmLpY5Kx6iZvMPwdB9Q91/taEeucUDpm1 vdUTCdQm7KptBokD+dvvd2qACsgYcZ4Tv1xu2jrR01GIR2U6EcQYhiB2/5aZGVoAyWuu TCO3B5gF1NMfvhKfsdFqCER7JAUO4G/lbbjK4CQ6i01ijiPLFOHMjV9GZ9sXSulXd1t6 SIg/hI1mVhWkmn0aFOMHuWjGIQk0g9CTowjhxRJuBhkeIVLDUDf7pvmHUDPyDi2QspzN bbHw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1713795967; x=1714400767; 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=JSHq4hFzOGO2Ykaw/26pb9JQBSR968l3EqcOazb7rsc=; b=dx3TVL5OCf+ABWmveLVTBOcA1pbLJTYDn0tAzoTZ3tWr+fP/2StpOVmBK+HTZIANqw 6q7s7nvNI+XwGAC/xWCkmZPkE82/krLKA6rtASY1se9HVxXID7GR2MgPrVWznf3LGnnL 6Ll1KBr4AS8cAr40UKHvzUnliyCiizatp2/Abe6/PYmWHUZc0rSTfYZKDSM3zLh3ipWg yli8nDwjB2wTpbB1CJk37VlAdXcwk7nfB3OWAnT1mIL0AZEkd5NOH5I7sB8HYl+cP885 6El+9Qscm/KtnLZWG2VK+si1ITx0Fnuzk6Bl24Q0nJdcTeKjknp0s1k1AL/Mp8jluqE8 wQEw== X-Gm-Message-State: AOJu0Yzf3zc+56+eakSUa/zaUpWZ+Qa4MoOwn6SotAE9ALypj7ceOljK qwCwSG15c8UExu8kkQ+Ks6c5OUZfmuOAI3X5YdM6EMCJhqfqTNw7Fx62XQ== X-Received: by 2002:a05:600c:4f43:b0:41a:226f:d481 with SMTP id m3-20020a05600c4f4300b0041a226fd481mr3149844wmq.39.1713795967243; Mon, 22 Apr 2024 07:26:07 -0700 (PDT) Received: from localhost.localdomain (33bf3d9d.skybroadband.com. [51.191.61.157]) by smtp.gmail.com with ESMTPSA id d11-20020a05600c3acb00b0041aa14b4646sm67111wms.8.2024.04.22.07.26.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Apr 2024 07:26:06 -0700 (PDT) From: Derek Buitenhuis To: ffmpeg-devel@ffmpeg.org Date: Mon, 22 Apr 2024 15:25:47 +0100 Message-ID: <20240422142547.281064-10-derek.buitenhuis@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240422142547.281064-1-derek.buitenhuis@gmail.com> References: <20240422142547.281064-1-derek.buitenhuis@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v2 9/9] 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: iHWJHegvTTFZ Signed-off-by: Derek Buitenhuis --- doc/protocols.texi | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/doc/protocols.texi b/doc/protocols.texi index 5ce1ddc8f4..ed70af4b33 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,18 @@ 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 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 @@ -578,6 +600,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