aboutsummaryrefslogtreecommitdiff
path: root/malloc/README.copr.html
diff options
context:
space:
mode:
authorDJ Delorie <dj@delorie.com>2016-07-11 20:50:34 -0400
committerDJ Delorie <dj@delorie.com>2016-07-12 22:00:44 -0400
commitb856f645a2f58a3e224976167b4b1fb030d7967b (patch)
treec15f3ce4b4d8b2f99babaae0481c601786eb452a /malloc/README.copr.html
parente4cff5fd83963c426e3015d3595dfc69a63f1aca (diff)
downloadglibc-b856f645a2f58a3e224976167b4b1fb030d7967b.tar.xz
glibc-b856f645a2f58a3e224976167b4b1fb030d7967b.zip
Update to new binary file-based trace file.
In order to not lose records, or need to guess ahead of time how many records you need, this switches to a mmap'd file for the trace buffer, and grows it as needed. The trace2dat perl script is replaced with a trace2wl C++ program that runs a lot faster and can handle the binary format.
Diffstat (limited to 'malloc/README.copr.html')
-rw-r--r--malloc/README.copr.html34
1 files changed, 10 insertions, 24 deletions
diff --git a/malloc/README.copr.html b/malloc/README.copr.html
index 00a0e59b04..543758cf64 100644
--- a/malloc/README.copr.html
+++ b/malloc/README.copr.html
@@ -74,28 +74,14 @@ I don't support, but you never know...</p>
<pre>
$ <b>ls -l /tmp/mtrace-*</b>
--rw-r--r--. 1 root root 12422 Jun 2 20:53 mtrace-1188.out
+-rw-r--r--. 1 root root 12422 Jun 2 20:53 mtrace.out.1188
</pre>
-<p>Each generated file is a plain ASCII text file, with some headers
- followed by one line per trace record entry. The syntax is not
- "official" but intended to be machine-readable, and some scripts are
- included in the COPR repo to process the generated files.</p>
-
-<pre>
-$ <b>head -1 /tmp/mtrace-1188.out</b>
-158 out of 1000 events captured
-</pre>
-
-<p>If first number is more than the second number, then the trace only
-includes the <em>last</em> however-many records. You can specify a
-larger buffer via envirionment variables, like this:</p>
-
-<pre>
-$ <b>MTRACE_CTL_COUNT=100000 LD_PRELOAD=/lib64/libmtracectl.so ls</b>
-</pre>
-
-(again, or /lib/ for 32-bit machines)
+<p>Each generated file is a binary file, specific to the architecture,
+ with one record per trace record entry. Some programs are included
+ in the COPR repo to process the generated files. Please make sure
+ you process these files on the same architecture as they were
+ generated on.</p>
<h2>Sending Us Trace Files</h2>
@@ -105,8 +91,8 @@ it to make the file easier to transfer and keep track of.</p>
<pre>
$ <b>cd /tmp</b>
-$ <b>gzip -9 mtrace-1188.out</b>
-$ <b>mv mtrace-1188.out.gz f24-ls-fred.mtrace.gz</b> (or whatever name fits :)
+$ <b>gzip -9 mtrace.out.1188</b>
+$ <b>mv mtrace.out.1188.gz f24-ls-fred.mtrace.gz</b> (or whatever name fits :)
</pre>
<p>Then mail <tt>f24-ls-fred.mtrace.gz</tt> to dj@redhat.com (or
@@ -120,13 +106,13 @@ issues. Such workloads might be locally generated as part of a
benchmark suite, for example.</p>
<pre>
-trace2dat <em>outfile</em> [<em>infile ...</em>]
+trace2wl <em>outfile</em> [<em>infile ...</em>]
</pre>
If an infile is not provided, input is read from stdin.
<pre>
-$ trace2dat /tmp/ls.wl /tmp/mtrace-22172.out
+$ trace2wl /tmp/ls.wl /tmp/mtrace-22172.out
</pre>
The resulting file is a "workload" - a data file that tells the