NAME

     rtpSrc - RTP Source Object



SYNOPSIS

     rtpSrc prefix ?options?



DESCRIPTION

     The rtpSrc command creates a new RTP source object, used  to
     transmit data using the Real-Time Transport Protocol.  For a
     detailed description of the protocol,  which  is  useful  in
     understanding  the  various configuration slots and how they
     affect the behavior of the packet objects, see  [Schulzrinne
     95].

     The name of the new object (which is created by appending  a
     unique suffix to prefix) is returned.  This name is also the
     name of a Tcl command that can be used  with  the  following
     options.


OPTIONS

  object destroy
     Destroys the packet source named object.

  object configure ?-options?
     Sets configuration parameters for the  packet  source  named
     object.  Valid options are:

          -address
               The IP address packets should be  sent  to.   Only
               multicast  addresses  are currently supported, and
               they must be written in dot notation.

          -port
               The port number on which data  packets  should  be
               sent.   It should be an even number; control pack-
               ets are implicity sent and received  on  the  next
               highest port number.

          -cname
               A string to be used as the CNAME in SDES  packets.
               Default  is  username@hostname.   Can  only be set
               after address and port are set.

          -name
               A string to be used as the NAME in  SDES  packets.
               Default  is  taken  from  user's finger info.  Can
               only be set after address and port are set.

          -pg
               Specifies the priority group this object  is  part
               of.   This  is usually one of tk, audio, or video.
               By default, an object is part of the  tk  priority
               group.  Can only be set after address and port are
               set.

          -ttl
               Multicast Time-to-Live  (TTL)  in  every  outgoing
               data  and  control packet. Default is 2.  Can only
               be set after address and port are set.




INPUT

     An rtpSrc object register an atom @objName.accept so that it
     can  be the target of the out command of another object.  It
     takes the buffers it receives and  sends  them  out  on  the
     appropriate multicast address.



SEE ALSO

     rtpDest(l), buffer(l), cmt(l), cmwish(1), cmx(1)



REFERENCES

     [Schulzrinne 95] Henning Schulzrinne, et. al., "RTP: A Tran-
     sport   Protocol   for   Real-Time  Applications,"  Internet
     Engineering Task Force Internet-Draft, March 1995



AUTHORS

     Andrew Swan (aswan@CS.Berkeley.EDU)