X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=src%2Fbin%2Flttng%2Fcommands%2Fenable_events.c;h=45354573207cc9995106d5862e01e106526eccd1;hp=de1796ad8ed0e7fa8f6fe06d363c7ad33787e8f0;hb=9bd578f50a1e2438c40ca10789ca90d63c8f8829;hpb=8564ccbd529ed367de6a0c86f428dda64e14cf5d

diff --git a/src/bin/lttng/commands/enable_events.c b/src/bin/lttng/commands/enable_events.c
index de1796ad8..453545732 100644
--- a/src/bin/lttng/commands/enable_events.c
+++ b/src/bin/lttng/commands/enable_events.c
@@ -172,7 +172,22 @@ static void usage(FILE *ofp)
 	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, "                           is started. If the filter fails to link\n");
+	fprintf(ofp, "                           with the event within the traced domain,\n");
+	fprintf(ofp, "                           the event will be discarded. Currently,\n");
+	fprintf(ofp, "                           filter is only implemented for the user-space\n");
+	fprintf(ofp, "                           tracer.\n");
+	fprintf(ofp, "                           Expression examples:.\n");
+	fprintf(ofp, "                           \n");
+	fprintf(ofp, "                           'intfield > 500 && intfield < 503'\n");
+	fprintf(ofp, "                           '(stringfield == \"test\" || intfield != 10) && intfield > 33'\n");
+	fprintf(ofp, "                           'doublefield > 1.1 && intfield < 5.3'\n");
+	fprintf(ofp, "                           \n");
+	fprintf(ofp, "                           Wildcards are allowed at the end of strings:\n");
+	fprintf(ofp, "                           'seqfield1 == \"te*\"'\n");
+	fprintf(ofp, "                           In string literals, the escape character is '\\'.\n");
+	fprintf(ofp, "                           Use '\\*' for the '*' character, and '\\\\' for\n");
+	fprintf(ofp, "                           the '\\' character.\n");
 	fprintf(ofp, "\n");
 }