msantos/prv

pressure relief valve for Unix process pipelines

SYNOPSIS

prv option

DESCRIPTION

prv: pressure relief valve for Unix process pipelines

prv flow controls standard input by sampling lines in a time window.

EXAMPLES

while :; do date; done | prv -l 1 -w 10
Fri Aug 26 00:05:45 EDT 2022
Fri Aug 26 00:05:54 EDT 2022
Fri Aug 26 00:06:04 EDT 2022
^C

BUILD

make

# build a static executable using musl
./musl-make clean all

# select a different method for process restriction
RESTRICT_PROCESS=null

# musl: enabling seccomp process restriction might require downloading a
# copy of linux kernel headers
MUSL_INCLUDE=/tmp

cd $MUSL_INCLUDE
git clone https://github.com/sabotage-linux/kernel-headers.git

./musl-make

OPTIONS

-l, --limit number : message rate limit (default: 0 (no limit))

-w, --window seconds : message rate window (default: 1 second)

-W, --write-error exit|drop|block : behaviour if write buffer is full

-v, --verbose : verbose mode

-h, --help : help