mbuffer [options]

mbuffer buffers i/o operations and displays the throughput rate. It is multithreaded, supports network connections, and offers more options than the standard buffer.

-i <filename>

use filename as input instead of the standard input (needs to be given for multi volume support)

-I <port>

use network port port as input instead of the standard input. If given a hostname and a port in the form hostname:port the first interface with the IP of hostname will be used.

-o <filename>

use filename as output instead of the standard output (needs to be given for multi volume support, will enable use of sendfile if available)

-O <hostname:port>

write output to hostname:port instead of the standard output (will enable use of sendfile if available)

-b <num>

use num blocks for buffer (default 256)

-s <size>

use blocks of size bytes for buffer (default 10240)

-m <size>

use a total of size bytes for buffer (default 2MB) - size can be set with a trailing charakter (b and B for Byte, k for kByte, M for MByte, G for Gigabyte, and with % for a percentage of total physical memory

-Llock buffer in memory - this option is not available for file-based buffers and requires mbuffer to be setuid root (use with care)

-n <num>

num volumes in input device (requires use of option -i for input device specification) [currently multi volume support is EXPERIMENTAL]

-t

use a memory mapped temporaray file as buffer (use with huge buffers)

-T <file>

as -t but use file instead

-d

use blocksize of device for output (needed for some devices, slows output down)

-P <num>

start writing after the buffer has been filled to num% (default 0 - start at once)

-p <num>

start reading after the buffer has dropped below fillratio of num% (default 100 - start at once)

-l <file>

log messages to file instead of standard error output

-u <num>

pause num microseconds after each write - might increase performance on some drives with very low performace (< 1 MB/sec)

-r <rate>

Set the maximum read rate to <rate>. <rate> can be given in either Bytes, kBytes, MBytes, or GBytes per second. To do so, use an apropriate suffix (i.e. k,M,G). This options is useful if you have a tape that is capable to transfer data faster than the host can handle it. In this case you can use this option to limit the transfer rate and keep the tape running. Be aware that this is both good for your tape drive, and enhances overall performance, by avoiding tape screwing.

-R <rate>

Same as above only for setting the transfer limit for the writer.

-A <cmd>

used devices is an autoloader which uses cmd to load the next volume

-a <time>

used device is an autoloader which takes time seconds to load a new tape

-f

overwrite output file if it exists already

-c

write with synchronous data integrity support - This option forces all writes to complete before continuing. This enables errors to be reported earlier and more precisely, but might decrease performance. Especially systems with high level of data integrity support suffer a huge performance hit. Others might seem to be unaffected, but just neglect support for full synchronous data integrity.

-v <num>

set verbose level to num. Valid values are 0..5 (0 = none, 1 = errors, 2 = warnings, 4 = informations, 5 = debugging informations). Higher values include lower values messages.

-q

quiet - do not display the status on the standard error output

-h, --help

Output help information and exit.

-H, --md5

Generate md5 hash of transfered data.

-V, --version

Output version information and exit.

/bin/mbuffer /var/tmp/mbuffer-*

To run this program with the default options just type:

mbuffer

Using mbuffer to do a backup with tar to the default tape device. Options for this example: memory mapped temporary file with a size of 10 Megabytes, start after 80% of the buffer have been filled.

tar cf - mydirectory | gzip | mbuffer -t -m 10M -p 80 -f -o $TAPE

Using mbuffer with 3 tapes for input and extracting the contents in the current work directory:

mbuffer -n 3 -i $TAPE | gzip -dc | tar xf -

Using mbuffer to write to multiple tape volumes:

tar cf - /usr | mbuffer -f -o $TAPE

Write to multiple tapes and erase every tape before writing:

tar cf - /usr | mbuffer -A "echo next tape; read a < /dev/tty; mt erase $TAPE" -f -o $TAPE

Making a backup via network:

tape server: mbuffer -I 8000 -f -o $TAPE

backup client: tar zcf - /home | mbuffer -O tapeserver:8000

Thomas Maier-Komor <software@maier-komor.de>

buffer(1), gpl(7)