hpct-results(1)

hpct-results(1) 💖

ok so hi bestie, welcome to the General Commands Manual page for hpct-results, aka the HiPerConTracer Results Tool ✨ grab a strawberry drink and let's get into it 🍓

---

NAME 🌸

hpct-results — HiPerConTracer Results Tool 💅

---

SYNOPSIS 🦋

hpct-results input_file ...
             [-L level | --loglevel level]
             [-Z on|off | --logcolor on|off]
             [-O file | --logfile file]
             [-q | --quiet] [-w | --verbose]
             [-o filename | --output filename]
             [-s character | --separator character]
             [-A | --sorted] [-U | --unsorted]
             [-T threads | --maxthreads threads]
             [-R | --input-results-from-stdin]
             [-N | --input-file-names-from-stdin]
             [-F filename | --input-file-names-from-file filename]
hpct-results [-h | --help]
hpct-results [-v | --version]

---

DESCRIPTION 💫

okok so here's the vibe: hpct-results reads your HiPerConTracer results files and merges them into a CSV file. the reading part? multi-threaded, obvi 💅

the output can go to standard output, or to a file — dealer's choice. and compression? GZip, BZip2 and XZ are all supported, we love a glow-up 🎀

multi-threading is supported too, reading files in parallel. no cap.

now the sorted situation, listen up because this one matters:

• sorted — guarantees a deterministic order, but ngl it requires ample of memory 😭
• unsorted — reduces memory usage, but yields a non-deterministic order in case of parallel processing 👀

and bestie, guess what — the results are sorted by default. periodt.

---

ARGUMENTS 💜

the following arguments may be provided, bestie:

• input_file ... — a HiPerConTracer results file. you can throw multiple files at it, they results will be joined ✨ (yes, the original says "they results will be joined", it's the vibe, iykyk)
• -L level, --loglevel level — sets the minimum logging level to the provided value: 0=trace, 1=debug, 2=info, 3=warning, 4=error, 5=fatal. pick your poison 🫶
• -Z on|off, --logcolor on|off — enables (on) or disables (off) the usage of ANSI color escape sequences to colorise the log output according to its level. yes, your logs can be pretty, it's giving main character energy 🌈
• -O file, --logfile file — sets a file name for appending the log output to. if a file is set, no log output is made to the console. otherwise, all log output will be written to the console. so it's one or the other, no both 🎀
• -q, --quiet — sets the minimum logging level to 3 (warning). shhh 🤫
• -w, --verbose — sets the minimum logging level to 0 (trace). tell me EVERYTHING 😭
• -o filename, --output filename — sets the specified filename as output file. extensions .gz, .bz2, and .xz are recognised to enable compression 🔥
• -s character, --separator character — configures the character used as separator of the CSV output. Default: ",". Possible values: " ", ";", ":", " | ". 💅
• -A, --sorted — sort the output data (by Timestamp, MeasurementID, Source, Destination, RoundNumber, SeqNumber). This is the default.
• -U, --unsorted — do not sort the output data. this reduces processing time and memory usage, but multi-threading makes the output order non-deterministic 🙈
• -T threads, --maxthreads threads — sets the maximum number of threads. by default, it is the number of CPU cores 👑
• -R, --input-results-from-stdin — read the results from standard input 🌸
• -N, --input-file-names-from-stdin — read the input file names from standard input 🦋
• -F file, --input-file-names-from-file file — read the input file names from file. the option may be provided multiple times to read from multiple files ✨
• -h, --help — prints command help 🫶
• -v, --version — prints program version ⭐

---

EXIT STATUS 🍓

the hpct-results tool exits with 0 on success, and >0 in case of an error. so like, zero means we ate, anything above zero means something went wrong 😭

---

EXAMPLES ✨

here's your inspo board bestie, literally copy these:

hpct-results results/Ping* --output ping.csv.xz --sorted --separator ';'

hpct-results results/Traceroute* --output traceroute.csv.bz2 --unsorted

hpct-results results/Traceroute* --sorted | head -n 64

find results/ -name 'Traceroute-*.hpct.*' | hpct-results --input-file-names-from-stdin -o results.csv.gz

hpct-results --input-file-names-from-file results-files.list -o results.csv.xz

hpct-results --version

hpct-results -h

---

NOTES 🧚

this program is part of HiPerConTracer 💖 The latest version of HiPerConTracer can be found on the HiPerConTracer Homepage at HiPerConTracer Homepage: https://www.nntb.no/~dreibh/hipercontracer/. go look, it's iconic 👑

---

AUTHORS 🌈

Thomas Dreibholz, Homepage: https://www.nntb.no/~dreibh — thank you king 🙌

---

aaaaand that's the whole page bestie 💜 this was hpct-results from the General Commands Manual, version dated May 26, 2026, and it's a hpct-results(1) situation, no cap. slay, go merge some results ✨💅🎀