ttcn3_logfilter(1)

📦 version 8.2.0, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu stonking

✨ ttcn3_logfilter(1) — the TTCN-3 log file filtering utility ✨

okay bestie, sit down, hydrate, and let me tell you about ttcn3_logfilter 💖 it's a little cutie from the TTCN-3 Tools family and it's genuinely about to make your log files so much less chaotic.

🌸 SYNOPSIS 🌸

ttcn3_logfilter [ -o outfile ] { eventtype (+|-) } [ input.log ]

or, if you're just trying to vibe-check the thing itself:

ttcn3_logfilter -v | -h | -l

💅 DESCRIPTION 💅

So. This page is your quick-reference bestie for the TTCN-3 logfilter utility that ships with the TTCN-3 Test Executor. You can find ttcn3_logfilter chillin' in $TTCN3_DIR/bin 👑

What does it do? It takes the input log file you hand it as a command-line argument, and it filters that file based on the event types inside it plus the filter parameters you pass as program arguments. Then it writes the output to an output file if you specified one, or straight to standard output if you didn't. Iconic behaviour honestly.

🫶 one thing though: this program is only useful if the variable LogEventTypes is set to Yes in section [LOGGING] of the configuration file. Like, that's the whole prerequisite. No LogEventTypes = Yes, no filtering. periodt.

🎀 OPTIONS 🎀

Here are the command line switches, all of them, no skips:

  • -h — prints help on how to use the utility. your girl is lost? she asks for directions. 💀
  • -l — prints the list of supported event types. the menu, basically. 🍓
  • -o outfile — puts its output into outfile. And heads up: if the file outfile already exists, its contents will be overwritten 😭 so be careful, that's not a merge, that's a replacement. This switch is optional — leave it out and the output just goes to standard output.
  • -v — prints version and license key information and exits. short and sweet, she says her name and leaves. ✨

🌈 ENVIRONMENT VARIABLES 🌈

  • TTCN3_DIR — the installation directory where the uncompressed binary package of the TTCN-3 Test Executor can be found. 🏠
  • TTCN3_LICENSE_FILE — it shall point to the file (NB: not to its directory, okay, read it again, not the directory) that contains the personalized license key for the current user or host. 🔑

💀 BUGS 💀

None known at this time. she's flawless, no notes. 💅

🦋 SEE ALSO 🦋

The User Documentation for the TTCN-3 Test Executor. (yes, go read it, it's giving educational ✨)

👑 AUTHOR 👑

This manpage is written by Csaba Koppany, 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

mwah 💖 that's the whole page bestie — brought to you by Ericsson Telecom AB, January 2021, for ttcn3_logfilter(1). go forth and filter, you absolute main character 🌟

📦 where this page comes from