Skip to content
Tom Barbette edited this page Oct 3, 2018 · 2 revisions

SimpleQueue Element Documentation

NAME

SimpleQueue — Click element; stores packets in a FIFO queue

SYNOPSIS

SimpleQueue
SimpleQueue(CAPACITY)

Batching: Batching natively supported
Ports: 1 input, 1-2 outputs

DESCRIPTION

Stores incoming packets in a first-in-first-out queue. Drops incoming packets if the queue already holds CAPACITY packets. The default for CAPACITY is 1000.

Multithreaded Click note: SimpleQueue is designed to be used in an environment with at most one concurrent pusher and at most one concurrent puller. Thus, at most one thread pushes to the SimpleQueue at a time and at most one thread pulls from the SimpleQueue at a time. Different threads can push to and pull from the SimpleQueue concurrently, however. See ThreadSafeQueue for a queue that can support multiple concurrent pushers and pullers.

NOTES

The Queue and NotifierQueue elements act like SimpleQueue, but additionally notify interested parties when they change state (from nonempty to empty or vice versa, and/or from nonfull to full or vice versa).

ELEMENT HANDLERS

  • length (read-only) — Returns the current number of packets in the queue.
  • highwater_length (read-only) — Returns the maximum number of packets that have ever been in the queue at once.
  • capacity (read/write) — Returns or sets the queue's capacity.
  • drops (read-only) — Returns the number of packets dropped by the queue so far. Dropped packets are emitted on output 1 if output 1 exists.
  • reset_counts (write-only) — When written, resets the drops and highwater_length counters.
  • reset (write-only) — When written, drops all packets in the queue.

SEE ALSO

Queue, NotifierQueue, MixedQueue, RED, FrontDropQueue, ThreadSafeQueue

Generated by click-elem2man from ../elements/standard/simplequeue.hh:8 on 2018/10/03.

Clone this wiki locally