From: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Date: Thu, 16 Feb 2012 18:51:54 +0000 (-0500)
Subject: Add loglevel info to manpage
X-Git-Tag: v1.9.8~2
X-Git-Url: http://git.liburcu.org/?a=commitdiff_plain;h=5883c06f920f1ab4bd21806a364bc8e59a6f441e;p=lttng-ust.git

Add loglevel info to manpage

Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
---

diff --git a/doc/man/lttng-ust.3 b/doc/man/lttng-ust.3
index 49b3b5d5..6bbfc96c 100644
--- a/doc/man/lttng-ust.3
+++ b/doc/man/lttng-ust.3
@@ -150,6 +150,79 @@ TRACEPOINT_EVENT(
 )
 .fi
 
+.SH "ASSIGNING LOGLEVEL TO EVENTS"
+
+.nf
+
+Optionally, a loglevel can be assigned to a TRACEPOINT_EVENT using the
+following construct:
+
+	TRACEPOINT_LOGLEVEL(< [com_company_]project[_component] >,
+		< event >, < loglevel_name >)
+
+ The first field is the provider name, the second field is the name of
+the tracepoint, and the third field is the loglevel name.  A
+TRACEPOINT_EVENT should be declared prior to the the TRACEPOINT_LOGLEVEL
+for a given tracepoint name. The TRACEPOINT_PROVIDER must be already
+declared before declaring a TRACEPOINT_LOGLEVEL.
+
+The loglevels go from 0 to 14. Higher numbers imply the most verbosity
+(higher event throughput expected.
+  
+Loglevels 0 through 6, and loglevel 14, match syslog(3) loglevels
+semantic. Loglevels 7 through 13 offer more fine-grained selection of
+debug information.
+  
+   TRACE_EMERG           0
+   system is unusable
+  
+   TRACE_ALERT           1
+   action must be taken immediately
+  
+   TRACE_CRIT            2
+   critical conditions
+  
+   TRACE_ERR             3
+   error conditions
+  
+   TRACE_WARNING         4
+   warning conditions
+  
+   TRACE_NOTICE          5
+   normal, but significant, condition
+  
+   TRACE_INFO            6
+   informational message
+  
+   TRACE_DEBUG_SYSTEM    7
+   debug information with system-level scope (set of programs)
+  
+   TRACE_DEBUG_PROGRAM   8
+   debug information with program-level scope (set of processes)
+  
+   TRACE_DEBUG_PROCESS   9
+   debug information with process-level scope (set of modules)
+  
+   TRACE_DEBUG_MODULE    10
+   debug information with module (executable/library) scope (set of
+   units)
+  
+   TRACE_DEBUG_UNIT      11
+   debug information with compilation unit scope (set of functions)
+  
+   TRACE_DEBUG_FUNCTION  12
+   debug information with function-level scope
+  
+   TRACE_DEBUG_LINE      13
+   debug information with line-level scope (TRACEPOINT_EVENT default)
+  
+   TRACE_DEBUG           14
+   debug-level message (trace_printf default)
+
+See lttng(1) for information on how to use LTTng-UST loglevels.
+
+.fi
+
 .SH "ADDING TRACEPOINTS TO YOUR CODE"
 
 .nf