cddl/contrib/dtracetoolkit/Man/man1m/tcpwdist.d.1m

   1 .TH tcpwdist.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 tcpwdist.d \- simple TCP write dist by process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B tcpwdist.d
   6 .SH DESCRIPTION
   7 This measures the size of writes from applications to the TCP level, which
   8 may well be much larger than the MTU size (this is application writes not
   9 packet writes). It can help identify which process is creating network
  10 traffic, and the size of the writes by that application. It uses a simple
  11 probe that produces meaningful output for most protocols.
  12
  13 Tracking TCP activity by process is complex for a number of reasons,
  14 the greatest is that inbound TCP traffic is asynchronous to the process.
  15 The easiest TCP traffic to match is writes, which this script demonstrates.
  16 However there are still issues - for an inbound telnet connection the
  17 writes are associated with the command, for example "ls -l", not something
  18 meaningful such as "in.telnetd".
  19
  20 Scripts that match TCP traffic properly include tcpsnoop and tcptop.
  21
  22 Since this uses DTrace, only the root user or users with the
  23 dtrace_kernel privilege can run this command.
  24 .SH OS
  25 Solaris
  26 .SH STABILITY
  27 unstable - this script uses fbt provider probes which may change for
  28 future updates of the OS, invalidating this script. Please read
  29 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  30 .SH EXAMPLES
  31 .TP
  32 Sample until Ctrl\-C is hit then print report,
  33 #
  34 .B tcpwdist.d
  35 .PP
  36 .SH FIELDS
  37 .TP
  38 PID
  39 process ID
  40 .TP
  41 CMD
  42 command and argument list
  43 .TP
  44 value
  45 TCP write payload size in bytes
  46 .TP
  47 count
  48 number of writes
  49 .PP
  50 .SH DOCUMENTATION
  51 See the DTraceToolkit for further documentation under the
  52 Docs directory. The DTraceToolkit docs may include full worked
  53 examples with verbose descriptions explaining the output.
  54 .SH EXIT
  55 tcpwdist.d will sample until Ctrl\-C is hit.
  56 .SH AUTHOR
  57 Brendan Gregg
  58 [Sydney, Australia]
  59 .SH SEE ALSO
  60 tcpsnoop(1M), tcptop(1M), dtrace(1M)