cddl/contrib/dtracetoolkit/Man/man1m/tcptop_snv.1m

   1 .TH tcptop 1m  "$Date:: 2007-10-04 #$" "USER COMMANDS"
   2 .SH NAME
   3 tcptop \- display top TCP network packets by process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B tcptop
   6 [-Ch] [-j|-Z] [interval [count]]
   7 .SH DESCRIPTION
   8 This analyses TCP network packets and prints the responsible PID and UID,
   9 plus standard details such as IP address and port. This captures traffic
  10 of newly created TCP connections that were established while this program
  11 was running. It can help identify which processes is causing TCP traffic.
  12
  13 Since this uses DTrace, only the root user or users with the
  14 dtrace_kernel privilege can run this command.
  15 .SH OS
  16 Solaris Nevada / OpenSolaris, circa late 2007
  17 .SH STABILITY
  18 unstable - this script uses fbt provider probes which may change for
  19 future updates of the OS, invalidating this script. Please read
  20 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  21 .SH OPTIONS
  22 .TP
  23 \-C
  24 don't clear the screen
  25 .TP
  26 \-j
  27 print project IDs
  28 .TP
  29 \-Z
  30 print zone IDs
  31 .TP
  32 interval
  33 sample seconds between refreshing the screen
  34 .TP
  35 count
  36 number of samples
  37 .PP
  38 .SH EXAMPLES
  39 .TP
  40 Print a report every 5 seconds,
  41 #
  42 .B tcptop
  43 .TP
  44 Don't clear the screen, scrolling output,
  45 #
  46 .B tcptop
  47 \-C
  48 .TP
  49 Print project IDs,
  50 #
  51 .B tcptop
  52 \-j
  53 .TP
  54 Print zone IDs,
  55 #
  56 .B tcptop
  57 \-Z
  58 .PP
  59 .SH FIELDS
  60 .TP
  61 UID
  62 user ID
  63 .TP
  64 PID
  65 process ID
  66 .TP
  67 CMD
  68 command name
  69 .TP
  70 LADDR
  71 local IP address
  72 .TP
  73 RADDR
  74 remote IP address
  75 .TP
  76 LPORT
  77 local port number
  78 .TP
  79 RPORT
  80 remote port number
  81 .TP
  82 SIZE
  83 packet size, bytes
  84 .TP
  85 load
  86 1 minute load average
  87 .TP
  88 TCPin
  89 total TCP inbound payload data
  90 .TP
  91 TCPout
  92 total TCP outbound payload data
  93 .TP
  94 ZONE
  95 zone ID
  96 .TP
  97 PROJ
  98 project ID
  99 .PP
 100 .SH DOCUMENTATION
 101 See the DTraceToolkit for further documentation under the
 102 Docs directory. The DTraceToolkit docs may include full worked
 103 examples with verbose descriptions explaining the output.
 104 .SH EXIT
 105 tcptop will print reports until Ctrl\-C is hit, or the specified
 106 count is reached.
 107 .SH AUTHOR
 108 Brendan Gregg
 109 [Sydney, Australia]
 110 .SH SEE ALSO
 111 tcpsnoop(1M), dtrace(1M)