From e10599ffadb4cd177581a36feb8485028c9fbf7b Mon Sep 17 00:00:00 2001 From: Kent Sebastian Date: Fri, 10 Oct 2008 16:03:35 -0400 Subject: Added cache limiting info to man page and NEWS. --- NEWS | 6 ++++++ stap.1.in | 8 +++++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index 7e737d47..e8cca3a6 100644 --- a/NEWS +++ b/NEWS @@ -88,6 +88,12 @@ but is for some reason unavailable.) In return probes only, $$return expands to an empty string for a void function, or "return=0xf00". +- Cache limiting is now available. If the cache is over a specified limit, + cached modules/sources are unlinked until the total cache size is below + the limit. + + See stap(1) for use. + * What's new in version 0.7 - .statement("func@file:*") and .statement("func@file:M-N") probes are now diff --git a/stap.1.in b/stap.1.in index 0546d022..b7c116ca 100644 --- a/stap.1.in +++ b/stap.1.in @@ -865,7 +865,13 @@ script is translated again assuming the same conditions exist (same kernel version, same systemtap version, etc.). Cached files are stored in the .I $SYSTEMTAP_DIR/cache -directory, which may be periodically cleaned/erased by the user. +directory. The cache can be limited by having the file +.I cache_mb_limit +placed in the cache directory (shown above) containing only an ASCII +integer representing how many MiB the cache should not exceed. Note that +this is a 'soft' limit in that the cache will be cleaned after a new entry +is added, so the cache size may temporarily exceed this limit. In the +absence of this file, cache cleaning is up to the user. .SH SAFETY AND SECURITY Systemtap is an administrative tool. It exposes kernel internal data -- cgit