From 0f02aa7ae8f49cf1aee0f49a02f0095625a244a6 Mon Sep 17 00:00:00 2001 From: jistone Date: Tue, 17 Jan 2006 19:51:23 +0000 Subject: 2006-01-17 Josh Stone * stap.1.in: Document the 'delete' operator. --- ChangeLog | 4 ++++ stap.1.in | 12 ++++++++++++ 2 files changed, 16 insertions(+) diff --git a/ChangeLog b/ChangeLog index 94128a63..41105f14 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2006-01-17 Josh Stone + + * stap.1.in: Document the 'delete' operator. + 2006-01-16 Roland McGrath * systemtap.spec.in (elfutils_version): Require 0.119 now. diff --git a/stap.1.in b/stap.1.in index 69c1e6d2..d37060eb 100644 --- a/stap.1.in +++ b/stap.1.in @@ -294,6 +294,18 @@ function will have a special "unknown" type with no return value. .TP .BR next Return now from enclosing probe handler. +.TP +.BR delete " ARRAY[INDEX1, INDEX2, ...]" +Remove from ARRAY the element specified by the index tuple. The value will no +longer be available, and subsequent iterations will not report the element. +It is not an error to delete an element that does not exist. +.TP +.BR delete " ARRAY" +Remove all elements from ARRAY. +.TP +.BR delete " SCALAR" +Removes the value of SCALAR. Integers and strings are cleared to 0 and "" +respectively, while statistics are reset to the initial empty state. .SS EXPRESSIONS Systemtap supports a number of operators that have the same general syntax, -- cgit