# Leak-utils README

This is a collection of leaky utilities for the purpose of testing. These could
be used for testing things like for example, some automation's response to a
program growing in memory usage, or a monitoring tool for leaked file
descriptors.

## Utilities

### fdleak

The `fdleak` utility leaks dead file descriptors. At runtime, it opens the
specified number of files, not closing any of them, and deletes (unlinks) the
files on disk while keeping the file descriptor open, leaving a dead file
descriptor behind. Pressing `Ctrl + c` causes the program to clean up after
itself.

### balloon

The `balloon` utility balloons up quickly in memory usage to the specified
maximum and stays at that much memory usage until `Ctrl + c` is pressed, at
which point it frees the used memory and exits.

### memleak

The `memleak` utility is a bit more dangerous than the others. It reserves
memory at the specified rate (eg: 10 MB per second), with no upper limit. If
left to continue running, it can crash your system, so be careful with this
one.