From 4cd8aab84f4108134dbb11356c7a3f09be945823 Mon Sep 17 00:00:00 2001 From: wm4 Date: Sun, 11 May 2014 16:51:33 +0200 Subject: manpage: update --playlist entry --- DOCS/man/en/options.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index 95df1c29ed..eebddb0dff 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -1648,20 +1648,25 @@ OPTIONS file is dumped. ``--playlist=`` - 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=`` (Windows only.) -- cgit v1.2.3