ifpps.8

   1 .\" netsniff-ng - the packet sniffing beast
   2 .\" Copyright 2013 Daniel Borkmann.
   3 .\" Subject to the GPL, version 2.
   4 .PP
   5 .TH IFPPS 8 "03 March 2013" "Linux" "netsniff-ng toolkit"
   6 .SH NAME
   7 ifpps \- top-like networking and system statistics
   8 .PP
   9 .SH SYNOPSIS
  10 .PP
  11 \fB ifpps\fR { [\fIoptions\fR] | [\fIdevice\fR] }
  12 .PP
  13 .SH DESCRIPTION
  14 .PP
  15 ifpps is a small utility which periodically provides top-like networking
  16 and system statistics from the kernel. ifpps gathers its data directly
  17 from procfs files and does not apply any user space monitoring libraries
  18 which would falsify statistics under high load.
  19 .PP
  20 For instance, consider the following scenario: two directly connected
  21 Linux machines with Intel Core 2 Quad Q6600 2.40GHz CPUs, 4 GB RAM, and
  22 an Intel 82566DC-2 Gigabit Ethernet NIC are used for performance evaluation.
  23 One machine generates 64 byte network packets by using the kernel space
  24 packet generator pktgen with a maximum possible packet rate. The other
  25 machine displays statistics about incoming network packets by using i)
  26 iptraf(8) and ii) ifpps.
  27 .PP
  28 iptraf which incorporates pcap(3) shows an average packet rate of
  29 246,000 pps while on the other hand ifpps shows an average packet rate
  30 of 1,378,000 pps. Hence, due to packet copies and deferring statistics
  31 creation into user space, a measurement error of approximately 460 per cent
  32 occurs. Tools like iptraf might display much more information such as
  33 TCP per flow statistics (hence the use of the pcap library), that is not
  34 possible with ifpps, because overall networking statistics are our focus;
  35 statistics, which are also fairly reliable under high packet load.
  36 .PP
  37 ifpps also periodically displays CPU load, interrupt, software interrupt
  38 data per sample interval as well as total interrupts, all per CPU. In case
  39 the number of CPUs exceed 10, ifpps will then only display the top heavy
  40 hitters.
  41 .PP
  42 .SH OPTIONS
  43 .PP
  44 .SS -d <netdev>, --dev <netdev>
  45 Networking device to fetch statistics from, for example, eth0, wlan0.
  46 .PP
  47 .SS -t <time>, --interval <time>
  48 Statistics refresh interval in milliseconds, default is 1000ms.
  49 .PP
  50 .SS -p, --promisc
  51 Turn on promiscuous mode for the given networking device.
  52 .PP
  53 .SS -c, --csv
  54 Output (once) the ncurses data to the terminal as gnuplot(1)-ready data.
  55 .PP
  56 .SS -l, --loop
  57 Continuously output the terminal data after a refresh interval. This option
  58 is only available, if option \[lq]\-c\[rq] is given. For \[lq]\-l\[rq] it is
  59 usually recommended to redirect the output into a file that is to be be
  60 processed later with gnuplot(1).
  61 .PP
  62 .SS -v, --version
  63 Show version information.
  64 .PP
  65 .SS -h, --help
  66 Show user help.
  67 .PP
  68 .SH USAGE EXAMPLE
  69 .PP
  70 .SS ifpps eth0
  71 Default ncurses output for the eth0 device.
  72 .PP
  73 .SS ifpps -pd eth0
  74 Ncurses output for the eth0 device in promiscuous mode.
  75 .PP
  76 .SS ifpps -lpcd wlan0 > plot.dat
  77 Continuous terminal output for the wlan0 device in promiscuous mode.
  78 .PP
  79 .SH NOTE
  80 On 10Gbit/s cards or higher, receive and transmit statistics are usually
  81 accumulated at a higher duration interval than 1 second. Thus, it might
  82 be advisable to alter the timing to a higher accumulation interval for such cards.
  83 .PP
  84 .SH BUGS
  85 Systems with greater than 32 cores are currently not supported. This
  86 should, however, not be a big task to fix. The only challenge would
  87 be to display the presented information in a sane way, probably by
  88 selectively hiding uninteresting statistics.
  89 .PP
  90 .SH LEGAL
  91 ifpps is licensed under the GNU GPL version 2.0.
  92 .PP
  93 .SH HISTORY
  94 .B ifpps
  95 was originally written for the netsniff-ng toolkit by Daniel Borkmann. It
  96 is currently maintained by Tobias Klauser <tklauser@distanz.ch> and Daniel
  97 Borkmann <dborkma@tik.ee.ethz.ch>.
  98 .PP
  99 .SH SEE ALSO
 100 .BR netsniff-ng (8),
 101 .BR trafgen (8),
 102 .BR mausezahn (8),
 103 .BR bpfc (8),
 104 .BR flowtop (8),
 105 .BR astraceroute (8),
 106 .BR curvetun (8)
 107 .PP
 108 .SH AUTHOR
 109 Manpage was written by Daniel Borkmann.