ttcn3_profmerge(1)

✨ ttcn3_profmerge ✨

okay bestie, welcome to the ttcn3_profmerge(1) page from the TTCN-3 Tools manual 💖 this is the glow-up version of the docs, but every single detail is still in here, no cap.

---

🌸 NAME 🌸

ttcn3_profmerge — the TTCN-3 profiler and code coverage merge tool 🦋

---

🎀 SYNOPSIS 🎀

ttcn3_profmerge [ -pc ] [ -o file ] [ -s file ] [ -f filter ] db_file1 [
db_file2 ... ]

or

ttcn3_profmerge -v

---

💅 DESCRIPTION 💅

So this page? It's your quick reference for the TTCN-3 profmerge utility of the TTCN-3 Test Executor. Main character energy tbh 👑

The ttcn3_profmerge utility — you'll find it chilling in $TTCN3_DIR/bin — merges all the input files (aka profiler databases) you hand it in the command argument into one single output file. Iconic. And it can also generate profiler statistics from that merged database. Two talents, one binary. Slay.

Here's the tea though: since there are two possible outputs, neither of them gets written to standard output. Periodt, they both go to files.

It's super useful for test suites that are run on multiple Host Controllers (in parallel mode) 💫

---

✨ OPTIONS ✨

Here are the command line switches you can use, bestie:

• -p — Discards profiler data from the merged database. Every single execution time gets set to zero in the output database file, and stats related to execution times won't be generated. (Quick note: you can't discard both profiler and code coverage data, because then there'd be literally no data left 💀)
• -c — Discards code coverage data from the merged database. All execution counts get set to zero in the output database file, and stats related to execution counts won't be generated. (Same deal: both profiler and code coverage data cannot be discarded, since there would be no data left 🙈)
• -o file — Prints the output (merged) database to the specified file. At least one output file (this one, or the statistics file) must be set, or it's not happening.
• -s file — Prints statistics for the merged database into the specified file. At least one output file (this one, or the output database file) must be set, fr fr.
• -f filter — Specifies which statistics entries get generated. The filter is a hexadecimal number, and its last 25 bits each correspond to the 25 entries in the statistics file (the least significant bit corresponds to the first entry, and so on). Heads up: the filter is ignored if the statistics file is not set.
• -v — Prints version and license key information and exits. Bye bestie 👋

---

🌈 ENVIRONMENT VARIABLES 🌈

• TTCN3_DIR — The installation directory where the uncompressed binary package of the TTCN-3 Test Executor can be found.
• TTCN3_LICENSE_FILE — Points to the file (NB: not the directory!) that contains the personalized license key for the current user or host. Important distinction, don't get it twisted 💜

---

🐛 BUGS 🐛

None known at this time. A clean slate, we love to see it ✨

---

👀 SEE ALSO 👀

The Programmer's Technical Reference for the TTCN-3 Test Executor. Go read it, iykyk 🫶

---

💖 AUTHOR 💖

This manpage is written by Botond Baranyi, Ericsson Telecom AB.

Copyright (c) 2000-2021 Ericsson Telecom AB. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.html

---

and that's the whole page bestie 🎀 this was ttcn3_profmerge(1), brought to you by Ericsson Telecom AB, dated January 2021 — mwah, go merge some databases 💅