diff options
-rw-r--r-- | README.md | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..c64aa31 --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +# 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. |