From patchwork Fri Mar 31 02:28:42 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Timothy Lee X-Patchwork-Id: 3212 Delivered-To: ffmpegpatchwork@gmail.com Received: by 10.103.44.195 with SMTP id s186csp1839527vss; Thu, 30 Mar 2017 19:36:15 -0700 (PDT) X-Received: by 10.28.51.140 with SMTP id z134mr510343wmz.55.1490927774890; Thu, 30 Mar 2017 19:36:14 -0700 (PDT) Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id 6si1324998wmj.135.2017.03.30.19.36.14; Thu, 30 Mar 2017 19:36:14 -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; 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=NONE 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 08A4E6898EF; Fri, 31 Mar 2017 05:36:12 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pg0-f47.google.com (mail-pg0-f47.google.com [74.125.83.47]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id EE8D2688395 for ; Fri, 31 Mar 2017 05:36:04 +0300 (EEST) Received: by mail-pg0-f47.google.com with SMTP id g2so55906841pge.3 for ; Thu, 30 Mar 2017 19:36:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:subject:message-id:date:user-agent:mime-version; bh=wR5stwBiK4jFdSNHm+pRtCidvaiIa+L1W4wJArjssQQ=; b=s6ufd2qfmYvJrEt0U3Acime//+ZI+eV7mLbOKCks1Rr+Ic74vpBZkrno6xbj+9L0sn GurRuO9oYOeOfz54cipSxob3Bj4T84APu3X26gRgLGdLpI+HHYqJpwWKwPDdHJHjxV9l Iqey0mk4+oCTg6nfQJUQ8lnPmPK0d9CWLKRzZVESJzGbiYBObw/p4JiuX/CrHT6igVdx 0+O4z5l4JGiN3+jaZQBnY8g7f/LfijVgQka9HDqa/sJDTy00wOm1wbgipb1NVLeWuKmq vno/QU+kkHHoVysZ4iTUzhDVpPrzsnAEiJSclP/7nEJ5H7SSabrW5yFemDGjjy4htZZe LWnw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:subject:message-id:date:user-agent :mime-version; bh=wR5stwBiK4jFdSNHm+pRtCidvaiIa+L1W4wJArjssQQ=; b=IXswbpbWmXn32Sux6pdIE/85G1MMgec8Qf4ddXUDjYfrTZPKmrKW9NwK0sKFQhiHj4 23t1dH9tB/CUBQbZEnXTJsNbr5LMlpKzXLhw6YWT+NZInvU4GuD8sdNT1mxN2cf8I/R1 umzqitBYXm6LB1VgPuuxbqk7FVJMt0pddfETu9YkN5fWI/eyA67IFGfq4C+daYeoF2Lr NuCQ+xm3UTVdrwURPEi68kgJR/qsiujcx7t2pjvHrk97B1ZZKSPS6vvBPZ3FZA2cyzkD YcQlNRnQoyCjTAQIu3/jteL24Bm5C5BSYzjkaX8Ge/b+QEzvRu5Hjfssnl0mX9bQH+19 pVVA== X-Gm-Message-State: AFeK/H2zy3zR62AIprQB/NaaNd8qReHiHTP3MU/yfzAI0MMqNIdfuMIotV4TJRRNxnskDA== X-Received: by 10.99.24.88 with SMTP id 24mr905243pgy.54.1490927326028; Thu, 30 Mar 2017 19:28:46 -0700 (PDT) Received: from archlinxu1.uavvision.com.au (59-100-13-146.mel.static-ipl.aapt.com.au. [59.100.13.146]) by smtp.gmail.com with ESMTPSA id n67sm228642pfk.44.2017.03.30.19.28.44 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 30 Mar 2017 19:28:45 -0700 (PDT) To: ffmpeg-devel@ffmpeg.org From: Timothy Lee Message-ID: <8ed4df75-b715-5f30-d7bf-ba85e4c51705@gmail.com> Date: Fri, 31 Mar 2017 13:28:42 +1100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 2/2] doc: update cache protocol documentation X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 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" This patch updates the cache protocol documentation to describe the cache_file option added by the previous patch. From 42e09bc8c6a27c760c1fba23ba9591a521768b36 Mon Sep 17 00:00:00 2001 From: Timothy Lee Date: Fri, 31 Mar 2017 12:54:57 +1100 Subject: [PATCH 2/2] doc: update cache protocol documentation Describe cache_file option and give additional example --- doc/protocols.texi | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/doc/protocols.texi b/doc/protocols.texi index a7968ff56e..9e14e430cf 100644 --- a/doc/protocols.texi +++ b/doc/protocols.texi @@ -97,10 +97,26 @@ Read angle 2 of playlist 4 from BluRay mounted to /mnt/bluray, start from chapte Caching wrapper for input stream. -Cache the input stream to temporary file. It brings seeking capability to live streams. +Cache the input stream to a file. It brings seeking capability to live streams. +This protocol accepts the following options: +@table @option + +@item cache_file +Name of the cache file. +If not specified a temporary file will be used, and deleted after playback. + +@end table + +For example, to cache the input stream to a temporary file using +@command{ffplay}: +@example +ffplay cache:@var{URL} +@end example + +To cache the input stream to @file{stream.dat}: @example -cache:@var{URL} +ffplay -cache_file stream.dat cache:@var{URL} @end example @section concat -- 2.12.1