OS Manuals

/usr/bin/trace-summary

ZeekControl, the shell for operating Zeek installations, with the Broker Python bindings

From zeekctl 9.0.1-r1 (enterprise-packages), captured 2026-11-08 by running trace-summary --help (exit 0). permalink

Also provided by 1 other package version
Usage: trace-summary [options] <pcap-file>|<conn-summaries>

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -b, --bytes           count fractions in terms of bytes rather than packets/connections
  -c, --conn-summaries  input file contains Zeek connection summaries
  --conn-version=CONN_VERSION
                        when used with -c, specify '1' for use with Bro version 1.x connection
                        logs, or '2' for use with Bro 2.x format. '0' tries to guess the format
  -C, --chema           for packets: include only TCP, ignore when seq==0
  -e, --external        ignore strictly internal traffic
  -E EXCLUDENETS, --exclude-nets=EXCLUDENETS
                        excludes CIDRs in file from analysis
  -i ILEN, --intervals=ILEN
                        create summaries for time intervals of given length (seconds, or use
                        suffix of 'h' for hours, or 'm' for minutes)
  -l LOCALNETS, --local-nets=LOCALNETS
                        differentiate in/out based on CIDRs in file
  -n TOPX, --topn=TOPX  show top <n>
  -p PORTS, --ports=PORTS
                        include only ports listed in file
  -P STOREPORTS, --write-ports=STOREPORTS
                        write top total/incoming/outgoing ports into file
  -r, --resolve-host-names
                        resolve host names
  -R tag, --R=tag       write output suitable for R into files <tag.*>
  -s FACTOR, --sample-factor=FACTOR
                        sample factor of input
  -S SAMPLE, --do-sample=SAMPLE
                        sample input with probability (0.0 < prob < 1.0)
  -m, --save-mem        do not make memory-expensive statistics
  -t, --tcp             include only TCP
  -u, --udp             include only UDP
  -U MINTIME, --min-time=MINTIME
                        minimum time in ISO format (e.g. 2005-12-31-23-59-00)
  -v, --verbose         show top-n for every interval
  -V MAXTIME, --max-time=MAXTIME
                        maximum time in ISO format
Options (23)
OptionDescriptionSource
--versionshow program's version number and exithelp + man
-h, --helpshow this help message and exithelp + man
-b, --bytescount fractions in terms of bytes rather than packets/connectionshelp + man
-c, --conn-summariesinput file contains Zeek connection summarieshelp + man
--conn-version CONN_VERSIONwhen used with -c, specify '1' for use with Bro version 1.x connection logs, or '2' for use with Bro 2.x format.help + man
-C, --chemafor packets: include only TCP, ignore when seq==0help + man
-e, --externalignore strictly internal traffichelp + man
-E, --exclude-nets EXCLUDENETSexcludes CIDRs in file from analysishelp + man
-i, --intervals ILENcreate summaries for time intervals of given length (seconds, or use suffix of 'h' for hours, or 'm' for minutes)help + man
-l, --local-nets LOCALNETSdifferentiate in/out based on CIDRs in filehelp + man
-n, --topn TOPXshow top <n>help + man
-p, --ports PORTSinclude only ports listed in filehelp + man
-P, --write-ports STOREPORTSwrite top total/incoming/outgoing ports into filehelp + man
-r, --resolve-host-namesresolve host nameshelp + man
-R, --R tagwrite output suitable for R into files <tag.*>help + man
-s, --sample-factor FACTORsample factor of inputhelp + man
-S, --do-sample SAMPLEsample input with probability (0.0 < prob < 1.0)help + man
-m, --save-memdo not make memory-expensive statisticshelp + man
-t, --tcpinclude only TCPhelp + man
-u, --udpinclude only UDPhelp + man
-U, --min-time MINTIMEminimum time in ISO format (e.g. 2005-12-31-23-59-00)help + man
-v, --verboseshow top-n for every intervalhelp + man
-V, --max-time MAXTIMEmaximum time in ISO formathelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.