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