stdintoring

Name

stdintoring -- Pipe stdin to a ring buffer.

Synopsis

stdintoring --mindata=n --timeout=t ringname

DESCRIPTION

Pipes data from its standard input to a ring buffer. This provides one mechanism to send data from a non ring buffer aware data source to a ring.

OPTIONS

--mindata=n

Specifies the minimum size of the block of data stdintoring will try to get from the stdin prior to transferring it to the ring. The value n is the number of bytes of data or can be a number followed by k, m or g which multiply the numeric value by 1024, 1024*1024 and 1024*1024*1024 respectively.

This value defaults to 1m if not explicitly overridden. See also, however, the --timeout option below.

--timeout=seconds

Specifies the maximum amount of time in seconds the program will wait for for the number of bytes specified as --mindata. If by that timeout, that number of bytes is not available, any bytes that are available on stdin are read and forwarded to the ring. This ensures that latencies remain tolerable even at low data rates with large values of --mindata

EXAMPLES

The example below puts the data from several raw event files into the ring buffer simulating online data taking.

Example 1. Using stdintoring


cat ~/stagearea/complete/run10*.evt | stdintoring somering