xref: /aosp_15_r20/external/trace-cmd/Documentation/trace-cmd/trace-cmd-agent.1.txt (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1TRACE-CMD-AGENT(1)
2==================
3
4NAME
5----
6trace-cmd-agent - Run as an agent on a machine (to be controlled by another machine)
7
8SYNOPSIS
9--------
10*trace-cmd agent* ['OPTIONS']
11
12DESCRIPTION
13-----------
14The trace-cmd(1) agent listens over a vsocket (for virtual machines) or a TCP port
15for connections to control the tracing of the machine. The agent will then start
16tracing on the local machine and pass the data to the controlling connection.
17
18OPTIONS
19-------
20*-N* 'client'::
21    Listen over TCP instead of a vsocket. Must pass in a client host name or IP address
22    to allow connection to. It will only connect to the specified client. Note, any process
23    on that client can control the agent.
24
25    *This is a very insecure setting. Only use on a trusted network*
26    *Only use if the client machine is totally trusted*
27
28*-p* 'port'::
29    This option will specify the port to listen to.
30
31*-D*::
32    This options causes trace-cmd agent to go into a daemon mode and run in
33    the background.
34
35*--verbose*[='level']::
36     Set the log level. Supported log levels are "none", "critical", "error", "warning",
37     "info", "debug", "all" or their identifiers "0", "1", "2", "3", "4", "5", "6". Setting the log
38     level to specific value enables all logs from that and all previous levels.
39     The level will default to "info" if one is not specified.
40
41     Example: enable all critical, error and warning logs
42
43      trace-cmd listen --verbose=warning
44
45SEE ALSO
46--------
47trace-cmd(1), trace-cmd-record(1), trace-cmd-report(1), trace-cmd-start(1),
48trace-cmd-stop(1), trace-cmd-extract(1), trace-cmd-reset(1),
49trace-cmd-split(1), trace-cmd-list(1)
50
51AUTHOR
52------
53Written by Steven Rostedt, <[email protected]>
54
55RESOURCES
56---------
57https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
58
59COPYING
60-------
61Copyright \(C) 2010 Red Hat, Inc. Free use of this software is granted under
62the terms of the GNU Public License (GPL).
63