[FFmpeg-devel] [PATCH 10/10] doc: document fs: and file: changes.

Nicolas George george at nsup.org
Tue Jul 27 17:48:13 EEST 2021


Signed-off-by: Nicolas George <george at nsup.org>
---
 doc/protocols.texi | 40 +++++++++++++++++++++++++++++++---------
 1 file changed, 31 insertions(+), 9 deletions(-)

diff --git a/doc/protocols.texi b/doc/protocols.texi
index 726e5f1c44..d341d93914 100644
--- a/doc/protocols.texi
+++ b/doc/protocols.texi
@@ -283,20 +283,16 @@ Read from or write to a file.
 
 A file URL can have the form:
 @example
-file:@var{filename}
+file://@var{encoded_absolute_path}
 @end example
 
-where @var{filename} is the path of the file to read.
+where @var{encoded_absolute_path} is the path of the file, with standard %
+URL encoding..
 
-An URL that does not have a protocol prefix will be assumed to be a
-file URL. Depending on the build, an URL that looks like a Windows
-path with the drive letter at the beginning will also be assumed to be
-a file URL (usually not the case in builds for unix-like systems).
-
-For example to read from a file @file{input.mpeg} with @command{ffmpeg}
+For example to read from a file @file{/tmp/test input.mpeg} with @command{ffmpeg}
 use the command:
 @example
-ffmpeg -i file:input.mpeg output.mpeg
+ffmpeg -i file:///tmp/test%20input.mpeg output.mpeg
 @end example
 
 This protocol accepts the following options:
@@ -327,6 +323,32 @@ overriding this might speed up opening certain files at the cost of losing some
 features (e.g. accurate seeking).
 @end table
 
+ at section fs
+
+Direct file system access protocol.
+
+Read from or write to a file.
+
+A fs URL can have the form:
+ at example
+fs:@var{filename}
+ at end example
+
+where @var{filename} is the path of the file.
+
+An URL that does not have a protocol prefix will be assumed to be a
+fs URL. Depending on the build, an URL that looks like a Windows
+path with the drive letter at the beginning will also be assumed to be
+a fs URL (usually not the case in builds for unix-like systems).
+
+For example to read from a file @file{input.mpeg} with @command{ffmpeg}
+use the command:
+ at example
+ffmpeg -i fs:input.mpeg output.mpeg
+ at end example
+
+This protocol accepts the same options as the file protocol.
+
 @section ftp
 
 FTP (File Transfer Protocol).
-- 
2.30.2



More information about the ffmpeg-devel mailing list