---
name: "hpcttrigger"
section: "1"
platform: "linux"
package: "hipercontracer-trigger"
version: "1.6.10-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hpcttrigger"
---

# hpcttrigger(1)

High-Performance Connectivity Tracer (HiPerConTracer) Trigger Tool

## NAME

**hpcttrigger** – High-Performance Connectivity Tracer (HiPerConTracer) Trigger Tool

## SYNOPSIS

**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\]

## DESCRIPTION

**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

  ## AUTHORS

Thomas Dreibholz\
 https://www.nntb.no/~dreibh/hipercontracer\
 mailto://thomas.dreibholz@gmail.com\