NAME

     udpSrc - UDP Source Object



SYNOPSIS

     udpSrc prefix ?options?



DESCRIPTION

     The udpSrc command creates a new udp source object, used  to
     transmit   data  using  the  UDP  protocol.   This  protocol
     transmits scatter buffers to a  udpDest  object,  using  UDP
     data for the transmission.

     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 udpSrc named object.

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


          -burstSize
               Ideal size of each burst, in  bytes.   The  udpSrc
               will  try  to  send  this much data at each burst,
               sleeping between bursts.

          -bandwidth
               The  average  bandwidth  to  send,  in  bytes  per
               second.   This  parameter  is  used in conjunction
               with the burstSize to determine how often data  is
               transmitted.

          -dest
               Where to find the corresponding udpDest object  to
               send the data to.  This option, unlike the others,
               takes two arguments, a hostname and a port number.

          -priorityGroup
               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.



  object addBuffers scatter-buffer-list
     Adds a list of scatter buffers to the queue of buffers to be
     sent.


DATA PASSING

     The udpSource object obeys the  CMT  semantics  for  passing
     data  between objects.  To summarize, you can set the output
     function of another object to be the  string  @object.accept
     where object is the name of a udpSrc object.  Then data pro-
     duced by the other object will automatically  be  handed  to
     the udpSrc and sent to the udpDest.



KEYWORDS

     packet, network



SEE ALSO

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



AUTHOR

     Brian Smith (bsmith@cs.cornell.edu)