summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-05-11 16:51:33 +0200
committerwm4 <wm4@nowhere>2014-05-11 16:51:33 +0200
commit7cab9ea2fa6a94a96496560b027c4bc029552eb1 (patch)
tree5abbe11dd48004256c94a00e1a83ba8a6d0c48ae /DOCS
parent77ce54c6984cadb91d105c5ed768a07bdbdfee5a (diff)
downloadmpv-7cab9ea2fa6a94a96496560b027c4bc029552eb1.tar.bz2
mpv-7cab9ea2fa6a94a96496560b027c4bc029552eb1.tar.xz
manpage: update --playlist entry
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst15
1 files changed, 10 insertions, 5 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 4a432fa58b..ddeb82fd36 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1669,20 +1669,25 @@ OPTIONS
file is dumped.
``--playlist=<filename>``
- Play files according to a playlist file (ASX, Winamp, SMIL, or
- one-file-per-line format).
+ Play files according to a playlist file (Supports some common formats.If
+ no format is detected, t will be treated as list of files, separated by
+ newline characters. Note that XML playlist formats are not supported.)
.. warning::
- The way mpv parses and uses playlist files is not safe against
- maliciously constructed files. Such files may trigger harmful actions.
+ The way mpv uses playlist files is not safe against maliciously
+ constructed files. Such files may trigger harmful actions.
This has been the case for all mpv and MPlayer versions, but
unfortunately this fact was not well documented earlier, and some people
have even misguidedly recommended use of ``--playlist`` with untrusted
sources. Do NOT use ``--playlist`` with random internet sources or files
you do not trust!
- FIXME: This needs to be clarified and documented thoroughly.
+ The main problem is that playlists can point to arbitrary network
+ addresses (including local addresses inside of your LAN), and thus
+ can't be considered secure. Playlists also can contain entries using
+ other protocols, such as local files, or (most severely), special
+ protocols like ``avdevice://``, which are inherently unsafe.
``--priority=<prio>``
(Windows only.)