Updated manual, examples, and usage with new interval and count options
diff --git a/tools/memleak_examples.txt b/tools/memleak_examples.txt
index 9861b18..f046506 100644
--- a/tools/memleak_examples.txt
+++ b/tools/memleak_examples.txt
@@ -110,26 +110,35 @@
default) are not printed. To change this threshold, use the -o switch.
By default, memleak prints its output every 5 seconds. To change this
-interval, use the -i switch.
+interval, pass the interval as a positional parameter to memleak. You can
+also control the number of times the output will be printed before exiting.
+For example:
+
+# ./memleak.py 1 10
+
+... will print the outstanding allocation statistics every second, for ten
+times, and then exit.
USAGE message:
# ./memleak.py -h
-usage: memleak.py [-h] [-p PID] [-t] [-i INTERVAL] [-a] [-o OLDER]
- [-c COMMAND] [-s SAMPLE_RATE]
+usage: memleak.py [-h] [-p PID] [-t] [-a] [-o OLDER] [-c COMMAND]
+ [-s SAMPLE_RATE]
+ [interval] [count]
Trace outstanding memory allocations that weren't freed.
Supports both user-mode allocations made with malloc/free and kernel-mode
allocations made with kmalloc/kfree.
+ interval interval in seconds to print outstanding allocations
+ count number of times to print the report before exiting
+
optional arguments:
-h, --help show this help message and exit
-p PID, --pid PID the PID to trace; if not specified, trace kernel
allocs
-t, --trace print trace messages for each alloc/free call
- -i INTERVAL, --interval INTERVAL
- interval in seconds to print outstanding allocations
-a, --show-allocs show allocation addresses and sizes as well as call
stacks
-o OLDER, --older OLDER
@@ -147,7 +156,16 @@
allocations every 5 seconds
./memleak.py -p $(pidof allocs) -t
Trace allocations and display each individual call to malloc/free
-./memleak.py -p $(pidof allocs) -a -i 10 Trace allocations and display allocated addresses, sizes, and stacks every 10 seconds for outstanding allocations ./memleak.py -c "./allocs" Run the specified command and trace its allocations ./memleak.py Trace allocations in kernel mode and display a summary of outstanding allocations every 5 seconds ./memleak.py -o 60000 Trace allocations in kernel mode and display a summary of outstanding allocations that are at least one minute (60 seconds) old
+./memleak.py -ap $(pidof allocs) 10
+ Trace allocations and display allocated addresses, sizes, and stacks
+ every 10 seconds for outstanding allocations
+./memleak.py -c "./allocs"
+ Run the specified command and trace its allocations
+./memleak.py
+ Trace allocations in kernel mode and display a summary of outstanding
+ allocations every 5 seconds
+./memleak.py -o 60000
+ Trace allocations in kernel mode and display a summary of outstanding
+ allocations that are at least one minute (60 seconds) old
./memleak.py -s 5
Trace roughly every 5th allocation, to reduce overhead
-