hpcttrigger1
High-performance connectivity tracer (hipercontracer) trigger tool
Usage
hpcttrigger [{-P | --ping}]
[{-T | --traceroute}]
[{-L | --loglevel
level}]
[{-q | --quiet}]
[{-v | --verbose}]
[{-U | --user
user | uid}]
[{-S | --source
address
[,traffic_class
[, ...]]}]
[{-D | --destination
address}]
[--tracerouteinterval
milliseconds]
[--tracerouteduration
milliseconds]
[--tracerouterounds
rounds]
[--tracerouteinitialmaxttl
value]
[--traceroutefinalmaxttl
value]
[--tracerouteincrementmaxttl
value]
[--pinginterval
milliseconds]
[--pingexpiration
milliseconds]
[--pingttl
value]
[{-R | --resultsdirectory
directory}]
[--resultstransactionlength
seconds]
[--pingtriggerage
seconds]
[--pingtriggerlength
payload_length]
[--pingsbeforequeuing
count]
Overview
hpcttrigger is a tool to trigger HiPerConTracer runs, based on observed incoming "Ping" packets. Once the given number of such packets with a given size has been observed from a source, a Ping or Traceroute is triggered to the corresponding address.
Arguments
The following arguments may be provided:
- --pingtriggerage seconds
-
Sets the maximum number of seconds between two trigger "Pings" (default: 300).
- --pingtriggerlength payload_length
-
Sets the "Ping" payload length to trigger HiPerConTracer (default: 53).
- --pingsbeforequeuing count
-
Sets the number of observed "Ping" packets before triggering HiPerConTracer (default: 3).
See the manual page of HiPerConTracer for the other arguments and the output format.
Examples
- hpcttrigger --source 10.1.1.51 --traceroute --verbose --pingsbeforequeuing 2 --pingtriggerlength 88
- hpcttrigger --source 10.1.1.51 --pingtriggerage 1800 --ping --verbose
- hpcttrigger --source=10.1.1.51 --traceroute --resultsdirectory=/tmp/results --resultstransactionlength=60
- hpcttrigger --source=172.16.1.2,BE,EF --source=172.17.1.2,BE,AF11,AF21 --pingtriggerage=1800 --ping --verbose
Releases
Unchanged in 2 releases since Debian 12 (Bookworm).