NAME

rtpsend — generate RTP packets from textual description

SYNOPSIS

DESCRIPTION

rtpsend sends a stream of RTP and RTCP packets with configurable parameters. The packets are sent to the given address/port, optionally with a time-to-live value of ttl. This is intended to test the RTP features of the receiving end.

By default, rtpsend reads the packets from standard input. The RTP or RTCP headers are expected in a format written by rtpdump(1) -F ascii.

Within the input, each entry starts with a time value, in seconds, relative to the beginning. The time value must appear at the beginning of a line, without white space. Within an RTP or RTCP packet description, parameters may appear in any order, without white space around the equal sign. Lines are continued with initial white space on the next line. Comment lines start with ‘#’. Strings are enclosed in quotation marks. RTP and RTCP entries look like this:

<time> RTP
   v=<version>
   p=<padding>
   x=<extension>
   m=<marker>
   pt=<payload type>
   ts=<time stamp>
   seq=<sequence number>
   ssrc=<SSRC>
   cc=<CSRC count>
   csrc=<CSRC>
   data=<hex payload>
   ext_type=<type of extension>
   ext_len=<length of extension header>
   ext_data=<hex extension data>
   len=<packet size in bytes(including header)>

<time> RTCP (SDES v=<version>
              (src=<source> cname="..." name="...")
              (src=<source> ...)
            )
            (SR v=<version>
              ssrc=<SSRC of data source>
              p=<padding>
              count=<number of sources>
              len=<length>
              ntp=<NTP timestamp>
              psent=<packet sent>
              osent=<octets sent>
                (ssrc=<SSRC of source>
                 fraction=<loss fraction>
                 lost=<number lost>
                 last_seq=<last sequence number>
                 jit=<jitter>
                 lsr=<last SR received>
                 dlsr=<delay since last SR>
                )
            )

The options are as follows:

-a

Include a router alert IP option in RTCP packets. This is used by the YESSIR resource reservation protoccol.

-f infile

Read the packets from the given infile instead of standard input.

-h

Display a short usage summary and exit.

-l

Send the same sequence of packets again and again. This only works if the input is read from a regular file instead of the standard input. See the -f option.

-s port

Send the packets from the given port. By default, rtpsend chooses a random port.

SEE ALSO

rtpdump(1), rtpplay(1)

AUTHORS

rtpsend was written by Henning Schulzrinne <hgs@cs.columbia.edu>, with enhancements by Ping Pan and Akira Tsukamoto <akira.tsukamoto@gmail.com>.