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)