From 919e300c183678cbaafaa473e9687afeb80995c9 Mon Sep 17 00:00:00 2001 From: Mathieu Desnoyers Date: Fri, 13 Jul 2012 14:27:03 -0400 Subject: [PATCH] Document filter usage Signed-off-by: Mathieu Desnoyers --- doc/man/lttng.1 | 7 +++++++ src/bin/lttng/commands/enable_events.c | 5 +++++ 2 files changed, 12 insertions(+) diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 6bbf3154e..417f799c4 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -340,6 +340,13 @@ file. Enabling syscalls tracing (kernel tracer), you will not be able to disable them with disable-event. This is a known limitation. You can disable the entire channel to do the trick. +\-\-filter 'expression' + Set a filter on a newly enabled event. + Filter expression on event fields event recording + depends on evaluation. Only specify on first activation + of a given event within a session. Filter only allowed + when enabling events within a session before tracing is + started. .fi .IP "\fBdisable-channel\fP NAME[,NAME2,...] [\-k|\-u] [OPTIONS]" diff --git a/src/bin/lttng/commands/enable_events.c b/src/bin/lttng/commands/enable_events.c index 3f304a090..de1796ad8 100644 --- a/src/bin/lttng/commands/enable_events.c +++ b/src/bin/lttng/commands/enable_events.c @@ -168,6 +168,11 @@ static void usage(FILE *ofp) fprintf(ofp, " --filter \'expression\'\n"); fprintf(ofp, " Filter expression on event fields,\n"); fprintf(ofp, " event recording depends on evaluation.\n"); + fprintf(ofp, " Only specify on first activation of\n"); + fprintf(ofp, " a given event within a session.\n"); + fprintf(ofp, " Filter only allowed when enabling\n"); + fprintf(ofp, " events within a session before tracing\n"); + fprintf(ofp, " is started.\n"); fprintf(ofp, "\n"); } -- 2.34.1