PIPEMETER(1)

💖 PIPEMETER 💖

okay bestie, welcome to pipemeter, from the General Commands Manual corner of the universe. it measures the speed of data going through a pipe or a redirection, and it is lowkey iconic. ✨

🌸 NAME 🌸

pipemeter — measure speed of data going through a pipe/redirection 🚀

🎀 SYNOPSIS 🎀

pipemeter [ -alV ] [ -s size ] [ -b block_size ] [ -m max_block_size ] [
-i interval ] [ -f infile -f infile2 ] infile infile2 ...

🦋 DESCRIPTION 🦋

so here's the whole vibe: pipemeter takes input on stdin, and redirects it straight to its stdout. while it's doing that, it measures how fast the data is moving through it. no cap, that's the entire job. 💅

or, if you pass the -s parameter, it shows a progress bar while the data is piping through. and heads up — all output generated by pipemeter is written to stderr. all of it. every last bit. 🙈

while running in progress mode, pipemeter will display the ETA (Estimated Time of Arrival). when exiting, it changes that field to show the elapsed time for the program. and in rate-only mode, it just shows the elapsed time. simple as that. ⭐

note that as of pipemeter 0.8, Adaptive Block Sizing is used to speed up the movement of data through it. it will increase, or sometimes decrease, the block size in an attempt to find the one that works best for the combination of input and output. this also helps it deal better with, for instance, a temporarily busy disk. you can use -a to turn it off. 🫶

✨ OPTIONS ✨

• -s, --size size — sets the size of the input, and turns on the progress bar. 🍓
• -b, --blocksize block_size — sets the size of blocks, in bytes, to move through the program at once. default is 8192. a suffix of K means Kilobytes(x*1024) means Megabytes(x*1024*1024), and G means Gigabytes(x*1024*1024*1024). 🧚
• -m, --maxblock max_block_size — sets the maximum block size for adaptive block sizing. default is 8M. 👑
• -i, --interval interval — specify the number of seconds between updates on the speed and/or progress bar. ⏱️
• -f, --file infile — infile specifies a file to be read instead of stdin. it will also automatically turn on the progress bar if a size can be determined. multiple occurrences of -f will read the files in the order they are specified on the cmdline, and sizes will be added to each other. note that this option remains for backward compatibility — it is far simpler to just specify the input files without options. 😭
• -F, --list listfile — specifies a file to read in the list of input files from. each line is a path to a file, terminated by a newline. 📝
• -r, --report — report only mode. this causes the program to suppress outputting/calculating while running. it will print out only one line. 💀
• -a, --autooff — turn off adaptive block sizing. sometimes ABS can use insane amounts of RAM, such as when reading and writing to RAM disks. 😳
• -V, --version — prints a version number and exits. 🌈
• -l, --log — turns on logging mode. uses only newlines, no returns. 🔥

💜 AUTHOR 💜

written by Clint Byrum <cbyrum@spamaps.org>

🌟 COPYRIGHT 🌟

copyright © 2006 Clint Byrum

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

okay that's the whole page, bestie 🎀 you read all of it, you're literally the main character. this was the PIPEMETER(1) page from the General Commands Manual — go forth and measure those pipes, periodt. 💖✨🦋