From c0684a0d75e6ec2dba9fd8608140681bbebf39cc Mon Sep 17 00:00:00 2001 From: Mathieu Desnoyers Date: Wed, 21 May 2014 12:10:24 -0400 Subject: [PATCH] Doc: document tracefile max size discarded event limitation Signed-off-by: Mathieu Desnoyers Signed-off-by: David Goulet --- doc/man/lttng.1 | 2 ++ src/bin/lttng/commands/enable_channels.c | 2 ++ 2 files changed, 4 insertions(+) diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 627ab9c95..483df2aef 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -442,6 +442,8 @@ Use shared buffer for the whole system (\-k only) .BR "\-C, \-\-tracefile-size SIZE" Maximum size of each tracefile within a stream (in bytes). 0 means unlimited. (default: 0) +Note: traces generated with this option may inaccurately report +discarded events as per CTF 1.8. .TP .BR "\-W, \-\-tracefile-count COUNT" Used in conjunction with \-C option, this will limit the number of files diff --git a/src/bin/lttng/commands/enable_channels.c b/src/bin/lttng/commands/enable_channels.c index 55fbae644..4a1de2c66 100644 --- a/src/bin/lttng/commands/enable_channels.c +++ b/src/bin/lttng/commands/enable_channels.c @@ -136,6 +136,8 @@ static void usage(FILE *ofp) fprintf(ofp, " -C, --tracefile-size SIZE\n"); fprintf(ofp, " Maximum size of each tracefile within a stream (in bytes). 0 means unlimited.\n"); fprintf(ofp, " (default: %u)\n", DEFAULT_CHANNEL_TRACEFILE_SIZE); + fprintf(ofp, " Note: traces generated with this option may inaccurately report\n"); + fprintf(ofp, " discarded events as per CTF 1.8.\n"); fprintf(ofp, " -W, --tracefile-count COUNT\n"); fprintf(ofp, " Used in conjunction with -C option, this will limit the number\n"); fprintf(ofp, " of files created to the specified count. 0 means unlimited.\n"); -- 2.34.1