RatedSource Element Documentation

RatedSource -- Click element; generates packets at specified rate

RatedSource([DATA, RATE, LIMIT, ACTIVE, KEYWORDS])

Ports: no inputs, 1 output
Processing: agnostic
Package: standard (core)

Creates packets consisting of DATA, emitting at most LIMIT such packets out its single output at a rate of RATE packets per second. When used as a push element, RatedSource will send a maximum of one packet per scheduling, so very high RATEs may not be achievable. If LIMIT is negative, sends packets forever. Will send packets only if ACTIVE is true. Default DATA is at least 64 bytes long. Default RATE is 10. Default LIMIT is -1 (send packets forever). Default ACTIVE is true. Keyword arguments are:

DATA

String. Same as the DATA argument.

DATASIZE

Integer. If set, ensures the outgoing packet contains at least this many bytes.

RATE

Integer. Same as the RATE argument.

LIMIT

Integer. Same as the LIMIT argument.

ACTIVE

Boolean. Same as the ACTIVE? argument.

STOP

Boolean. If true, then stop the driver once LIMIT packets are sent. Default is false. To generate a particular repeatable traffic pattern, use this element's rate and active handlers in conjunction with PokeHandlers.

  RatedSource(\<0800>, 10, 1000) -> Queue -> ...

count (read-only)

Returns the total number of packets that have been generated.

reset (write-only)

Resets the number of generated packets to 0. The RatedSource will then generate another LIMIT packets (if it is active).

data (read/write)

Returns or sets the DATA parameter.

datasize (read/write)

Returns or sets the DATASIZE parameter.

rate (read/write)

Returns or sets the RATE parameter.

limit (read/write)

Returns or sets the LIMIT parameter. Negative numbers mean no limit.

active (read/write)

Makes the element active or inactive.

InfiniteSource, PokeHandlers

Generated by 'click-elem2man' from '../elements/standard/ratedsource.hh' on 24/May/2007.