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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
<?xml version="1.0"?> <!-- -*- sgml -*- -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
<refentry id="valgrind-listener">
<refmeta>
<refentrytitle>VALGRIND</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>Release &rel-version;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>valgrind-listener</refname>
<refpurpose>a simple listener program for valgrind log redirection</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>valgrind-listener</command>
<arg choice="opt"><replaceable>--exit-at-zero|-e</replaceable></arg>
<arg choice="opt"><replaceable>port-number</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="description">
<title>Description</title>
<para><command>valgrind-listener</command> is a tool to be used in
conjunction with Valgrind's ability to redirect its commentary output
to a network socket (by means of the <computeroutput>--log-socket</computeroutput>
option).</para>
<para>valgrind-listener accepts connections on the specified port and
copies whatever it is sent to stdout. It can accept simultaneous
connections from up to 50 Valgrinded processes. In front of each line
of output it prints the current number of active connections in round
brackets.</para>
<para>port-number changes the port on which to listen for connections
(default is 1500). It must be between 1024 and 65535. The same restriction
applies to port numbers specified by the <computeroutput>--log-socket</computeroutput>
option to Valgrind itself.</para>
<para>Please note that killing the listener doesn't actually kill the
processes sending data to it.</para>
</refsect1>
<refsect1 id="a-options">
<title>Options</title>
<variablelist>
<varlistentry>
<term><option>-h --help</option></term>
<listitem>
<para>Show the help message.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-e --exit-at-zero</option></term>
<listitem>
<para>Causes the listener to exit when the number of connections falls back to zero (the default is to keep listening forever).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="a-see_also">
<title>See Also</title>
<para>
valgrind(1),
<filename>&vg-docs-path;</filename> or
<filename>&vg-docs-url;</filename>.
</para>
</refsect1>
<refsect1 id="a-author">
<title>Author</title>
<para>The Valgrind developers.</para>
<para>This manual page was written by
Cristian Greco <cristian@regolo.cc>
and the Valgrind developers.</para>
</refsect1>
</refentry>
|
