hpct-trigger(1)

💖 hpct-trigger — HiPerConTracer Trigger Tool 💖

okay bestie, welcome to the hpct-trigger(1) page from the General Commands Manual 🌸 this is the High-Performance Connectivity Tracer (HiPerConTracer) Trigger Tool, and it's lowkey iconic. sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

hpct-trigger — High-Performance Connectivity Tracer (HiPerConTracer) Trigger Tool 🦋

---

🌈 SYNOPSIS 🌈

like, here's the whole vibe of how you call it. no cap, it's a lot of brackets, but that's just how the group chat works:

hpct-trigger [--triggerpingage seconds]
             [--triggerpingpacketsize payload_length]
             [--triggerpingsbeforequeuing count]
             [-P | --ping]
             [-T | --traceroute] [-L level | --loglevel level]
             [-Z on|off | --logcolor on|off] [-O file | --logfile file]
             [-q | --quiet] [-w | --verbose]
             [-U user|uid | --user user|uid]
             [-# identifier | --measurement-id identifier]
             [-S address|hostname[,traffic_class[,...]] | --source address|hostname[,traffic_class[,...]]]
             [-D address|hostname | --destination address|hostname]
             [--sources-from-file file]
             [--destinations-from-file file]
             [-M ICMP|UDP | --iomodule ICMP|UDP]
             [-I number_of_iterations | --iterations number_of_iterations]
             [--tracerouteinterval milliseconds]
             [--tracerouteintervaldeviation fraction]
             [--tracerouteduration milliseconds]
             [--tracerouterounds rounds]
             [--tracerouteinitialmaxttl value]
             [--traceroutefinalmaxttl value]
             [--tracerouteincrementmaxttl value]
             [--traceroutepacketsize bytes]
             [--tracerouteudpsourceport port]
             [--tracerouteudpdestinationport port]
             [--pinginterval milliseconds]
             [--pingintervaldeviation fraction]
             [--pingexpiration milliseconds]
             [--pingburst packets]
             [--pingttl value]
             [--pingpacketsize bytes]
             [--pingudpsourceport port]
             [--pingudpdestinationport port]
             [-R directory | --resultsdirectory directory]
             [-x seconds | --resultstransactionlength seconds]
             [-C none|XZ|BZip2|GZip|ZLIB|ZSTD | --resultscompression none|XZ|BZip2|GZip|ZLIB|ZSTD]
             [-F version | --resultsformat version]
             [-z depth | --resultstimestampdepth depth]
hipercontracer [--check]
hipercontracer [-h | --help]
hipercontracer [-v | --version]

---

💅 DESCRIPTION 💅

so, <pink>hpct-trigger</pink> is the tool that triggers a HiPerConTracer measurement, and the way it decides is by watching the incoming ICMP Ping packets it sees. 👀 once it's clocked the given number of those packets — with a given size — coming from a source, it fires off a Ping or a Traceroute to the corresponding remote address. that's the whole glow-up. main character energy, honestly. ✨

---

🎀 ARGUMENTS 🎀

the following arguments may be provided, bestie:

• --triggerpingage seconds — sets the maximum number of seconds between two trigger "Pings" (default: 300). so like, the patience window. 🕰️
• --triggerpingpacketsize payload_length — sets the "Ping" total length (IP header + ICMP header + HiPerConTracer header) to trigger a HiPerConTracer measurement (default: 67). it's giving very specific. 💅
• --triggerpingsbeforequeuing count — sets the number of observed "Ping" packets before triggering HiPerConTracer (default: 3). three strikes and we GO. 🔥

see the manual page of HiPerConTracer for the other arguments and the output format. 🫶 (iykyk — the rest of the lore lives over there.)

---

⭐ EXIT STATUS ⭐

the <pink>hpct-trigger</pink> tool exits with 0 on success, and >0 in case of an error. simple as that, periodt. 💯

---

🔥 EXAMPLES 🔥

here's the receipts, copied exactly, no notes:

hpct-trigger --source 10.1.1.51 --traceroute --verbose
        --triggerpingsbeforequeuing 2 --triggerpingpacketsize 88

hpct-trigger --source 10.1.1.51 --triggerpingage 1800 --ping --verbose

hpct-trigger --source=10.1.1.51 --traceroute
        --resultsdirectory=/tmp/results --resultstransactionlength=60
        --resultstimestampdepth 3

hpct-trigger --source=172.16.1.2,BE,EF --source=172.17.1.2,BE,AF11,AF21
        --triggerpingage=1800 --ping --verbose

hpct-trigger --source 10.1.1.51 --triggerpingage 1800 --ping
        --traceroute --iomodule ICMP --iomodule UDP

hipercontracer -S 0.0.0.0 -S :: -D <TARGET> --ping --pingpacketsize 67
        --iterations 3 --verbose

hipercontracer -S 0.0.0.0 -S :: -D <TARGET> -P --pingpacketsize 88 -I 3
        -v

go off. 💅

---

🦋 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/. bookmark it bestie, seriously. 🔖

---

👑 AUTHORS 👑

Thomas Dreibholz, Homepage: https://www.nntb.no/~dreibh 💜

---

and that's the page, bestie!! 🎀 this was the hpct-trigger(1) manpage, hailing from the General Commands Manual, source/version hpct-trigger with date May 26, 2026 — mwah, iconic, slay, no cap. 🫶✨🦋