Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RTPDUMP(1)		  BSD General Commands Manual		    RTPDUMP(1)

     rtpdump --	parse and print	RTP packets

     rtpdump [-h] [-F format] [-f infile] [-o outfile] [-t minutes] [-x	bytes]

     rtpdump reads RTP and RTCP	packets	on the given address/port, or from
     standard input by default,	and dumps a processed version to standard out-
     put.  The output is suitable as input for rtpplay(1) and rtpsend(1).  The
     IPv4 address can be specified in dotted decimal notation or as a hostname
     and defaults to	 The port number must be given as a decimal
     numbers between 1 and 65535.

     The options are as	follows:

     -F	format
	     Write the output in the given format, which is one	of the follow-
	     ing: dump,	header,	payload, ascii,	hex, rtcp, short.

	     The dump format is	a binary format	suitable as input for
	     rtpplay(1).  The generated	output file should have	a .rtp file-
	     name extension.  The file starts with

		   #!rtpplay1.0	address/port\n

	     The version number	indicates the file format version, not the
	     version of	RTP tools used to generate the file.  The current file
	     format version is 1.0.  This is followed by one RD_hdr_t header
	     and one RD_packet_t structure for each received packet.  All
	     fields are	in network byte	order.	The RTP	and RTCP packets are
	     recorded as-is.  The structures are as follows:

	     typedef struct {
	       struct timeval start; /*	start of recording (GMT) */
	       uint32_t	source;	       /* network source (multicast) */
	       uint16_t	port;	       /* UDP port */
	     } RD_hdr_t;

	     typedef struct {
	       uint16_t	length;	/* length of original packet, including	header */
	       uint16_t	plen;	/* actual header+payload length	for RTP, 0 for RTCP */
	       uint32_t	offset;	/* ms since the	start of recording */
	     } RD_packet_t;

	     The header	format is like dump, but does not save the audio/video
	     payload.  The payload format only saves the audio/video payload.

	     The ascii format, which is	the default, saves text	parsed pack-
	     ets, suitable for rtpsend(1).  See	below for an example.  The hex
	     format is like ascii, but with a hex dump of the payload.	The
	     rtcp format is like ascii,	but only saves RTCP packets.

	     The short format dumps RTP	or VAT data in lines such as

		   [-]time timestamp [seq]

	     where `-' indicates a set marker bit, time	is the arrival time,
	     timestamp is the RTP timestamp, and seq is	the RTP	sequence num-
	     ber (only used for	RTP packets).

     -f	infile
	     Read packets from infile instead of from the network or from
	     standard input.  The file must have been recorded using the dump

     -h	     Print a short usage summary and exit.

     -o	outfile
	     Dump to outfile instead of	to standard output.

     -t	minutes
	     Only listen for the first minutes.

     -x	bytes
	     Process only the first number of bytes of the payload.  This is
	     only applicable for the dump and hex formats.

     $ rtpdump -F ascii	/1234
     844525628.240592 RTP len=176 from= v=2 p=0 x=0 cc=0 m=0 pt=5 (IDVI,1,8000) seq=28178 ts=954052737 ssrc=0x124e2b58

     $ rtpdump -F rtcp /1234
     844525628.243123 RTCP len=128 from=
      (RR ssrc=0x125bd36f p=0 count=1 len=7
     (ssrc=bc64b658 fraction=0.503906 lost=4291428375 last_seq=308007791
       jit=17987961 lsr=2003335488 dlsr=825440558)
      (SDES p=0	count=1	len=23
       (src=0x125bd36f CNAME="yywhy@" NAME="Michael	Baldizzi
       (NASA LeRC)" TOOL="vat-4.0a8" EMAIL="" )

     $ rtpdump -F short	/1234
     -1511433758.442892	3988999488 54553
     1511433758.480881 3988999648 54554
     1511433758.500863 3988999808 54555
     1511433758.520860 3988999968 54556
     1511433758.540872 3989000128 54557

     rtpplay(1), rtpsend(1)

     rtpdump was written by Henning Schulzrinne	<>, with
     enhancements by Ping Pan and Akira	Tsukamoto <>.

BSD			       November	23, 2017			   BSD


Want to link to this manual page? Use this URL:

home | help