[rtmpdump] r279 - trunk/rtmpdump.1

[hyc]

Author: hyc
Date: Thu Mar  4 07:24:14 2010
New Revision: 279

Log:
Manpage

Added:
   trunk/rtmpdump.1

Added: trunk/rtmpdump.1
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/rtmpdump.1	Thu Mar  4 07:24:14 2010	(r279)
@@ -0,0 +1,273 @@
+.TH RTMPDUMP 1 "2010-03-03" "RTMPDump v2.2"
+.SH NAME
+rtmpdump \- RTMP streaming media client
+.SH SYNOPSIS
+.B rtmpdump
+.BI \-r \ url
+[\c
+.BI \-n \ hostname\fR]
+[\c
+.BI \-c \ port\fR]
+[\c
+.BI \-l \ protocol\fR]
+[\c
+.BI \-S \ host:port\fR]
+[\c
+.BI \-a \ app\fR]
+[\c
+.BI \-t \ tcUrl\fR]
+[\c
+.BI \-p \ pageUrl\fR]
+[\c
+.BI \-s \ swfUrl\fR]
+[\c
+.BI \-f \ flashVer\fR]
+[\c
+.BI \-u \ auth\fR]
+[\c
+.BI \-C \ conndata\fR]
+[\c
+.BI \-y \ playpath\fR]
+[\c
+.BR \-v ]
+[\c
+.BI \-d \ subscription\fR]
+[\c
+.BR \-e ]
+[\c
+.BI \-k \ skip\fR]
+[\c
+.BI \-A \ start\fR]
+[\c
+.BI \-B \ stop\fR]
+[\c
+.BI \-b \ buffer\fR]
+[\c
+.BI \-m \ timeout\fR]
+[\c
+.BI \-T \ key\fR]
+[\c
+.BI \-w \ swfHash\fR]
+[\c
+.BI \-x \ swfSize\fR]
+[\c
+.BI \-W \ swfUrl\fR]
+[\c
+.BI \-X \ swfAge\fR]
+[\c
+.BI \-o \ output\fR]
+[\c
+.BR \-# ]
+[\c
+.BR \-q ]
+[\c
+.BR \-V ]
+[\c
+.BR \-z ]
+.br
+.B rtmpdump \-h
+.SH DESCRIPTION
+.B rtmpdump
+is a tool for dumping media content streamed over RTMP.
+.LP
+.B rtmpdump
+makes a connection to the specified RTMP server and plays the media
+specified by the given
+.IR url .
+The url should be of the form
+.nf
+  rtmp[e]://hostname[:port][/app[/playpath]]
+.fi
+
+Both plaintext
+.I rtmp://
+and encrypted
+.I rtmpe://
+sessions are supported.
+.SH OPTIONS
+Network Parameters
+
+These options define how to connect to the media server.
+.TP
+\fB\-\-rtmp		\-r\fP\ \fIurl\fP
+URL of the server and media content.
+.TP
+\fB\-\-host		\-n\fP\ \fIhostname\fP
+Overrides the hostname in the RTMP URL.
+.TP
+\fB\-\-port		\-c\fP\ \fIport\fP
+Overrides the port number in the RTMP URL.
+.TP
+\fB\-\-protocol	\-l\fP\ \fInumber\fP
+Overrides the protocol in the RTMP URL. 0 = rtmp, 3 = rtmpe
+.TP
+\fB\-\-socks		\-S\fP\ \fIhost:port\fP
+Use the specified SOCKS4 proxy.
+.PP
+Connection Parameters
+
+These options define the content of the RTMP Connect request packet.
+If correct values are not provided, the media server will reject the
+connection attempt.
+.TP
+\fB\-\-app		\-a\fP\ \fIapp\fP
+Name of application to connect to on the RTMP server. Overrides
+the app in the RTMP URL. Sometimes the rtmpdump URL parser cannot
+determine the app name automatically, so it must be given explicitly
+using this option.
+.TP
+\fB\-\-tcUrl		\-t\fP\ \fIurl\fP
+URL of the target stream. Defaults to rtmp[e]://host[:port]/app/playpath.
+.TP
+\fB\-\-pageUrl		\-p\fP\ \fIurl\fP
+URL of the web page in which the media was embedded.
+.TP
+\fB\-\-swfUrl		\-s\fP\ \fIurl\fP
+URL of the SWF player for the media.
+.TP
+\fB\-\-flashVer	\-f\fP\ \fIversion\fP
+Version of the Flash plugin used to run the SWF player. The
+default is "LNX 10,0,22,87".
+.TP
+\fB\-\-auth		\-a\fP\ \fIstring\fP
+An authentication string to be appended to the Connect message. Using
+this option will append a Boolean TRUE and then the specified string.
+This message format is only used by some particular servers and is
+deprecated. The more general
+.B\-\-conn
+option should be used instead.
+.TP
+\fB\-\-conn		\-C\fP\ \fItype:data\fP
+Append arbitrary AMF data to be appended to the Connect message. The type
+must be B for Boolean, N for number, S for string, O for object, or Z
+for null. For Booleans the data must be either 0 or 1 for FALSE or TRUE,
+respectively. Likewise for Objects the data must be 0 or 1 to end or
+begin an object, respectively. Data items in subobjects may be named, by
+prefixing the type with 'N' and specifying the name before the value, e.g.
+NB:myFlag:1. This option may be used multiple times to construct arbitrary
+AMF sequences. E.g.
+.nf
+  -C B:1 -C S:authMe -C O:1 -C NN:code:1.23 -C NN:flag:ok -C O:0
+.fi
+.PP
+Session Parameters
+
+These options take effect after the Connect request has succeeded.
+.TP
+\fB\-\-playpath	\-y\fP\ \fIpath\fP
+Overrides the playpath parsed from the RTMP URL. Sometimes the
+rtmpdump URL parser cannot determine the correct playpath
+automatically, so it must be given explicitly using this option.
+.TP
+.B \-\-live		\-v
+Specify that the media is a live stream. No resuming or seeking in
+live streams is possible.
+.TP
+\fB\-\-subscribe	\-d\fP\ \fIstream\fP
+Name of live stream to subscribe to. Defaults to
+.IR playpath .
+.TP
+.B \-\-resume		\-e
+Resume an incomplete RTMP download.
+.TP
+\fB\-\-skip		\-k\fP\ \fInum\fP
+Skip
+.I num
+keyframes when looking for the last keyframe from which to resume. This
+may be useful if a regular attempt to resume fails. The default is 0.
+.TP
+\fB\-\-start		\-A\fP\ \fInum\fP
+Start at
+.I num
+seconds into the stream. Not valid for live streams.
+.TP
+\fB\-\-stop		\-B\fP\ \fInum\fP
+Stop at
+.I num
+seconds into the stream.
+.TP
+\fB\-\-buffer		\-b\fP\ \fInum\fP
+Set buffer time to
+.I num
+milliseconds. The default is 36000000.
+.TP
+\fB\-\-timeout		\-m\fP\ \fInum\fP
+Timeout the session after
+.I num
+seconds without receiving any data from the server. The default is 120.
+.PP
+Security Parameters
+
+These options handle additional authentication requests from the server.
+.TP
+\fB\-\-token		\-T\fP\ \fIkey\fP
+Key for SecureToken response, used if the server requires SecureToken
+authentication.
+.TP
+\fB\-\-swfhash		\-w\fP\ \fIhexstring\fP
+SHA256 hash of the decompressed SWF file. This option may be needed if
+the server uses SWF Verification, but see the
+.B \-\-swfVfy
+option below. The hash is 32 bytes, and must be
+given in hexadecimal. The
+.B \-\-swfsize
+option must always be used with this option.
+.TP
+\fB\-\-swfsize		\-x\fP\ \fInum\fP
+Size of the decompressed SWF file. This option may be needed if the
+server uses SWF Verification, but see the
+.B \-\-swfVfy
+option below. The
+.B \-\-swfhash
+option must always be used with this option.
+.TP
+\fB\-\-swfVfy		\-W\fP\ \fIurl\fP
+URL of the SWF player for this media. This option replaces all three
+of the
+.BR \-\-swfURL ,
+.BR \-\-swfhash ,
+and
+.B \-\-swfsize
+options. When this option is used, the SWF player is retrieved from the
+specified URL and the hash and size are computed automatically. Also
+the information is cached in a
+.I .swfinfo
+file in the user's home directory, so that it doesn't need to be retrieved
+and recalculated every time rtmpdump is run. The .swfinfo file records
+the URL, the time it was fetched, the modification timestamp of the SWF
+file, its size, and its hash. By default, the cached info will be used
+for 30 days before re-checking.
+.TP
+\fB\-\-swfAge		\-X\fP\ \fIdays\fP
+Specify how many days to use the cached SWF info before re-checking. Use
+0 to always check the SWF URL. Note that if the check shows that the
+SWF file has the same modification timestamp as before, it will not be
+retrieved again.
+.PP
+Miscellaneous
+.TP
+\fB\-\-flv		\-o\fP\ \fIoutput\fP
+Specify the output file name. If the name is \- or is omitted, the
+stream is written to stdout.
+.TP
+.B \-\-hashes		\-#
+Display streaming progress with a hash mark for each 1% of progress, instead
+of a byte counter.
+.TP
+.B \-\-quiet		\-q
+Suppress all command output.
+.TP
+.B \-\-verbose		\-V
+Verbose command output.
+.TP
+.B \-\-debug		\-z
+Debug level output. Extremely verbose, including hex dumps of all packet data.
+.TP
+.B \-\-help		\-h
+Print a summary of command options.
+.SH FILES
+.TP
+.I $HOME/.swfinfo
+Cache of SWF Verification information
+.SH AUTHORS
+Andrej Stepanchuk, Howard Chu, The Flvstreamer Team