xref: /aosp_15_r20/external/trace-cmd/Documentation/libtracecmd/libtracecmd-log.txt (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1*58e6ee5fSAndroid Build Coastguard Workerlibtracecmd(3)
2*58e6ee5fSAndroid Build Coastguard Worker=============
3*58e6ee5fSAndroid Build Coastguard Worker
4*58e6ee5fSAndroid Build Coastguard WorkerNAME
5*58e6ee5fSAndroid Build Coastguard Worker----
6*58e6ee5fSAndroid Build Coastguard Workertracecmd_set_loglevel - Set log level of the library
7*58e6ee5fSAndroid Build Coastguard Worker
8*58e6ee5fSAndroid Build Coastguard WorkerSYNOPSIS
9*58e6ee5fSAndroid Build Coastguard Worker--------
10*58e6ee5fSAndroid Build Coastguard Worker[verse]
11*58e6ee5fSAndroid Build Coastguard Worker--
12*58e6ee5fSAndroid Build Coastguard Worker*#include <trace-cmd.h>*
13*58e6ee5fSAndroid Build Coastguard Worker
14*58e6ee5fSAndroid Build Coastguard Workerint *tracecmd_set_loglevel*(enum tep_loglevel _level_);
15*58e6ee5fSAndroid Build Coastguard Worker--
16*58e6ee5fSAndroid Build Coastguard Worker
17*58e6ee5fSAndroid Build Coastguard WorkerDESCRIPTION
18*58e6ee5fSAndroid Build Coastguard Worker-----------
19*58e6ee5fSAndroid Build Coastguard WorkerThe _tracecmd_set_loglevel()_ function sets the level of the library logs that will be printed on
20*58e6ee5fSAndroid Build Coastguard Workerthe console. See _libtraceevent(3)_ for detailed desciription of the log levels. Setting the log
21*58e6ee5fSAndroid Build Coastguard Workerlevel to specific value means that logs from the previous levels will be printed too. For example
22*58e6ee5fSAndroid Build Coastguard Worker_TEP_LOG_WARNING_ will print any logs with severity _TEP_LOG_WARNING_, _TEP_LOG_ERROR_ and
23*58e6ee5fSAndroid Build Coastguard Worker_TEP_LOG_CRITICAL_. The default log level is _TEP_LOG_CRITICAL_.  When a new level is set, it is
24*58e6ee5fSAndroid Build Coastguard Workeralso propagated to the libtracefs and libtraceevent.
25*58e6ee5fSAndroid Build Coastguard Worker
26*58e6ee5fSAndroid Build Coastguard WorkerEXAMPLE
27*58e6ee5fSAndroid Build Coastguard Worker-------
28*58e6ee5fSAndroid Build Coastguard Worker[source,c]
29*58e6ee5fSAndroid Build Coastguard Worker--
30*58e6ee5fSAndroid Build Coastguard Worker#include <trace-cmd.h>
31*58e6ee5fSAndroid Build Coastguard Worker...
32*58e6ee5fSAndroid Build Coastguard Workertracecmd_set_loglevel(TEP_LOG_ALL);
33*58e6ee5fSAndroid Build Coastguard Worker...
34*58e6ee5fSAndroid Build Coastguard Worker/* call libtracecmd, libtracefs or libtraceevent APIs and observe any logs they produce */
35*58e6ee5fSAndroid Build Coastguard Worker...
36*58e6ee5fSAndroid Build Coastguard Workertracecmd_set_loglevel(TEP_LOG_CRITICAL);
37*58e6ee5fSAndroid Build Coastguard Worker--
38*58e6ee5fSAndroid Build Coastguard Worker
39*58e6ee5fSAndroid Build Coastguard WorkerFILES
40*58e6ee5fSAndroid Build Coastguard Worker-----
41*58e6ee5fSAndroid Build Coastguard Worker[verse]
42*58e6ee5fSAndroid Build Coastguard Worker--
43*58e6ee5fSAndroid Build Coastguard Worker*trace-cmd.h*
44*58e6ee5fSAndroid Build Coastguard Worker	Header file to include in order to have access to the library APIs.
45*58e6ee5fSAndroid Build Coastguard Worker*-ltracecmd*
46*58e6ee5fSAndroid Build Coastguard Worker	Linker switch to add when building a program that uses the library.
47*58e6ee5fSAndroid Build Coastguard Worker--
48*58e6ee5fSAndroid Build Coastguard Worker
49*58e6ee5fSAndroid Build Coastguard WorkerSEE ALSO
50*58e6ee5fSAndroid Build Coastguard Worker--------
51*58e6ee5fSAndroid Build Coastguard Worker_libtracefs(3)_,
52*58e6ee5fSAndroid Build Coastguard Worker_libtraceevent(3)_,
53*58e6ee5fSAndroid Build Coastguard Worker_trace-cmd(1)_
54*58e6ee5fSAndroid Build Coastguard Worker_trace-cmd.dat(5)_
55*58e6ee5fSAndroid Build Coastguard Worker
56*58e6ee5fSAndroid Build Coastguard WorkerAUTHOR
57*58e6ee5fSAndroid Build Coastguard Worker------
58*58e6ee5fSAndroid Build Coastguard Worker[verse]
59*58e6ee5fSAndroid Build Coastguard Worker--
60*58e6ee5fSAndroid Build Coastguard Worker*Steven Rostedt* <[email protected]>
61*58e6ee5fSAndroid Build Coastguard Worker*Tzvetomir Stoyanov* <[email protected]>
62*58e6ee5fSAndroid Build Coastguard Worker--
63*58e6ee5fSAndroid Build Coastguard WorkerREPORTING BUGS
64*58e6ee5fSAndroid Build Coastguard Worker--------------
65*58e6ee5fSAndroid Build Coastguard WorkerReport bugs to  <[email protected]>
66*58e6ee5fSAndroid Build Coastguard Worker
67*58e6ee5fSAndroid Build Coastguard WorkerLICENSE
68*58e6ee5fSAndroid Build Coastguard Worker-------
69*58e6ee5fSAndroid Build Coastguard Workerlibtracecmd is Free Software licensed under the GNU LGPL 2.1
70*58e6ee5fSAndroid Build Coastguard Worker
71*58e6ee5fSAndroid Build Coastguard WorkerRESOURCES
72*58e6ee5fSAndroid Build Coastguard Worker---------
73*58e6ee5fSAndroid Build Coastguard Workerhttps://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
74*58e6ee5fSAndroid Build Coastguard Worker
75*58e6ee5fSAndroid Build Coastguard WorkerCOPYING
76*58e6ee5fSAndroid Build Coastguard Worker-------
77*58e6ee5fSAndroid Build Coastguard WorkerCopyright \(C) 2021 VMware, Inc. Free use of this software is granted under
78*58e6ee5fSAndroid Build Coastguard Workerthe terms of the GNU Public License (GPL).
79