From ed10c6397cc27ad161c7fcd5242c38efd89dc5ee Mon Sep 17 00:00:00 2001 From: fche Date: Wed, 28 Sep 2005 21:23:12 +0000 Subject: 2005-09-28 Frank Ch. Eigler PR 1182. * main.cxx (main): Support -D macro-setting option. * stap.1.in: Document it and related macros. * buildrun.cxx (compile_pass): Emit macro definitions. * translate.cxx (translate_pass): Guard limit macros with #ifdef. Eliminate MAXCONCURRENCY macro. * elaborate.h (systemtap_session): Add "macros" field. * parse.cxx (parse_if_statement): Clear "elseblock" if needed. 2005-09-28 Frank Ch. Eigler PR 1182. * systemtap.samples/control_limits.*: New test. --- stap.1.in | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) (limited to 'stap.1.in') diff --git a/stap.1.in b/stap.1.in index 0a0fb33d..b6922108 100644 --- a/stap.1.in +++ b/stap.1.in @@ -100,6 +100,10 @@ section for details. Add the given directory to the tapset search directory. See the description of pass 2 for details. .TP +.BI \-D " NAME=VALUE" +Add the given preprocessor directive to the module Makefile. These can +be used to override limit parameters described below. +.TP .BI \-R " DIR" Look for the systemtap runtime sources in the given directory. .TP @@ -471,7 +475,6 @@ See the .IR stapex (5) manual page for a collection of samples. - .SH SAFETY AND SECURITY Systemtap is an administrative tool. It exposes kernel internal data structures and potentially private user information. It acquires root @@ -496,6 +499,28 @@ kernel. Use of script global variables is suitably locked to protect against manipulation by concurrent probe handlers. Use of guru mode constructs such as embedded C can violate these constraints, leading to kernel crash or data corruption. +.PP +The resource use limits are set by macros in the generated C code. +These may be overridden with the +.R -D +flag. A selection of these is as follows: +.TP +MAXNESTING +Maximum number of recursive function call levels. +.TP +MAXSTRINGLEN +Maximum length of strings. +.TP +MAXTRYLOCK +Maximum number of iterations to wait for locks on global variables +before declaring possible deadlock. +.TP +MAXACTION +Maximum number of statements to execute during any single probe hit. +.TP +MAXMAPENTRIES +Maximum number of rows in any single global array. + .PP In case something goes wrong with .IR stap " or " stpd -- cgit