xref: /aosp_15_r20/external/libtracefs/Documentation/libtracefs-log.txt (revision 287e80b3a36113050663245e7f2c00d274188f18)
1libtracefs(3)
2=============
3
4NAME
5----
6tracefs_set_loglevel - Set log level of the library
7
8SYNOPSIS
9--------
10[verse]
11--
12*#include <tracefs.h>*
13
14int *tracefs_set_loglevel*(enum tep_loglevel _level_);
15--
16
17DESCRIPTION
18-----------
19The *tracefs_set_loglevel()* function sets the level of the library logs that will be printed on
20the console. See _libtraceevent(3)_ for detailed description of the log levels. Setting the log
21level to specific value means that logs from the previous levels will be printed too. For example
22_TEP_LOG_WARNING_ will print any logs with severity _TEP_LOG_WARNING_, _TEP_LOG_ERROR_ and
23_TEP_LOG_CRITICAL_. The default log level is _TEP_LOG_CRITICAL_.  When a new level is set, it is
24also propagated to the libtraceevent.
25
26EXAMPLE
27-------
28[source,c]
29--
30#include <tracefs.h>
31
32tracefs_set_loglevel(TEP_LOG_ALL);
33...
34/* call libtracefs or libtraceevent APIs and observe any logs they produce */
35...
36tracefs_set_loglevel(TEP_LOG_CRITICAL);
37--
38FILES
39-----
40[verse]
41--
42*tracefs.h*
43	Header file to include in order to have access to the library APIs.
44*-ltracefs*
45	Linker switch to add when building a program that uses the library.
46--
47
48SEE ALSO
49--------
50*libtracefs*(3),
51*libtraceevent*(3),
52*trace-cmd*(1)
53
54AUTHOR
55------
56[verse]
57--
58*Steven Rostedt* <[email protected]>
59*Tzvetomir Stoyanov* <[email protected]>
60--
61REPORTING BUGS
62--------------
63Report bugs to  <[email protected]>
64
65LICENSE
66-------
67libtracefs is Free Software licensed under the GNU LGPL 2.1
68
69RESOURCES
70---------
71https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/
72
73COPYING
74-------
75Copyright \(C) 2021 VMware, Inc. Free use of this software is granted under
76the terms of the GNU Public License (GPL).
77