xref: /aosp_15_r20/external/trace-cmd/Documentation/libtracecmd/libtracecmd-log.txt (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1libtracecmd(3)
2=============
3
4NAME
5----
6tracecmd_set_loglevel - Set log level of the library
7
8SYNOPSIS
9--------
10[verse]
11--
12*#include <trace-cmd.h>*
13
14int *tracecmd_set_loglevel*(enum tep_loglevel _level_);
15--
16
17DESCRIPTION
18-----------
19The _tracecmd_set_loglevel()_ function sets the level of the library logs that will be printed on
20the console. See _libtraceevent(3)_ for detailed desciription 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 libtracefs and libtraceevent.
25
26EXAMPLE
27-------
28[source,c]
29--
30#include <trace-cmd.h>
31...
32tracecmd_set_loglevel(TEP_LOG_ALL);
33...
34/* call libtracecmd, libtracefs or libtraceevent APIs and observe any logs they produce */
35...
36tracecmd_set_loglevel(TEP_LOG_CRITICAL);
37--
38
39FILES
40-----
41[verse]
42--
43*trace-cmd.h*
44	Header file to include in order to have access to the library APIs.
45*-ltracecmd*
46	Linker switch to add when building a program that uses the library.
47--
48
49SEE ALSO
50--------
51_libtracefs(3)_,
52_libtraceevent(3)_,
53_trace-cmd(1)_
54_trace-cmd.dat(5)_
55
56AUTHOR
57------
58[verse]
59--
60*Steven Rostedt* <[email protected]>
61*Tzvetomir Stoyanov* <[email protected]>
62--
63REPORTING BUGS
64--------------
65Report bugs to  <[email protected]>
66
67LICENSE
68-------
69libtracecmd is Free Software licensed under the GNU LGPL 2.1
70
71RESOURCES
72---------
73https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
74
75COPYING
76-------
77Copyright \(C) 2021 VMware, Inc. Free use of this software is granted under
78the terms of the GNU Public License (GPL).
79