Browse Source

doc/protocols: document HTTP protocol cookie support

Signed-off-by: Stefano Sabatini <stefasab@gmail.com>
Micah Galizia 12 years ago
parent
commit
10315b1cb8
1 changed files with 19 additions and 0 deletions
  1. 19 0
      doc/protocols.texi

+ 19 - 0
doc/protocols.texi

@@ -164,8 +164,27 @@ not specified.
 
 
 @item mime_type
 @item mime_type
 Set MIME type.
 Set MIME type.
+
+@item cookies
+Set the cookies to be sent in future requests. The format of each cookie is the
+same as the value of a Set-Cookie HTTP response field. Multiple cookies can be
+delimited by a newline character.
 @end table
 @end table
 
 
+@subsection HTTP Cookies
+
+Some HTTP requests will be denied unless cookie values are passed in with the
+request. The @option{cookies} option allows these cookies to be specified. At
+the very least, each cookie must specify a value along with a path and domain.
+HTTP requests that match both the domain and path will automatically include the
+cookie value in the HTTP Cookie header field. Multiple cookies can be delimited
+by a newline.
+
+The required syntax to play a stream specifying a cookie is:
+@example
+ffplay -cookies "nlqptid=nltid=tsn; path=/; domain=somedomain.com;" http://somedomain.com/somestream.m3u8
+@end example
+
 @section mmst
 @section mmst
 
 
 MMS (Microsoft Media Server) protocol over TCP.
 MMS (Microsoft Media Server) protocol over TCP.