Linux-Trace-Devel Archive on
 help / color / Atom feed
* [PATCH] trace-cmd: Man page for trace-cmd agent
@ 2020-01-29 12:05 Tzvetomir Stoyanov (VMware)
  0 siblings, 0 replies; only message in thread
From: Tzvetomir Stoyanov (VMware) @ 2020-01-29 12:05 UTC (permalink / raw)
  To: rostedt; +Cc: linux-trace-devel

A man page, describing trace-cmd agent sub command.

Signed-off-by: Tzvetomir Stoyanov (VMware) <>
 Documentation/trace-cmd-agent.1.txt | 75 +++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 Documentation/trace-cmd-agent.1.txt

diff --git a/Documentation/trace-cmd-agent.1.txt b/Documentation/trace-cmd-agent.1.txt
new file mode 100644
index 0000000..a803d36
--- /dev/null
+++ b/Documentation/trace-cmd-agent.1.txt
@@ -0,0 +1,75 @@
+trace-cmd-agent - run trace-cmd in an agent mode
+*trace-cmd agent* ['OPTIONS']
+The trace-cmd(1) can be used to gather simultaneously tracing information from
+host and guests virtual machines, running on that host. The trace-cmd(1) agent
+runs in the guest context, listening for incoming tracing requests from
+the host. When a request is received, the agent starts the tracing, reads the
+tracing data and streams them to the host. The host gathers tracing data from
+all guests and stores it in trace.dat files, one for each guest.
+The communication between host and guest is through VSOCKs, so the OS must
+support for it.
+*-p* 'port'::
+    Listen for incoming tracing requests on the specified port. The option is
+    not mandatory, by default the agent listens on port 823.
+    Run the agent in daemon mode.
+    Run the agent in debug mode:
+       - no fork(), the tracing is performed in the main process
+       - no timeout when waiting for an incoming control message, wait forever
+       - print information about every sent and received control messages
+Run the agent on the guest:
+ # trace-cmd agend -D
+Run the tracing on the host for kvm and sched events and reguest guest tracing
+for all events. The guest is addressed by its name, GuestName in this example:
+# trace-cmd record -e kvm -e sched -A GuestName -e all
+As a result of this tracing session, two trace files will be generated:
+trace.dat - host tracing data
+trace-GuestName.dat - guest tracing data
+trace-cmd(1), trace-cmd-record(1), trace-cmd-listen(1)
+Written by Steven Rostedt, <>
+Copyright \(C) 2010 Red Hat, Inc. Free use of this software is granted under
+the terms of the GNU Public License (GPL).

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, back to index

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-01-29 12:05 [PATCH] trace-cmd: Man page for trace-cmd agent Tzvetomir Stoyanov (VMware)

Linux-Trace-Devel Archive on

Archives are clonable:
	git clone --mirror linux-trace-devel/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-trace-devel linux-trace-devel/ \
	public-inbox-index linux-trace-devel

Example config snippet for mirrors

Newsgroup available over NNTP:

AGPL code for this site: git clone