aboutsummaryrefslogtreecommitdiff
path: root/Documentation/trace-cmd/trace-cmd-listen.1.txt
blob: 7c6093ba53546abfc12812d9eb8e1e2015f3b9b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
TRACE-CMD-LISTEN(1)
===================

NAME
----
trace-cmd-listen - listen for incoming connection to record tracing.

SYNOPSIS
--------
*trace-cmd listen* -p 'port' ['OPTIONS']

DESCRIPTION
-----------
The trace-cmd(1) listen sets up a port to listen to waiting for connections
from other hosts that run 'trace-cmd-record(1)' with the *-N* option. When a
connection is made, and the remote host sends data, it will create a file
called 'trace.HOST:PORT.dat'. Where HOST is the name of the remote host, and
PORT is the port that the remote host used to connect with.

OPTIONS
-------
*-p* 'port'::
    This option will specify the port to listen to.

*-D*::
    This options causes trace-cmd listen to go into a daemon mode and run in
    the background.

*-V*::
    Listen on a vsocket instead. This is useful for tracing between host and
    guest VMs.

*-d* 'dir'::
    This option specifies a directory to write the data files into.

*-o* 'filename'::
    This option overrides the default 'trace' in the 'trace.HOST:PORT.dat' that
    is created when a remote host connects.

*-l* 'filename'::
    This option writes the output messages to a log file instead of standard output.

*--verbose*[='level']::
     Set the log level. Supported log levels are "none", "critical", "error", "warning",
     "info", "debug", "all" or their identifiers "0", "1", "2", "3", "4", "5", "6". Setting the log
     level to specific value enables all logs from that and all previous levels.
     The level will default to "info" if one is not specified.

     Example: enable all critical, error and warning logs

      trace-cmd listen --verbose=warning

SEE ALSO
--------
trace-cmd(1), trace-cmd-record(1), trace-cmd-report(1), trace-cmd-start(1),
trace-cmd-stop(1), trace-cmd-extract(1), trace-cmd-reset(1),
trace-cmd-split(1), trace-cmd-list(1)

AUTHOR
------
Written by Steven Rostedt, <rostedt@goodmis.org>

RESOURCES
---------
https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/

COPYING
-------
Copyright \(C) 2010 Red Hat, Inc. Free use of this software is granted under
the terms of the GNU Public License (GPL).