- * 1) Declare the mapping between loglevel names and an integer values
- * within TRACEPOINT_LOGLEVEL_ENUM, using TP_LOGLEVEL for each tuple.
- * Do _NOT_ add comma (,) nor semicolon (;) between the
- * TRACEPOINT_LOGLEVEL_ENUM entries. Do _NOT_ add comma (,) nor
- * semicolon (;) after the TRACEPOINT_LOGLEVEL_ENUM declaration. The
- * name should be a proper C99 identifier.
- *
- * TRACEPOINT_LOGLEVEL_ENUM(
- * TP_LOGLEVEL( < loglevel_name >, < value > )
- * TP_LOGLEVEL( < loglevel_name >, < value > )
- * ...
- * )
- *
- * e.g.:
- *
- * TRACEPOINT_LOGLEVEL_ENUM(
- * TP_LOGLEVEL(LOG_EMERG, 0)
- * TP_LOGLEVEL(LOG_ALERT, 1)
- * TP_LOGLEVEL(LOG_CRIT, 2)
- * TP_LOGLEVEL(LOG_ERR, 3)
- * TP_LOGLEVEL(LOG_WARNING, 4)
- * TP_LOGLEVEL(LOG_NOTICE, 5)
- * TP_LOGLEVEL(LOG_INFO, 6)
- * TP_LOGLEVEL(LOG_DEBUG, 7)
- * )
- *
- * 2) Then, declare tracepoint loglevels for tracepoints. A
- * TRACEPOINT_EVENT should be declared prior to the the
- * TRACEPOINT_LOGLEVEL for a given tracepoint name. The first field
- * is the name of the tracepoint, the second field is the loglevel
- * name.
+ * 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)
+ *
+ * Declare tracepoint loglevels for tracepoints. A TRACEPOINT_EVENT
+ * should be declared prior to the the TRACEPOINT_LOGLEVEL for a given
+ * tracepoint name. The first field is the name of the tracepoint, the
+ * second field is the loglevel name.